Files
Enterprise-Knowledge-Base/deploy/server-running-v0.7.1

当前服务器 WeKnora v0.7.1 发布包

本目录固化 2026-08-26 正在运行的 WeKnora 核心版本,并提供迁移到新服务器时使用的无密钥部署模板。

版本身份

  • WeKnora 源码:c64a48647cd6f7eb8b0fb020b2e8fec74ee375fb
  • 上游标签:v0.7.1
  • App 镜像:wechatopenai/weknora-app:v0.7.1@sha256:d88bef9912f6abb8bc7c22144ee7f314016055b8075bda4ea8fbb28af41c3bcf
  • UI 镜像:wechatopenai/weknora-ui:v0.7.1@sha256:169678d4ba4c1f127b36c5f58a6ad567bd745d48488d693e4d3eb4117689c730
  • DocReader 镜像:wechatopenai/weknora-docreader:v0.7.1@sha256:262bab1a4b12f24dd99958e32868ffc2d2cb09270465a88820420ac378c0e149
  • 当前 App 二进制 SHA-256:aa6c6223f9980ef08120e65cdc091996b1eadbc828c69540e7e6b9cdc24bbca3

runtime-manifest.json 保存运行容器、镜像内容 ID 和源码修订的脱敏取证结果。当前 App 容器的 OCI revision 与源码 Commit 一致。

与上游 v0.7.1 的唯一代码差异

当前 MCP 镜像需要 MCP Python SDK 1.x,因此本分支保留两处运行修复:

  1. mcp-server/requirements.txt 将依赖固定为 mcp>=1.0.0,<2.0.0;
  2. mcp-server/Dockerfile 在构建期验证 Server.list_tools() 契约。

WeKnora App、UI、DocReader本身使用上述官方不可变镜像,没有把钉钉专用分支混入当前运行版本。

文件用途

  • compose.managed-data-plane.yaml:新阿里云服务器部署核心服务的模板;RDS PostgreSQL、Elasticsearch、Redis和私有OSS从环境变量接入。
  • .env.example:只包含变量名和非敏感默认值;复制为.env后填写真实值。
  • runtime-manifest.json:当前服务器运行版本取证,不用于保存运行数据。

静态检查:

cp deploy/server-running-v0.7.1/.env.example deploy/server-running-v0.7.1/.env
# 填写所有 REQUIRED 值后:
docker compose \
  --env-file deploy/server-running-v0.7.1/.env \
  -f deploy/server-running-v0.7.1/compose.managed-data-plane.yaml \
  config --quiet

.env受Git忽略。生产密钥必须由服务器上的0600文件或云Secret管理注入。

不进入 Gitea 的内容

  • 当前服务器.env和所有API Key、Token、密码、SYSTEM_AES_KEY;
  • PostgreSQL、Redis、Elasticsearch、Neo4j、ClickHouse数据卷;
  • OSS对象、上传文档、/data/files、日志、缓存和验收中的业务数据;
  • 已构建的DobotAI二进制;
  • 旧的本地API Adapter目录。Adapter和DobotAI必须使用各自独立仓库及固定Commit部署。

新服务器迁移边界

此分支固化了“代码和部署契约”,不等于已经迁移数据。迁移时还必须单独完成:

  1. PostgreSQL原生逻辑备份和隔离恢复验证;
  2. OSS对象清单、大小和SHA-256核对;
  3. Elasticsearch索引重建或受控迁移;
  4. 保管并恢复原SYSTEM_AES_KEY,否则数据库内模型凭据无法解密;
  5. 健康、文档解析、混合检索、引用、图片、Agent和Adapter端到端验收;
  6. 回滚副本验证。

v0.7.1 PostgreSQL连接当前使用sslmode=disable。接入阿里云RDS时必须走私有VPC;若目标强制TLS,需要先改造并验证连接配置,不能直接上线。