feat: clarify local password protection settings scope and behavior in UI.

This commit is contained in:
kuekhaoyang
2025-12-21 21:20:59 +08:00
parent 74e96fb1b5
commit 990ab81722
2 changed files with 11 additions and 7 deletions
+10 -6
View File
@@ -111,19 +111,23 @@
- **Client Components**:复杂交互和状态管理
### 🔒 访问控制
- **环境级密码**:通过设置环境变量启用全局访问密码
- **永久授权**:输入一次密码即可永久访问,无需重复验证
- **本地管理**:支持在应用设置中添加多个自定义访问密码
KVideo 提供两个层级的访问保护:
1. **全局访问保护 (Global)**: 通过设置环境变量 `ACCESS_PASSWORD` 启用。所有访问该实例的用户都必须输入此密码。适用于保护私有部署的实例。
2. **本地设备锁 (Local)**: 在应用设置中手动开启。仅在当前浏览器/设备生效,用于防止他人直接操作你的设备。
> [!TIP]
> **永久授权**: 为了更好的平衡安全与体验,无论哪种密码,只要在当前设备输入正确一次,即可实现永久访问,无需每次进入都重新输入。
---
## ⚙️ 环境配置
## ⚙️ 环境配置 (全局保护)
如果需要为你的 KVideo 实例添加访问控制,可以设置以下环境变量:
如果需要为你的 KVideo 实例添加**全局访问密码**,请设置以下环境变量:
| 变量名 | 必填 | 默认值 | 说明 |
|------|------|------|------|
| `ACCESS_PASSWORD` | 否 | - | 设置后,所有访问者必须输入此密码才能使用应用。 |
| `ACCESS_PASSWORD` | 否 | - | 设置后,任何设备访问该实例都需要先进行身份验证。 |
### 如何设置环境变量
+1 -1
View File
@@ -38,7 +38,7 @@ export function PasswordSettings({
};
return (
<SettingsSection title="访问控制" description="为应用启用密码保护功能。">
<SettingsSection title="本地访问控制 (本设备)" description="仅为此浏览器/设备启用密码保护。此设置不会同步,且不影响全局环境变量密码。">
<div className="space-y-6">
<div className="flex items-center justify-between">
<label className="text-sm font-medium text-[var(--text-color)]">