⚙️ 设置
本页面介绍系统设置中的各项配置功能。
代理配置
功能说明
为需要访问外部网络的功能配置代理服务器。
配置项
| 配置项 | 说明 |
|---|---|
| 代理地址 | 代理服务器地址，如 http://127.0.0.1:7890 |
| 代理类型 | HTTP / SOCKS5 |
| 代理用户名 | 可选，需要认证时填写 |
| 代理密码 | 可选，需要认证时填写 |
适用场景
- 访问 TMDB/TVDB 等国外元数据源
- 某些弹幕源需要代理才能访问
- 海外部署时访问国内弹幕源
安全设置
功能说明
配置系统的安全相关参数，包括 GitHub Token、访问控制、反向代理信任和会话管理。
GitHub Token 配置
作用：用于访问 GitHub API，主要用于弹幕源资源仓库的更新检查。
配置步骤：
- 访问 GitHub Token 设置
- 点击 "Generate new token (classic)"
- 勾选
public_repo权限 - 生成并复制 Token
- 在设置页面填入 Token
效果：
- 提高 GitHub API 调用限额（未认证：60次/小时 → 认证后：5000次/小时）
- 避免频繁请求被限制
- 确保弹幕源更新检查正常工作
访问IP白名单
功能说明：限制只有特定 IP 地址可以访问系统，增强安全性。
配置项：
| 配置项 | 说明 |
|---|---|
| 启用 IP 白名单 | 开启后，只有白名单中的 IP 才能访问系统 |
| IP 地址列表 | 支持单个 IP 或 CIDR 格式的 IP 段 |
示例：
- 单个 IP：
192.168.1.100 - IP 段：
192.168.1.0/24（允许 192.168.1.1 - 192.168.1.254） - 多个地址：每行一个，支持混合格式
适用场景：
- 仅允许内网访问
- 限制特定客户端访问
- 提高系统安全性
⚠️ 警告：配置错误可能导致自己无法访问系统，请谨慎设置！
受信任反代配置
功能说明：配置受信任的反向代理地址，用于正确识别客户端真实 IP。
为什么需要此配置？
当系统部署在反向代理（如 Nginx、Cloudflare）后面时，系统接收到的 IP 是代理服务器的 IP，而非用户真实 IP。通过配置受信任反代，系统会从 X-Forwarded-For 等 HTTP 头中提取用户真实 IP。
配置项：
| 配置项 | 说明 |
|---|---|
| 受信任反代 IP 列表 | 填写反向代理服务器的 IP 地址 |
| X-Forwarded-For 解析 | 自动从 HTTP 头中提取真实 IP |
适用场景：
- 使用 Nginx、Apache 等反向代理时
- 使用 Cloudflare CDN 时
- 需要准确记录用户 IP 用于访问控制时
登录令牌有效期
功能说明：设置用户登录 Token 的有效时长，平衡安全性和便利性。
配置项：
| 配置项 | 说明 | 建议值 |
|---|---|---|
| Token 有效期 | 单位为秒 | 默认：2592000（30天） |
常用值参考：
- 1 小时：
3600 - 1 天：
86400 - 7 天：
604800 - 30 天：
2592000 - 90 天：
7776000
安全建议：
- 个人使用：可设置较长有效期（30-90天）
- 多人使用：建议设置较短有效期（1-7天）
- 公网暴露：建议设置较短有效期并启用 IP 白名单
识别词配置
功能说明
配置用于识别文件名中影视信息的关键词规则。
配置项
| 配置项 | 说明 |
|---|---|
| 标题识别规则 | 用于提取标题的正则表达式 |
| 季度识别规则 | 用于识别季数的规则 |
| 集数识别规则 | 用于识别集数的规则 |
| 年份识别规则 | 用于提取年份的规则 |
使用场景
- 自定义文件命名规范
- 处理特殊命名格式的文件
- 提高匹配准确率
会话管理
功能说明
管理当前登录的会话，查看和控制活跃的登录状态。
功能
| 功能 | 说明 |
|---|---|
| 查看会话列表 | 显示所有活跃的登录会话 |
| 会话信息 | IP地址、设备类型、登录时间 |
| 强制下线 | 手动终止指定会话 |
| 清除所有会话 | 强制所有设备下线 |
安全建议
- 定期检查会话列表
- 发现异常登录及时强制下线
- 更换密码后建议清除所有会话
参数配置
界面配置
用于配置 Web UI 的界面行为和数据管理功能。
分页参数持久化
功能说明：保存页面的分页设置（如每页显示数量），下次访问时自动恢复。
配置项：
| 配置项 | 说明 |
|---|---|
| 启用分页参数持久化 | 开启后，系统会记住您在各个页面设置的每页显示数量 |
适用场景：
- 经常需要查看大量数据时，可以设置较大的每页显示数量并保存
- 不同页面可以保持各自的分页设置
- 提升用户体验，避免每次访问都需要重新调整
数据库备份、还原功能
功能说明：提供数据库的备份和还原功能，保障数据安全。
备份功能：
| 操作 | 说明 |
|---|---|
| 创建备份 | 点击"立即备份"按钮，创建当前数据库的完整备份 |
| 备份内容 | 包含所有弹幕数据、条目信息、配置等 |
| 备份存储 | 备份文件保存在系统持久化目录中 |
还原功能：
| 操作 | 说明 |
|---|---|
| 选择备份 | 从备份列表中选择要还原的备份文件 |
| 还原数据 | 点击"还原"按钮，将数据库恢复到备份时的状态 |
| ⚠️ 注意 | 还原操作会覆盖当前数据，请谨慎操作 |
适用场景：
- 定期备份数据，防止意外数据丢失
- 系统升级或重大配置变更前备份
- 测试新功能前备份，出问题可快速还原
- 迁移数据到新服务器
安全建议：
- 建议定期创建备份（如每周一次）
- 重要操作前务必先备份
- 备份文件可以下载到本地保存
- 还原前确认备份文件的完整性
修改密码
- 鼠标移动到右上角 头像 处
- 点击 "修改密码"
- 输入当前密码
- 输入新密码并确认
- 点击 "保存"
📚 相关文档
- 🎬 元数据源配置 - TMDB/TVDB 配置
- 🎬 弹幕API功能配置 - Token管理等
- ❓ 常见问题 - 故障排除