运维文档

# CoMi V2.1.0 Docker升级操作手册

北京致远互联软件股份有限公司

2026年5月

# 前言

本手册就CoMi 2.0、2.0.1、2.0.2老版本（基于Docker安装维护）升级到CoMi V2.1.0版本（基于Docker）提供详细升级操作说明。

更详细的CoMi 2.1.0版本变化和支持说明详见《CoMi环境准备指导手册 (opens new window)》。

协同版本适配说明：

  • CoMi V2.1.0仅支持V5产品线10.0SP1 B260430版本 和 V8新一代V5.3.0版本，更早版本暂不支持。

  • 如您的协同版本是早期版本，必须升级到相匹配的版本方可使用CoMi V2.1.0！

以下内容以 comi2.0.2 升级到 comi2.1.0 为例，实际操作时请按现场版本、安装包名称和目录名称替换。

# 1. 升级包准备

CoMi V2.1.0 在线安装包，适合可以连接外网的服务器：

  • 在线安装包（安装过程中自动下载相关服务）：https://cdhx78.seeyon.com:5356/downloads/comi2.1.0-install.tar.gz
  • 注：使用在线安装包需要保证服务器可访问 https://cdhx78.seeyon.com:5356

CoMi V2.1.0 离线安装包，适合无法连接外网的服务器：

  • X86 环境离线安装包：https://cdhx78.seeyon.com:5356/downloads/comi2.1.0-install-offline-x86.tar.gz
  • ARM 环境离线安装包：https://cdhx78.seeyon.com:5356/downloads/comi2.1.0-install-offline-arm64.tar.gz

# 2. 适用范围

满足如下环境要求的客户，可参考本手册操作：

  • 已通过 Docker 容器化方式完成 CoMi 部署且版本为V2.0、2.01、2.0.2的项目，当前环境已有可正常运行的旧版本 CoMi。
  • 计划将协同版本升级到更高版本的项目（CoMi 2.1.0依赖最新协同版本）。
  • 本文档用于升级，不适用于全新安装。

# 3. 示例环境

本手册演示的示例环境如下：

  • 当前 CoMi 旧版本安装目录：/data/Seeyon/Comi/comi-install
  • OA 服务器：192.168.0.9
  • CoMi 服务器：192.168.0.10
  • Nginx、BI：随 CoMi 一体化容器部署，访问地址默认为 CoMi 服务器地址

# 4. 升级前准备

升级前请先确认以下事项：

  • 已提前下载最新版本的CoMi Docker一体化离线安装包。
  • 当前旧版本CoMi环境运行正常。
  • 已预留升级窗口，升级期间会停止现有 CoMi 服务。并且协同也需要升级到最新版本 [协同版本适配说明] 。

截止发稿，CoMi 2.1.0仅支持V5产品线10.0SP1 B260430版本 和 V8新一代V5.3.0版本，需要先对协同版本进行升级，才能使用！

V5产品线支持的版本（V10.0SP1 B260430）信息如下：

1778468438276.png

V8新一代支持的版本（V5.3.0）信息如下：

1778468163236.png

# 5. 停止旧版本服务并备份目录

进入旧版本安装目录，停止现有 CoMi 服务，然后将旧目录重命名为备份目录。

cd /data/Seeyon/Comi/comi-install
docker compose down

cd /data/Seeyon/Comi
mv /data/Seeyon/Comi/comi-install /data/Seeyon/Comi/bak-comi-install

执行完成后，旧版本程序目录变为：

/data/Seeyon/Comi/bak-comi-install

# 6. 下载并解压新版本安装包

将目标版本安装包下载到 /data/Seeyon/Comi/ 目录，并解压。

cd /data/Seeyon/Comi/
# 方案一：在线包
wget https://cdhx78.seeyon.com:5356/downloads/comi2.1.0-install.tar.gz
tar -zvxf comi2.1.0-install.tar.gz

