Nexus/docs/changelog/2026-06-29-btpanel-bootstrap-skip-reload.md

宝塔 bootstrap 无变更时跳过 bt reload

日期：2026-06-29

摘要

SSH bootstrap 对接宝塔 API 时，若 api.json 无需变更（API 已开、token 已有、中心 IP 已在白名单），不再写盘、不执行 /etc/init.d/bt reload，避免每 5 分钟重试或重复一键登录时踢掉面板已有会话。

动机

商城新机 43.138.205.6 在 Nexus bootstrap 时 bt reload 导致 15:32 面板全员掉线；对已配置机器重复 bootstrap 不应 reload。

涉及文件

• server/infrastructure/btpanel/ssh_bootstrap.py — if actions: 才写 api.json + reload；stdout 增加 reloaded
• tests/test_btpanel_ssh_bootstrap.py — 断言远程脚本条件 reload
• docs/design/specs/2026-06-20-btpanel-module-design.md — 设计说明同步

迁移 / 重启

仅后端；deploy-production.sh rsync + Docker upgrade --skip-git。

验证

.venv/bin/pytest tests/test_btpanel_ssh_bootstrap.py -q

生产：对已 bootstrap 完成的子机再触发对接，syslog 不应再出现 bt reload（actions 为空时）。