2.2 KiB
2.2 KiB
从协议版目录部署完整管理后台
本部署目录包含管理 API、模型网关和知识 Worker，使用同一数据库卷。构建上下文为 C:\wechat_rpa（Linux 上为其对应源码根目录）。桌面协议发送仍运行在 Windows 客户端，服务端不启动企业微信。
首次部署
- 将本源码目录及
admin-web/apps/web-antd/dist放到服务器。 - 将
.env.example复制为本目录.env，填写现有账号服务地址。语义检索为可选项，参照根目录 KNOWLEDGE.md；未配置时使用关键词检索。 - 在本目录建立
data，允许容器 UID 10001 写入。迁移已有库时使用 SQLite backup API 或停止写入后复制数据库及配套密钥；不要复制正在写入的裸数据库文件。 - 在源码根目录运行：
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 保留为历史资料，当前知识版本使用本目录。