常见问题¶
如何更新 Cookie？
直接修改 config.yml 中的 Cookie 值，无需重启容器或程序。系统支持配置热重载，会在约 5 秒内自动检测并应用新配置。
监控任务没有执行怎么办？
- 查看日志：
logs/main_*.log（总日志）或logs/task_{job_id}_*.log（任务专属日志），也可在 Web 日志页面切换查看 - 确认
config.yml格式正确（YAML 语法） - 检查网络与 Cookie 是否有效
- 确认监控任务已启用（如
enable: true，或对应监控块已配置）
如何调整监控频率？
在 config.yml 中修改对应间隔（秒）即可，无需重启：
- 微博：weibo.monitor_interval_seconds（默认 300）；weibo.concurrency（默认 3）
- 虎牙：huya.monitor_interval_seconds（默认 65）；huya.concurrency（默认 7）
- 哔哩哔哩：bilibili.monitor_interval_seconds（默认 60）
- 抖音：douyin.monitor_interval_seconds（默认 30）
- 斗鱼：douyu.monitor_interval_seconds（默认 300）
- 小红书：xhs.monitor_interval_seconds（默认 300）
数据库和日志文件在哪里？
| 部署方式 | 数据库位置 | 日志位置 |
|---|---|---|
| Docker 部署 | ./data/ 目录 |
./logs/ 目录 |
| 本地部署 | ./data/ 目录 |
./logs/ 目录 |
日志目录内含：
- main_YYYYMMDD.log：当日总日志
- task_{任务ID}_YYYYMMDD.log：各任务专属日志
Web 界面无法访问怎么办？
- 确认程序已正常启动（看控制台或日志）
- 确认端口 8866 未被占用
- Docker 部署时确认端口映射为
8866:8866 - 检查防火墙是否放行 8866
本地运行时如何停止？Ctrl+C 卡住怎么办？
在运行 uv run python main.py 的终端按 Ctrl+C 即可停止。程序会停止调度器、关闭 Web 服务、配置监控器和数据库连接。
项目会对同步网络请求、浏览器任务等阻塞场景设置兜底：正常会在数秒内退出；如果关闭流程仍被任务阻塞，约 12 秒后会强制退出；再次按 Ctrl+C 会立即强制退出。
免打扰时段内会遗漏消息吗？
免打扰时段内，监控任务会照常执行并更新数据库，但不会推送通知。若担心遗漏，可查看日志或数据记录，或关闭免打扰配置。
青龙面板如何部署？
在青龙「环境变量」中添加 WEBMONITER_* 前缀的变量（如 WEBMONITER_CHECKIN_ENABLE、WEBMONITER_CHECKIN_EMAIL），拉取或克隆项目后，在「定时任务」中执行 python -m src.ql ikuuu_checkin 等命令。推送自动走青龙内置通知（QLAPI）。详见 青龙面板兼容指南。
Docker 部署下雨云签到如何启用？
精简镜像（由 docker/Dockerfile 构建，latest 等标签）不包含 Chromium 与雨云相关 Python 依赖；若启用 rainyun.enable: true，请改用 full 镜像（由 docker/Dockerfile.full 构建，如 fengyu666/webmoniter:full）或 docker compose -f docker/docker-compose.full.yml up -d。完整镜像已内置 Chromium；在 config.yml 中配置 rainyun.accounts 即可；默认 /usr/bin/chromium 与 /usr/bin/chromedriver。路径不同时可配置 rainyun.chrome_bin / rainyun.chromedriver_path，或环境变量 CHROME_BIN、CHROMEDRIVER_PATH。
定时任务为什么显示「当天已经运行过了，跳过该任务」？
定时任务默认会检查当天是否已运行过（通过 task_run_history 表记录），若已运行则跳过，避免重复执行。程序重启或定时触发时都会进行此检查。任务函数正常返回后即写入记录；若抛出未捕获异常则不写入。若需立即再执行一次，可通过 Web 管理界面「任务管理」页面的「立即运行」手动触发，会绕过该检查并强制执行。