Nexus/docs/changelog/2026-06-09-prod-probe-health-check.md

2026-06-09 生产探针与健康检查补全

摘要

新增 prod_probe.py 双路径探针（外网 + SSH 源站），补全鉴权契约检查；提供 prod_probe_install.sh 在生产写入 NEXUS_TEST_ADMIN_PASSWORD。

动机

• 生产未配置探针口令，鉴权段长期 SKIP
• 国内线路外网 HTTPS 可能 RST，需源站 127.0.0.1:8600 探针仍可用
• 告警分页、once 调度等关键修复缺少生产自动化验收

涉及文件

• scripts/prod_probe.py — 探针主逻辑
• scripts/prod_probe_install.sh — 宿主机 .env.prod 写入探针口令
• scripts/prod_health_check.sh — 薄封装
• docker/.env.prod.example — 探针变量说明
• tests/test_prod_probe.py
• docs/design/plans/2026-06-09-prod-probe-health-check.md
• docs/project/nexus-1panel-operations-knowledge.md

迁移 / 重启

无需重启。探针口令：运维一次性执行 prod_probe_install.sh。

验证

.venv/bin/pytest tests/test_prod_probe.py -q
bash scripts/prod_health_check.sh
NEXUS_TEST_ADMIN_PASSWORD='…' bash scripts/prod_probe_install.sh && bash scripts/prod_health_check.sh

生产已跑通（2026-06-09）：外网 WARN（线路 RST）+ 源站鉴权全绿；once 调度 201 创建并删除。

注意

启用登录 IP 白名单时，源站探针经 X-Real-IP 模拟白名单 IP；可设 NEXUS_PROBE_CLIENT_IP 或自动读 login_manual_ips 首项。