跳转至

配置说明

所有运行配置均通过 config.yml 管理。修改后无需重启，系统支持配置热重载（约 5 秒内生效）。

配置管理界面预览

部署后可在 Web 管理界面的「配置管理」中可视化编辑 config.yml：左侧为导航/表格视图，右侧可切换为 YAML 文本编辑，保存后约 5 秒内自动生效。

配置管理界面

操作步骤（首次使用）

  1. 复制配置文件
    在项目根目录执行：cp config.yml.sample config.yml（Windows 下复制并重命名为 config.yml）。

  2. 按需编辑 config.yml

  3. 先配置至少一个 推送通道（推送通道配置详解），否则监控/签到结果无法收到通知。
  4. 再配置要使用的 监控任务（监控任务详解）或 定时/签到任务（定时任务详解）。

  5. 各配置块字段含义见本文「主要配置块」及上述详解页。

  6. 保存并等待生效
    保存 config.yml 后约 5 秒内自动生效，无需重启程序或容器。

  7. 可选：Web 界面编辑
    部署完成后访问 http://localhost:8866，可在「配置管理」中可视化编辑并保存，同样支持热重载。

配置文件来源

配置类型 说明
应用配置 监控、签到、推送、免打扰等均在 config.yml.sample 中有注释说明。以该文件为模板复制为 config.yml 后按需修改。
Docker 编排 镜像、端口、卷挂载等见 docker-compose.yml。修改后执行 docker compose up -d 使变更生效。

主要配置块概览

类型 配置节点示例 说明
应用基础 app 全局基础配置，目前包括 base_url（用于拼接微博封面图等资源的完整 URL）
微博监控 weibo enable、Cookie、UID 列表、监控间隔、推送通道等，详见 监控任务详解
虎牙监控 huya enable、房间号列表、监控间隔、推送通道等，详见 监控任务详解
哔哩哔哩 bilibili enable、UID 列表、Cookie（可选）、动态+开播/下播检测，详见 监控任务详解
抖音直播 douyin enable、抖音号列表、开播/下播检测，详见 监控任务详解
斗鱼直播 douyu enable、房间号列表、开播/下播检测，详见 监控任务详解
小红书 xhs enable、Profile ID 列表、Cookie（可选）、动态检测，详见 监控任务详解
各签到任务 checkin、tieba、rainyun 等 每类任务有独立节点，含 enable、账号/Cookie/Token、time、push_channels，详见 定时任务详解
推送通道 push_channel 列表形式，每项需 name、type 及该类型所需参数，详见 推送通道配置详解
日志清理 log_cleanup 执行时间、日志保留天数
免打扰时段 quiet_hours 启用后，在指定时间段内不推送通知（任务照常执行）
AI 助手 ai_assistant 可选，配置后可在配置/任务/数据页使用「问 AI」功能，详见 AI 助手
插件任务 plugins.demo_task 等 二次开发扩展任务，不需要可删除并在注册表中移除

应用基础配置 app

目前 app 节点主要用于配置对外访问的基础地址：

app:
  # 对外访问的基础地址，用于构造图片等资源的完整 URL（例如微博封面图）
  # 建议填写你实际访问 Web 管理界面的地址：
  # - 本机调试: "http://localhost:8866"
  # - 局域网/公网: "http://your-domain.com:8866"
  # 留空时，微博监控仍会推送，但无法为大部分通道拼接出可访问的封面图 URL，将退回使用内置示例图片。
  base_url: "http://localhost:8866"

设置 base_url 后，微博监控会：

  • 将被监控用户的头像与手机封面图缓存到 data/weibo/<用户名>/；
  • 通过 base_url + /weibo_img/<用户名>/cover_image_phone.jpg 为大部分推送通道提供可访问的封面图 URL；
  • 对于支持本地图片上传的通道（如 telegram_bot），还会直接上传本地封面图。

任务级推送通道选择

在任意监控或签到任务的配置中，可设置 push_channels（通道名称列表，与 push_channel 中某项的 name 一致）：

  • 为空：使用全部已配置的推送通道。
  • 非空：仅使用列出的通道，便于不同任务推送到不同群或应用。

ID 与列表字段的书写格式

uids、rooms、douyin_ids、profile_ids 等字段为逗号分隔的 ID 列表，在 YAML 中带单引号和不带单引号均可：

# 以下写法均有效
weibo:
  uids: 3669102477,5479678683
bilibili:
  uids: '946974'           # 单引号
  uids: 946974             # 无引号
douyin:
  douyin_ids: 'ASOULjiaran'
douyu:
  rooms: 307876,123456

系统在加载时会统一转为字符串处理，无需刻意统一。若希望风格一致，可统一使用单引号（如 uids: '123,456'），语义更明确。

青龙面板

若使用 青龙面板，可通过 ql/ 脚本运行定时任务，配置改为环境变量（WEBMONITER_* 前缀），推送走青龙内置通知。详见 青龙面板兼容指南。

相关文档