# 方案二：离线包（可以不用wget命令下载，可自行在联网的电脑下载后上传到服务器）
wget https://cdhx78.seeyon.com:5356/downloads/comi2.1.0-install-offline-x86.tar.gz
tar -zvxf comi2.1.0-install-offline-x86.tar.gz

解压后会生成新的安装目录：

/data/Seeyon/Comi/comi-install

# 7. 最快升级步骤

# 升级步骤概览

现场升级时，用户实际只需要按下面 4 步操作：

  1. 停止旧版本服务，并将旧目录重命名为 bak-comi-install。
  2. 解压新版本安装包，生成新的 comi-install 目录。
  3. 在新目录中准备并修改 .env。(可先执行 cp .env.example .env，再参考 ../bak-comi-install/.env 按现场情况修改)
  4. 在新目录执行upgrade.sh升级脚本：

说明：

  • 升级场景 只执行 upgrade.sh，不要再执行 install.sh，避免重复生成 API Key、重复初始化数据库。
  • .apikey.env、宿主机数据迁移、镜像加载、服务启动、升级 SQL、重启与健康检查都由 upgrade.sh 自动处理。
  • 如果 upgrade.sh 提示 .env 缺少新增配置项，补齐后重新执行即可。

# 7.1 迁移配置文件

新版本目录解压后，需要将原环境中的关键配置迁移到新目录。

# 进入新版本目录，先从模板生成新版本的 `.env` 文件：
cd /data/Seeyon/Comi/comi-install
cp .env.example .env

然后参考旧版本目录中的 .env 文件，将现场自定义配置同步到新版本 .env 中：

1777516326348.png

1777516754820.png

重点检查以下内容是否保持一致：

  • 产品线配置
  • COMPOSE_PROFILES 选装服务配置
  • 端口配置
  • 数据库连接配置
  • Nginx 相关配置
  • Elasticsearch 相关配置
  • Qdrant 相关配置
  • 其他现场已修改的自定义参数

注意：

  • COMI_VERSION 必须保持新版本安装包中的值，不要改回旧版本。
  • 修改 .env 时以新版本模板为基础，仅迁移现场自定义配置。
  • 当前版本 .env.example 默认 COMPOSE_PROFILES 为 nginx,data-pulse,postgres,elasticsearch。
  • 如果升级过程中需要保留并读取旧版 Qdrant 数据，请在 COMPOSE_PROFILES 中追加 qdrant，例如：
# 升级过程中需要保留并读取旧版 Qdrant 数据，修改新版本配置文件 COMPOSE_PROFILES
vim /data/Seeyon/Comi/comi-install/.env
export COMPOSE_PROFILES="nginx,data-pulse,postgres,elasticsearch,qdrant"
  • 如果现场已经有独立部署的 Elasticsearch，不使用 CoMi 自带 ES，则需要将 .env 中与 ES 相关的配置改为现场已有 ES 的地址、用户名和密码，不要继续使用默认的 http://comi-es:9200。

.env 中需要重点确认的 ES 配置项如下：

FULL_TEXT_SEARCH_URL=http://已有ES地址:9200
ES_USERNAME=elastic
ES_PASSWORD=现场实际密码

当前模板中几个常用端口默认值如下，迁移旧环境时建议重点比对：

COMI_SERVER_PORT=9090
COMI_DP_PORT=9800
QDRANT_HTTP_PORT=6333
QDRANT_GRPC_PORT=6334

# 7.2 迁移旧版 Qdrant 数据

CoMi V2.1.0跟早期版本有一个重要变更：使用ElasticSearch向量库替代Qdrant向量库，故老版本客户涉及将Qdrant数据迁移到ElasticSearch向量库的过程，操作方式如下：

如果旧版本使用的是 CoMi 自带 Qdrant，而新版本已经切换为 Elasticsearch，那么在执行向量数据迁移前，需要确保新版本 docker-compose.yml 中的 qdrant 服务一起启动，供迁移程序读取旧数据。

