Nexus/docs/changelog/2026-06-21-btpanel-deploy.md

Changelog — 宝塔模块生产部署（2026-06-21）

日期：2026-06-21

摘要

将 82426b19 + d00294c8（独立宝塔模块 + SSH 自动获取 API）部署至生产 api.synaglobal.vip。

部署结果（2026-06-21）：Gitea push → 生产 git reset --hard origin/main → nexus-1panel.sh upgrade 成功；容器 nexus-prod-nexus-1 healthy；/health ok；容器内注册 28 条 /api/btpanel/* 路由。

变更范围

• 后端：/api/btpanel/*、bt_panel_bootstrap_loop（300s）
• 前端：侧栏「宝塔面板」10 子页 + 连接配置（批量确认、检测缓存）
• 配置：bt_panel_source_ip、bt_panel_auto_bootstrap_enabled

涉及文件

见 docs/audit/2026-06-21-btpanel-ssh-bootstrap.md 文件清单。

迁移 / 重启

• 无 DB 迁移
• 必须重启 API 容器/进程（primary worker 后台任务）

验证

bash deploy/pre_deploy_check.sh
curl -sS https://api.synaglobal.vip/health
# 登录 → 宝塔面板 → 连接配置 → 立即 SSH 获取 / 批量初始化