This commit is contained in:
Your Name
2026-07-29 09:34:02 +08:00
parent 0ff8943ee2
commit f913a57529
54 changed files with 2453 additions and 378 deletions
+6 -3
View File
@@ -2,6 +2,8 @@
项目内置了一个零额外依赖的配置后台,用于统一管理登录账号、角色、AI 模型和 MCP 配置。
> 如果要把后台部署到另一台电脑、局域网服务器或云服务器,请直接查看独立文档 [BACKEND_DEPLOY.md](BACKEND_DEPLOY.md)。部署端只需要 `admin_backend.py`,不需要上传桌面端代码或安装桌面端依赖。
## 1. 启动后台
在项目目录运行:
@@ -44,9 +46,9 @@ python admin_backend.py
同一台电脑上启动后台与桌面端时,后台会在 `backend_runtime.json` 发布一个仅限回环地址使用的临时只读同步凭证。桌面软件启动时会先检测该服务并拉取最新配置,所以即使没有保存后台账号登录,也会立即刷新“能力开关”“模型与身份”和“MCP 服务器”中的内容。该凭证不能管理用户或修改后台配置,后台停止后即失效。
## 4. 局域网部署
## 4. 连接已部署的后台
如需让其他电脑连接,可在后台所在电脑运行
后台所在电脑启动服务
```powershell
python admin_backend.py --host 0.0.0.0 --port 8765
@@ -54,7 +56,7 @@ python admin_backend.py --host 0.0.0.0 --port 8765
桌面端后台地址填写服务器的局域网地址,例如 `http://192.168.1.20:8765`。需要在 Windows 防火墙中仅对可信局域网放行该端口。
跨公网使用时不要直接暴露此 HTTP 服务,应使用 Nginx、Caddy 等反向代理配置 HTTPS,再把桌面端地址改为 HTTPS 地址
Docker、云服务器、HTTPS、备份和升级步骤统一放在 [BACKEND_DEPLOY.md](BACKEND_DEPLOY.md),不再与桌面端使用说明混在一起
## 5. 管理员密码恢复
@@ -72,4 +74,5 @@ python admin_backend.py --reset-admin-password
- `POST /api/v1/auth/logout`:注销令牌。
- `GET /api/v1/me`:读取当前用户及角色。
- `GET /api/v1/config`:读取当前版本的模型配置。
- `GET /api/v1/desktop/config`:桌面软件启动时只读同步云端配置。
- `GET /health`:健康检查。