Files
xieyi-weixin-/deploy/im-admin/README.md
T
2026-09-21 10:56:48 +08:00

29 lines
2.2 KiB
Markdown

# 从协议版目录部署完整管理后台
本部署目录包含管理 API、模型网关和知识 Worker,使用同一数据库卷。构建上下文为 C:\wechat_rpa(Linux 上为其对应源码根目录)。桌面协议发送仍运行在 Windows 客户端,服务端不启动企业微信。
## 首次部署
1. 将本源码目录及 `admin-web/apps/web-antd/dist` 放到服务器。
2. 将 `.env.example` 复制为本目录 `.env`,填写现有账号服务地址。语义检索为可选项,参照根目录 KNOWLEDGE.md;未配置时使用关键词检索。
3. 在本目录建立 `data`,允许容器 UID 10001 写入。迁移已有库时使用 SQLite backup API 或停止写入后复制数据库及配套密钥;不要复制正在写入的裸数据库文件。
4. 在源码根目录运行:
```bash
docker compose -f deploy/im-admin/compose.yaml up -d --build api gateway knowledge-worker
docker compose -f deploy/im-admin/compose.yaml ps
docker compose -f deploy/im-admin/compose.yaml logs --tail=100 knowledge-worker
```
管理 API 与页面监听宿主机 `127.0.0.1:18766`,模型网关监听 `127.0.0.1:18770`。对外访问使用反向代理。同目录 Nginx 配置是原部署示例,需按实际域名、日志路径与 TLS 配置调整,不能原样覆盖现有站点。
镜像名称 `zyt/wecom-admin:protocol-integrated`。`data` 不参与镜像构建,`.dockerignore` 仅允许服务端 Python、依赖清单和前端生产资源。镜像构建不会打包本机配置、聊天数据或密钥。
## 更新与回退
更新前保留当前镜像并备份数据库及密钥。启动时自动补齐知识相关表和索引;知识 Worker 负责分批加工和全量审核任务。关闭页面不会停止已启动的后台任务。
需要停用知识引用,可先在管理端关闭对应账号的「客服使用知识」。回退旧服务前停止知识 Worker,保留新表与运行数据。不要用旧库覆盖更新后产生的聊天归档与知识。
本配置已适配独立协议目录的文件布局;本次没有执行线上部署或 Docker 镜像构建。根目录 `backend_deploy` 和 `BACKEND_DEPLOY.md` 保留为历史资料,当前知识版本使用本目录。