常见问题¶

如何更新 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 与浏览器任务依赖；若启用 weibo.cookie_refresh_enable: true 或 rainyun.enable: true，请改用 full 镜像（由 docker/Dockerfile.full 构建，如 fengyu666/webmoniter:full）或 docker compose -f docker/docker-compose.full.yml up -d。完整镜像默认提供 /usr/bin/chromium 与 /usr/bin/chromedriver；路径不同时使用环境变量 CHROME_BIN、CHROMEDRIVER_PATH，雨云也可使用其配置字段。

定时任务为什么显示「当天已经运行过了，跳过该任务」？

定时任务默认会检查当天是否已运行过（通过 task_run_history 表记录），若已运行则跳过，避免重复执行。程序重启或定时触发时都会进行此检查。仅当任务返回 TASK_SUCCESS 时才会写入记录；返回 TASK_FAILED 或抛出未捕获异常都不会写入，允许后续重试。若需立即再执行一次，可通过 Web 管理界面「任务管理」页面的「立即运行」手动触发，会绕过该检查并强制执行。