# 调度可靠性与运行配置 订单租约与浏览器保活现在独立运行。工作节点每 10 秒将正在登录、等待号源或预约的订单 deadline 延长到 120 秒后,长时间等待验证码或邮件不会阻止续租。失败的登录保留恢复 deadline;429 使用登录冷却时间,其他失败由 Sweeper 回收。 预约成功先保存到 `data/booking_outbox.sqlite3`,再将成功状态同步到云端。失败会自动重试,节点重启后也会继续;Sweeper 同样读取该日志,待同步成功订单不会重新入队。Redis 中还保存成功标记,供不共享本地磁盘的 Sweeper 识别。 `BOOKING_OUTBOX_PATH` 可以覆盖日志位置。这个文件包含预约结果及支付链接,应放在持久化、受访问控制的目录。Docker Compose 已将 `./data` 挂载给 Booker 和 Sweeper;自定义部署时应保留该挂载。数据库及 SQLite 辅助文件不进入 Git 和镜像。 如果磁盘和 Redis 同时不可写,运行进程会暂存成功结果并继续续租,存储恢复后重试;在两个存储都不可用期间强制终止进程,无法保证恢复这些结果。云端更新接口也应支持幂等写入,以覆盖“请求已成功、响应丢失”这一跨系统故障窗口。 每个浏览器实例的预约、保活和正常清理互斥。不同实例可并发执行;执行器满时保留任务等待下一轮,不堆积线程或任务队列。停止先等待当前操作,超时后进入强制资源清理阶段;只处理本组持有的浏览器 PID、其子进程和代理隧道。 清理失败的实例会保留引用并重试,清理完成前暂停补建浏览器。配置注入失败和启动中途失败也会回滚已取得的资源。重复 start/stop 不会重复启动线程;失败的 stop 可再次调用,热更新不会覆盖尚未清理完成的组。 Python 无法安全强杀任意线程。若第三方调用在关闭浏览器后仍不返回,stop 会在有限等待后报错,将组保留为 FAILED,供后续重试;后台执行线程使用有并发上限的 daemon worker,避免永久阻止进程退出。SIGINT、SIGTERM 和主流程异常均进入统一 finally 清理,并关闭角色 Redis、日志 Redis 和升级订阅连接。 新增可选配置(现有配置可以继续使用): ```yaml shutdown_timeout: 5.0 # 正常操作完成的等待秒数,三个角色均支持 cleanup_timeout: 3.0 # 强制资源清理的等待秒数 sentinel: max_concurrency: 8 booker: max_concurrency: 8 signal_poll_interval: 0.5 ``` 并发上限在组启动时生效,修改后需重启组。`signal_poll_interval` 支持热更新,最小值 0.1 秒。无可预约任务时不读号源信号;其余情况每轮使用一次 MGET。订单心跳每轮每组使用一次 ZADD,Sweeper 使用 SCAN 增量遍历 tracker。 ## 服务凭据 源码不再提供服务密钥。优先读取 `CLOUD_API_TOKEN`、`CAPTCHA_LLM_API_KEY`、`REDIS_PASSWORD` 环境变量,也支持 `REDIS_HOST`、`REDIS_PORT`、`REDIS_DB` 和 `CLOUD_API_BASE_URL`。 本地开发可以将 `config/secrets.example.json` 复制为 `config/secrets.json` 后填写。环境变量优先于该文件。`secrets.json` 已被 Git 和 Docker 构建排除;Compose 通过现有 config 挂载读取它。已有工作区凭据已迁移到这个私有文件,权限设置为 0600。 仓库历史中的旧密钥仍应在服务提供方撤销并换新;仅从当前源码移除不能使旧密钥失效。换新后更新环境变量或本地私有文件并重启进程。 ## 离线验证 ```sh venv/bin/python -m unittest test.test_resource_lifecycle test.test_scheduler_reliability test.test_metadata_exception test.test_cloud_config test.test_proxy_manager -v ``` 回归覆盖长预约续租、登录失败恢复、成功结果落盘和重试、重启恢复、存储故障、并发预约与保活互斥、停止竞态、不同号源互不阻塞、批量 Redis 读写和 Sweeper 的成功订单保护。资源测试另覆盖启动失败回滚、失败清理重试、有限停止、Redis 关闭和真实 SIGTERM;进程强制清理使用测试自身创建的子进程验证。外部服务和浏览器均使用替身。