Skip to content

SystemSettings

2233 edited this page Apr 29, 2026 · 4 revisions

系统设置

系统 页管理访问认证、任务调度、自动追剧默认配置、Telegram、消息推送、网络代理和正则预设等基础配置。


1. 访问认证

配置项 说明
管理员用户名 Web 控制台登录用户名
管理员密码 Web 控制台登录密码
系统 API Key 第三方脚本、Bot 或 API 调用使用的密钥

可以点击 生成 生成新的系统 API Key。修改认证信息后请妥善保存,避免遗忘导致无法登录。


2. 任务设置

配置项 说明
任务过期天数 超过指定天数的任务可被清理或视为过期
最大重试次数 任务失败后的最大重试次数
重试间隔 (秒) 两次重试之间的等待时间
任务检查定时 (Cron) 自动检查任务更新的 Cron 表达式
回收站清理定时 (Cron) 自动清理回收站的 Cron 表达式
懒转存清理定时 (Cron) 自动清理懒转存文件的 Cron 表达式
懒转存保留时间 (小时) 懒转存临时文件保留时长
媒体文件后缀 被识别为媒体文件的扩展名列表
自动清空回收站 定时清空个人云回收站
自动清理家庭云回收站 定时清理家庭云回收站
自动清理懒转存文件 定时删除过期懒转存文件
仅转存媒体文件 创建任务时只处理媒体后缀文件
目标文件夹自动创建 目标目录不存在时自动创建

Cron 示例

表达式 说明
0 */2 * * * 每 2 小时
0 0 * * * 每天凌晨
0 8,20 * * * 每天 8 点和 20 点
*/30 * * * * 每 30 分钟

3. 自动追剧默认配置

配置项 说明
默认追剧账号 自动追剧、部分订阅自动任务默认使用的账号
默认保存目录 自动创建任务时使用的目标目录

自动追剧页如果提示未配置,通常就是这里缺少账号或目录。


4. Telegram 机器人

配置项 说明
Bot Token 从 Telegram @BotFather 获取
默认 Chat ID 默认接收通知和交互的 Chat ID
反代 API 域名 (可选) Telegram API 反代地址
允许使用的 Chat ID 列表 可使用 Bot 的用户或群组
管理员 Chat ID 列表 具备管理权限的 Chat ID
成功通知 是否推送任务成功通知
失败通知 是否推送任务失败通知
刮削通知 是否推送刮削相关通知

配置后可点击 测试配置 发送测试消息。

更多 Bot 指令请参考 Bot


5. 消息推送

企业微信推送

配置项 说明
企业微信推送 开启或关闭企业微信机器人推送
Webhook URL 企业微信机器人 Webhook 地址

自定义推送列表

点击 添加推送 可以新增自定义 Webhook 推送。

字段包括:

字段 说明
名称 推送配置名称
方法 HTTP 方法,例如 GET、POST
Webhook URL 接收推送的地址
字段配置 (支持 {{content}}) 自定义请求字段,{{content}} 会替换为通知内容
启用此推送 是否启用该配置

自定义推送适合接入 Bark、WxPusher、PushPlus 或其他 Webhook 服务。不同服务需要的字段不同,请按对应服务的接口要求配置。


6. 网络代理

配置项 说明
代理地址 代理服务器地址
代理端口 代理服务器端口
代理用户名 需要认证时填写
代理密码 需要认证时填写

可选择走代理的服务包括:

  • TELEGRAM
  • TMDB
  • OPENAI
  • 天翼网盘
  • CUSTOMPUSH

如果 Telegram、TMDB 或 OpenAI 请求失败,优先检查代理和服务选择是否正确。


7. 正则预设列表

系统页也提供正则预设维护入口,用于创建任务时复用。

字段包括:

字段 说明
预设名称 规则名称
匹配模式 用于筛选文件的正则
源正则 (Source Regex) 原文件名匹配规则
目标替换 (Target Regex) 替换后的文件名规则
匹配操作符 与匹配值配合使用
匹配值 (Match Value) 条件值
描述 规则说明

更多写法请参考 Regex


8. API 接口

所有接口都需要带上系统 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 保存正则预设

安全建议

  • 首次登录后立即修改默认管理员密码。
  • 不要把 Web 控制台无保护地暴露到公网。
  • 妥善保管系统 API Key、Bot Token、Cookie 和各类 Webhook 地址。
  • 定期备份 /home/data,STRM 用户也建议备份 /home/strm

目录

入门指南

核心功能

媒体中心

系统配置

开发者与扩展

其他

Clone this wiki locally