Nexus/docs/changelog/2026-06-20-btpanel-standalone-module.md

2026-06-20 — 宝塔面板独立模块

摘要

新增与「运维」菜单分离的 宝塔面板 分组及 10 个子页，后端 /api/btpanel/* 代理宝塔 API（签名 + Redis Cookie）并支持 SSH 生成 tmp_token 一键登录。

动机

用户需在 Nexus 内统一管理子机宝塔：一键登录、监控、网站/域名/SSL/数据库/计划任务/服务启停，且不并入现有服务器、文件、调度页面。

功能范围

编号	子菜单	说明
A1/A5	面板登录	API set_temp_login 或 SSH tools.py
B1–B3	系统监控	GetSystemTotal / Disk / NetWork
C1,C6	网站列表	列表 + 启停
C4	创建网站	AddSite
C10	域名管理	AddDomain / DelDomain
C15	SSL 证书	列表 + SetSSL + apply_cert
D1–D4	数据库	列表 / 创建 / 改密 / 备份
F1	计划任务	GetCrontab 只读
H1	服务管理	ServiceAdmin
—	连接配置	extra_attrs.bt_panel 加密存 API Key

涉及文件

• server/infrastructure/btpanel/*
• server/application/services/btpanel_service.py
• server/api/btpanel.py, btpanel_schemas.py
• server/main.py
• frontend/src/pages/btpanel/*, components/btpanel/*, api/btpanel.ts
• frontend/src/App.vue, router/index.ts
• docs/design/specs/2026-06-20-btpanel-module-design.md
• tests/test_btpanel_client.py

迁移 / 重启

• 无 DB 迁移（凭据在 servers.extra_attrs）
• 需重启 API 加载新路由
• 前端需 vite build

验证

pytest tests/test_btpanel_client.py -q
cd frontend && npx vite build

侧栏「宝塔面板」→ 各子页；先在「连接配置」填写面板地址与 API Key，并在子机白名单加入中心 IP。