From d00294c86d787fe5f602707fb35f4450061ae0c5 Mon Sep 17 00:00:00 2001 From: r Date: Sun, 21 Jun 2026 09:16:54 +0800 Subject: [PATCH] =?UTF-8?q?docs(btpanel):=20=E9=83=A8=E7=BD=B2=E5=AE=A1?= =?UTF-8?q?=E8=AE=A1=E4=B8=8E=20changelog?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Cursor --- .../audit/2026-06-21-btpanel-ssh-bootstrap.md | 78 +++++++++++++++++++ docs/changelog/2026-06-21-btpanel-deploy.md | 30 +++++++ 2 files changed, 108 insertions(+) create mode 100644 docs/audit/2026-06-21-btpanel-ssh-bootstrap.md create mode 100644 docs/changelog/2026-06-21-btpanel-deploy.md diff --git a/docs/audit/2026-06-21-btpanel-ssh-bootstrap.md b/docs/audit/2026-06-21-btpanel-ssh-bootstrap.md new file mode 100644 index 00000000..213361e5 --- /dev/null +++ b/docs/audit/2026-06-21-btpanel-ssh-bootstrap.md @@ -0,0 +1,78 @@ +# 审计 — 2026-06-21 宝塔 SSH 自动获取 API 部署 + +**Changelog**: `docs/changelog/2026-06-20-btpanel-ssh-api-bootstrap.md` +**Commit**: `82426b19` feat(btpanel): 独立宝塔模块与 SSH 自动获取 API + +## Step 3 规则扫描 + +| 文件 | 规则 | 结论 | +|------|------|------| +| `ssh_bootstrap.py` | 无静默吞错、远程 JSON 校验 | PASS | +| `bootstrap_state.py` | 仅已入库服务器进 loop | PASS | +| `btpanel_service.py` | CUD 审计 `bt_panel_ssh_bootstrap` | PASS | +| `BtPanelSettingsPage.vue` | 批量操作二次确认 | PASS | +| `bootstrap_lock.py` | 同机并发 SSH 互斥 | PASS | + +## Closure + +| 项 | 状态 | 说明 | +|----|------|------| +| 后台 loop 误扫全库 | FIXED | `is_eligible` 需显式 `bt_panel` 块 | +| `result.success` SSH | FIXED | 改用 `status == success` | +| Permission denied 误判 | FIXED | 区分 SSH 认证与 api.json 写权限 | +| 空凭据标 ready | FIXED | `bootstrap_empty_credentials` | +| get_config 每次 SSH | FIXED | pending/installing 或 refresh 才探测 | + +## 文件清单 + +- `frontend/src/App.vue` +- `frontend/src/api/btpanel.ts` +- `frontend/src/components/btpanel/BtPanelPageShell.vue` +- `frontend/src/components/btpanel/BtPanelServerPicker.vue` +- `frontend/src/composables/btpanel/btPanelContext.ts` +- `frontend/src/composables/btpanel/useBtPanelPageLoad.ts` +- `frontend/src/composables/btpanel/useBtPanelServer.ts` +- `frontend/src/constants/cachedPages.ts` +- `frontend/src/pages/btpanel/BtPanelCrontabPage.vue` +- `frontend/src/pages/btpanel/BtPanelDatabasesPage.vue` +- `frontend/src/pages/btpanel/BtPanelDomainsPage.vue` +- `frontend/src/pages/btpanel/BtPanelLoginPage.vue` +- `frontend/src/pages/btpanel/BtPanelMonitorPage.vue` +- `frontend/src/pages/btpanel/BtPanelServicesPage.vue` +- `frontend/src/pages/btpanel/BtPanelSettingsPage.vue` +- `frontend/src/pages/btpanel/BtPanelSiteCreatePage.vue` +- `frontend/src/pages/btpanel/BtPanelSitesPage.vue` +- `frontend/src/pages/btpanel/BtPanelSslPage.vue` +- `frontend/src/router/index.ts` +- `server/api/btpanel.py` +- `server/api/btpanel_schemas.py` +- `server/api/servers.py` +- `server/application/services/btpanel_bootstrap_schedule.py` +- `server/application/services/btpanel_service.py` +- `server/application/services/server_batch_service.py` +- `server/background/bt_panel_bootstrap_loop.py` +- `server/config.py` +- `server/infrastructure/btpanel/__init__.py` +- `server/infrastructure/btpanel/bootstrap_lock.py` +- `server/infrastructure/btpanel/bootstrap_state.py` +- `server/infrastructure/btpanel/client.py` +- `server/infrastructure/btpanel/credentials.py` +- `server/infrastructure/btpanel/source_ip.py` +- `server/infrastructure/btpanel/ssh_bootstrap.py` +- `server/infrastructure/btpanel/ssh_login.py` +- `server/infrastructure/ssh/remote_shell.py` +- `server/main.py` +- `tests/test_btpanel_bootstrap_loop.py` +- `tests/test_btpanel_client.py` +- `tests/test_btpanel_get_config.py` +- `tests/test_btpanel_ssh_bootstrap.py` +- `tests/test_btpanel_ssh_login.py` + +## DoD + +- [x] Step 3 规则扫描 +- [x] Closure 表 +- [x] 文件清单与 `git diff HEAD~1..HEAD` 对齐 +- [x] `local_verify` 通过 +- [x] `tests/test_btpanel_*.py` 25 passed +- [x] 需重启 API 注册 `bt_panel_bootstrap_loop` diff --git a/docs/changelog/2026-06-21-btpanel-deploy.md b/docs/changelog/2026-06-21-btpanel-deploy.md new file mode 100644 index 00000000..782d73cc --- /dev/null +++ b/docs/changelog/2026-06-21-btpanel-deploy.md @@ -0,0 +1,30 @@ +# Changelog — 宝塔模块生产部署（2026-06-21） + +**日期**：2026-06-21 + +## 摘要 + +将 commit `82426b19`（独立宝塔模块 + SSH 自动获取 API）部署至生产 `api.synaglobal.vip`。 + +## 变更范围 + +- 后端：`/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 +bash deploy/pre_deploy_check.sh +curl -sS https://api.synaglobal.vip/health +# 登录 → 宝塔面板 → 连接配置 → 立即 SSH 获取 / 批量初始化 +```