当前仓库已经在 docker-compose.yml 中内置了 qdrant 服务，容器名固定为 comi-qdrant，因此不再需要额外执行 docker run。只需要在新版本 .env 中把 qdrant 加入 COMPOSE_PROFILES：

cd /data/Seeyon/Comi/comi-install
vim .env

# 追加 qdrant profile
export COMPOSE_PROFILES="nginx,data-pulse,postgres,elasticsearch,qdrant"

说明：

  • 旧版本目录虽然被重命名为 bak-comi-install，但 Docker volume 不会因此丢失；只要新版本目录仍以同一个 Compose 项目名启动，并启用了 qdrant profile，Compose 会继续挂载旧的 Qdrant 数据卷。
  • docker-compose.yml 中 qdrant 的容器名固定为 comi-qdrant，与现有配置文件中的引用保持一致。
  • 例如 config/ai-document-parse/.env 中的 SY_CFG_AIDP_QDRANT_SERVERS=http://comi-qdrant:6333 在该网络下可直接连通。

迁移时可使用以下地址：

  • 容器内访问旧 Qdrant gRPC 地址：comi-qdrant:6334
  • 容器内访问旧 Qdrant HTTP 地址：http://comi-qdrant:6333
  • 宿主机调试地址：http://127.0.0.1:${QDRANT_HTTP_PORT:-6333}

首次启动或重启后，可使用下面的命令检查 Qdrant 是否启动成功：

cd /data/Seeyon/Comi/comi-install
source .env

docker ps | grep comi-qdrant
curl http://127.0.0.1:${QDRANT_HTTP_PORT:-6333}/collections

注意：

  • 如果现场不需要迁移旧版 Qdrant 数据，则不要在 COMPOSE_PROFILES 中加入 qdrant。
  • 如果现场旧版本 .env 中定义了自定义 Qdrant 端口，则新版本 .env 也应保持一致，不要手工改回默认值。

# 8. 执行升级脚本

在 .env 准备完成后，直接执行升级脚本：

cd /data/Seeyon/Comi/comi-install
bash upgrade.sh

upgrade.sh 会自动处理以下动作：

  • 迁移 .apikey.env
  • 同步 nginx、MySQL 初始化脚本和 AI Engine 相关配置
  • 迁移 volumes 目录中的宿主机数据
  • 加载镜像
  • 检查端口
  • 启动服务并等待健康检查
  • 执行升级 SQL
  • 重启升级后的服务

注意：

  • 升级场景只执行 upgrade.sh，不要再执行 install.sh。
  • 如果 upgrade.sh 提示 .env 缺少新增配置项，请按提示补充后重新执行。

# 9. 升级后初始化

重启完成后，登录系统管理员后台 comi-builder，进入系统设置页面，按现场要求重新初始化以下内容：

  • 应用
  • 智能体
  • 其他依赖预制包恢复的初始化内容

# 10. 升级后检查项

升级完成后，建议至少确认以下内容：

  • docker compose ps 查看各容器是否正常启动。
  • comi-builder 是否可正常访问。
  • 原有端口映射是否与升级前保持一致。
  • 如本次升级启用了 qdrant profile，确认 comi-qdrant 容器已正常启动且可访问。
  • 预制应用包是否已正确放入 volumes/ai-manager/data/preset。
  • 系统设置中的应用、智能体是否已按预期完成初始化。

# 11. 说明

  • 本文档当前以 comi2.0.2 升级到 comi2.1.0 为示例，其他版本升级时请按实际安装包名称和目录调整命令。
  • 当前推荐的最小升级步骤是：用户准备并修改 .env，然后执行 bash upgrade.sh。
  • 如需保留更多现场说明，可在各章节下继续补充截图、版本差异说明和特殊处理步骤。
    编撰人：wangyxyf、het

快速跳转

← 录音卡部署手册 →