forked from 1307super/cloud189-auto-save
-
Notifications
You must be signed in to change notification settings - Fork 7
SystemSettings
2233 edited this page Jun 7, 2026
·
4 revisions
系统 页管理访问认证、任务调度、自动追剧默认配置、Telegram、消息推送、网络代理和正则预设等基础配置。
| 配置项 | 说明 |
|---|---|
| 管理员用户名 | Web 控制台登录用户名 |
| 管理员密码 | Web 控制台登录密码 |
| 系统 API Key | 第三方脚本、Bot 或 API 调用使用的密钥 |
可以点击 生成 生成新的系统 API Key。修改认证信息后请妥善保存，避免遗忘导致无法登录。
| 配置项 | 说明 |
|---|---|
| 任务过期天数 | 超过指定天数的任务可被清理或视为过期 |
| 最大重试次数 | 任务失败后的最大重试次数 |
| 重试间隔 (秒) | 两次重试之间的等待时间 |
| 任务检查定时 (Cron) | 自动检查任务更新的 Cron 表达式 |
| 回收站清理定时 (Cron) | 自动清理回收站的 Cron 表达式 |
| 懒转存清理定时 (Cron) | 自动清理懒转存文件的 Cron 表达式 |
| 懒转存保留时间 (小时) | 懒转存临时文件保留时长 |
| 媒体文件后缀 | 被识别为媒体文件的扩展名列表 |
| 自动清空回收站 | 定时清空个人云回收站 |
| 自动清理家庭云回收站 | 定时清理家庭云回收站 |
| 自动清理懒转存文件 | 定时删除过期懒转存文件 |
| 仅转存媒体文件 | 创建任务时只处理媒体后缀文件 |
| 目标文件夹自动创建 | 目标目录不存在时自动创建 |
| 账号容量聚合 | 账号页显示多账号个人容量和家庭容量汇总 |
| 账号 Session 保活 | 定时刷新账号会话，降低长期运行时失效概率 |
| 账号 Session 保活 Cron | 控制保活任务执行频率，默认 0 */4 * * *
|
可以点击 立即执行账号保活 手动触发一次保活。容量聚合关闭后，账号页不会再请求 /api/accounts/storage-summary。
| 表达式 | 说明 |
|---|---|
0 */2 * * * |
每 2 小时 |
0 0 * * * |
每天凌晨 |
0 8,20 * * * |
每天 8 点和 20 点 |
*/30 * * * * |
每 30 分钟 |
| 配置项 | 说明 |
|---|---|
| 默认追剧账号 | 自动追剧、部分订阅自动任务默认使用的账号 |
| 默认保存目录 | 自动创建任务时使用的目标目录 |
自动追剧页如果提示未配置，通常就是这里缺少账号或目录。
| 配置项 | 说明 |
|---|---|
| Bot Token | 从 Telegram @BotFather 获取 |
| 默认 Chat ID | 默认接收通知和交互的 Chat ID |
| 反代 API 域名 (可选) | Telegram API 反代地址 |
| 允许使用的 Chat ID 列表 | 可使用 Bot 的用户或群组 |
| 管理员 Chat ID 列表 | 具备管理权限的 Chat ID |
| 成功通知 | 是否推送任务成功通知 |
| 失败通知 | 是否推送任务失败通知 |
| 刮削通知 | 是否推送刮削相关通知 |
配置后可点击 测试配置 发送测试消息。
更多 Bot 指令请参考 Bot。
| 配置项 | 说明 |
|---|---|
| 企业微信推送 | 开启或关闭企业微信机器人推送 |
| Webhook URL | 企业微信机器人 Webhook 地址 |
点击 添加推送 可以新增自定义 Webhook 推送。
字段包括：
| 字段 | 说明 |
|---|---|
| 名称 | 推送配置名称 |
| 方法 | HTTP 方法，例如 GET、POST |
| Webhook URL | 接收推送的地址 |
字段配置 (支持 {{content}}) |
自定义请求字段，{{content}} 会替换为通知内容 |
| 启用此推送 | 是否启用该配置 |
自定义推送适合接入 Bark、WxPusher、PushPlus 或其他 Webhook 服务。不同服务需要的字段不同，请按对应服务的接口要求配置。
| 配置项 | 说明 |
|---|---|
| 代理地址 | 代理服务器地址 |
| 代理端口 | 代理服务器端口 |
| 代理用户名 | 需要认证时填写 |
| 代理密码 | 需要认证时填写 |
可选择走代理的服务包括：
TELEGRAMTMDBOPENAI天翼网盘影巢CUSTOMPUSH
如果 Telegram、TMDB、OpenAI、天翼网盘或影巢请求失败，优先检查代理和服务选择是否正确。
系统页也提供正则预设维护入口，用于创建任务时复用。
字段包括：
| 字段 | 说明 |
|---|---|
| 预设名称 | 规则名称 |
| 匹配模式 | 用于筛选文件的正则 |
| 源正则 (Source Regex) | 原文件名匹配规则 |
| 目标替换 (Target Regex) | 替换后的文件名规则 |
| 匹配操作符 | 与匹配值配合使用 |
| 匹配值 (Match Value) | 条件值 |
| 描述 | 规则说明 |
更多写法请参考 Regex。
所有接口都需要带上系统 API Key：
x-api-key: YOUR_API_KEY| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/settings |
获取系统设置 |
| POST | /api/settings |
保存系统设置 |
| POST | /api/settings/telegram/test |
测试 Telegram 配置 |
| POST | /api/settings/media |
保存媒体设置 |
| GET | /api/settings/regex-presets |
获取正则预设 |
| POST | /api/settings/regex-presets |
保存正则预设 |
| GET | /api/accounts/storage-summary |
获取账号容量聚合 |
| POST | /api/accounts/refresh-capacity |
刷新账号容量缓存 |
| POST | /api/accounts/keep-alive |
手动执行账号 Session 保活 |
- 首次登录后立即修改默认管理员密码。
- 不要把 Web 控制台无保护地暴露到公网。
- 妥善保管系统 API Key、Bot Token、Cookie 和各类 Webhook 地址。
- 定期备份
/home/data，STRM 用户也建议备份/home/strm。