# CoMi V3.0智能表格工具部署维护手册

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

2026年10月

# 前言

本手册就CoMi V3.0版本智能表格功能(英文名为CoMi Table)通过部署工具安装提供详细说明,如对本手册中相关内容存在疑问,请与致远互联的客户服务人员联系。

CoMi Table智能表格功能是在CoMi基础服务基础上扩展的新特性,仅有此需求的客户才需安装,安装前需要确保客户环境已经通过部署工具部署了CoMi基础服务(详见【CoMi V3.0部署工具安装维护手册 (opens new window)】)。如您是通过CoMi Docker模式部署的环境,请参考【CoMi V3.0 Docker模式安装维护手册 (opens new window)】。

1791913111309.png

# 服务组成与端口

CoMi Table智能表格功能依赖如下服务,部分服务需要自行提前部署:

服务 部署工具支持 备注
CoMi基础服务 - CoMi Table智能表格依赖CoMi基础服务(AI-Manager、AI-Engine等),请确保基础服务已部署完成且可用,参考【CoMi V3.0部署工具安装维护手册 (opens new window)】
PostgreSQL 14及以上 不支持 必须,需要自行部署,参考【Postgresql数据库安装参考手册 (opens new window)】
Redis 6或7单机 不支持 必须,需要自行部署,仅支持单机,可复用OA集群模式的Redis单机服务-勿占用OA逻辑数据库编号即可,参考【Redis单机部署参考手册 (opens new window)】
MINIO对象存储服务(comi-minio) 支持 必须,CoMi部署工具自动部署,参考本手册
智能表格&文档服务(comi-cute-tables) 支持 必须,CoMi部署工具自动部署,参考本手册
智能文档运行环境(comi-table-document-runtime) 支持 必须,CoMi部署工具自动部署,参考本手册

注意:

  • CoMi Table智能表格所需服务较多,需要预留至少8G内存资源和充足的磁盘空间,如客户不使用此功能请勿部署!
  • PostgreSQL 与 Redis 不包含在这三个包中,部署前需手工安装并保证连通;部署工具不负责安装或升级它们。
  • 建议CoMi Table智能表格与CoMi基础服务部署在一起,CoMi基础服务自带Docker,comi-minio和comi-table-document-runtime依赖Docker环境。
  • 智能表格包还会检查 CPU、内存、磁盘、PostgreSQL 和 OA/Nginx 连通性。预检不通过时先处理原因,不要绕过后强行启动。

# 安装包准备

CoMi Table智能表格工具从商务公布的安装程序地址下载(文档中心-文档库-营销中心-营销体系销售管理知识库-产品下载地址-提交给区域产品下载地址xxx.xls),产品线对应CoMi V3.0。

智能部署工具和CoMi基础服务无需下载,仅需下载CoMi Table智能表格相关包(下载与服务器相合适的架构安装包):

1791880981263.png

# 部署前检查

1、确保已经提前部署CoMi基础服务 和 Redis、PostgreSQL服务,【详见基础依赖说明】。

  • PostgreSQL:确认版本至少 14、数据库连接可达,并且 Table 数据库为空、用户有建表权限。
  • Redis:确认 Table 服务所在主机和 Docker 容器都能通过配置的地址访问 Redis。配置密码认证;密码不得写入命令参数、手册或截图。Redis 端口仅允许所需内网来源访问。
  • Nginx/OA:确保Nginx代理OA地址可被CoMi Table服务器访问。
  • Docker:确认 Docker 正常、docker compose version 可运行、当前登录用户有权限执行 Docker,CoMi Table依赖Docker(注:如当前服务器部署了CoMi基础服务,则已经自带Docker,此步可跳过)。

2、CoMi部署工具已经启动,并且能正常访问管理控制台。

1791881247504.png

# PostgreSQL 数据库准备

提前自行部署PostgreSQL数据库(参考【Postgresql数据库安装参考手册 (opens new window)】),并且创建一个空库给CoMi Table,示例如下:

-- PostgreSQL数据库 和 海量数据库(PostgreSQL兼容模式):
CREATE DATABASE comi_table TABLESPACE 表空间名称 ENCODING 'UTF8';

1791881804435.png

# Redis单机服务准备

提前自行部署Redis单机服务(参考【Redis单机部署参考手册 (opens new window)】,无需持久化,参数配置参考手册),单机 Redis实例内包含 16 个逻辑数据库(db0~db15),请至少预留1个空的逻辑数据库给CoMi Table。

1791885790939.png

# 上传并解析部署包

# 上传CoMi Table包

将部署包压缩成zip(如comi-table-v3.0.0-packages.zip)上传至CoMiTable部署的服务器:

mkdir -p /data/comi-table-v3.0.0-packages
unzip comi-table-v3.0.0-packages.zip -d /data/comi-table-v3.0.0-packages

1791882610514.png

1791883250315.png

# 工作台解析

  1. 在 9526 工作台打开已部署基础服务的环境,点「修改并更新环境」。
  2. 「输入服务器部署包路径」填写 /data/comi-table-v3.0.0-packages,点「解析」。解析通常需要等待约 40 秒;按钮处于加载状态时不要重复点击。
  3. 服务规划表应新增三行:智能表格&文档服务、智能文档运行环境、MINIO资源服务。
  4. 仅为这三行选择目标主机 CoMi服务器然后进行配置。

1791883364045.png

# 配置CoMi Table三个服务

# 整体配置流程

1、对于每个已勾选的服务,依次设定服务的目标主机,点击其操作列的 [配置] 按钮,会弹出一个该服务专属的配置窗口

2、在弹出的配置窗口中,根据界面提示和本手册后续章节的指引,填写所有必填参数

3、完成一个服务的配置后,点击 [确定] 保存配置,该服务状态会变为 [待校验]

4、在 [外部依赖与集成配置] 版块配置好Nginx服务器主机和Nginx的配置文件目录

5、当所有需要部署的服务的参数都填写完毕后,点击服务列表左下角的 [一键配置校验] 按钮:需先勾选服务列表的复选框(可用 Select all 全选),该按钮才会激活。

6、工具将对所有配置进行校验。校验成功后,所有已勾选服务的“状态”列将变为绿色的 [已校验],此时您才可以进入下一个部署阶段

1791883559843.png

# MINIO资源服务

建议全部保持默认,点击确定即可:

  • 目标主机:设置当前服务的部署位置,示例如 CoMi服务器
  • 端口:19000,建议保持默认
  • 部署路径:/data/Seeyon/Comi/running/comi-minio,建议保持默认
  • 对象存储配置:工具自动配置,不可修改,保持默认

1791883778834.png

# 智能表格&文档服务

基础信息、数据库配置、缓存配置:

  • 目标主机:设置当前服务的部署位置,示例如 CoMi服务器
  • 端口和路径:18080、/data/Seeyon/Comi/running/comi-cute-tables,建议保持默认
  • 数据库配置:只能使用PostgreSQL14及以上,自行提前部署数据库及创建空库(详见【PostgreSQL数据库准备】),配置正确的数据库连接信息并确保测试通过,示例如 jdbc:postgresql://192.168.94.155:5432/comi_table
  • Redis配置:Redis主机填写服务器宿主机IP(不要填写localhost或127.0.0.1),Redis端口填写部署时保留的端口,Redis密码按自身部署配置设置,Redis数据库(Redis实例默认有16 个逻辑数据库)默认0,如该值被占用,请选择合适的逻辑库供CoMi Table使用。

1791885415125.png

对象存储配置(自动共享): 配置信息从MINIO资源服务中自动获取,无需人工调整,建议保持默认

1791887433102.png

集成配置、内部安全配置(自动生成):

  • OA 反向代理地址:必填项,填写 Nginx 反向代理协同 OA 的完整内网IP和端口(通过NG能访问协同的http地址),示例如 http://192.168.94.140:80,该地址用于回调与授权验证
  • 授信访问来源:必填项,填写PC、移动所有客户端访问协同OA的地址,多个地址用 , 半角逗号隔开,示例如http://192.168.94.140,https://demo.seeyonv5.com,https://mobile.seeyonv5.com:8443 通俗说:用户所有客户端电脑浏览器访问地址、M3 APP配置的地址、微协同等配置的OA地址都要填写到此处!
  • 其它参数(包含OpenAPI访问凭证)建议全部保持默认

1791889071308.png

# 智能文档运行环境

  • 目标主机:设置当前服务的部署位置,示例如 CoMi服务器
  • 运行端口:18081,建议保持默认
  • 部署路径:/data/Seeyon/Comi/running/comi-table-document-runtime,建议保持默认
  • 内部服务令牌、对象存储配置(自动共享):全部保持默认

1791888752638.png

# 校验、预检查与部署发布

1、保存三个服务配置,然后进行全选再「一键配置校验」。所有服务都显示「已校验」后继续。

1791889478007.png

一键配置校验后,需要确保外部依赖与集成配置中的“自动注入配置”开启,工具会向Nginx写入CoMi Table配置,如客户环境无法连接NG,则部署结束后,需手动追加NG配置:

1791892115623.png

自动化执行阶段,点击开始部署环境:

1791890272859.png

看到如下提示表示部署完成,如提示“参考报告配置nginx.conf”则说明Nginx未自动部署写入,需要参考后续手册手工配置:

1791890434869.png

在服务列表中,确保全部服务处于启动状态,同时导出生成报告,参考报告检查每个配置项是否正确:

1791890560973.png

# Nginx 发布

工作台的 OA/Nginx 检查要求 /seeyon/ai-table/ 能到达 CoMi 服务器的 18080 端口。如果工作台没有自动生成对应路由,在 Nginx 的 server 监听块中增加 Table 与 WebSocket 反向代理,备份配置后先执行 nginx -t,成功后再 reload:

location ^~ /seeyon/ai-table/ {
    proxy_pass http://CoMi服务器IP:18080;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

location ^~ /document-collaboration {
    proxy_pass http://CoMi服务器IP:18081;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_read_timeout 3600s;
}

当前环境 Nginx 主配置路径为 /apps/nginx/conf/nginx.conf。在 Nginx 服务器上使用对应的 Nginx 二进制执行配置测试和 reload;不要直接覆盖整份 nginx.conf。最终以 http://实际OA入口/seeyon/ai-table/ 返回应用内容、工作台 Nginx 连接检查正常为发布成功。

# 日常启停、日志与升级

手动启停维护命令:

# 智能表格 Java 服务
cd /data/Seeyon/Comi/running/comi-cute-tables
bash bin/startup.sh
bash bin/shutdown.sh

# MinIO(包内包含 comi-minio 子目录)
cd /data/Seeyon/Comi/running/comi-minio/comi-minio
bash bin/startup.sh
bash bin/shutdown.sh
bash bin/health.sh

# 文档运行环境 Docker 服务(包内包含同名子目录)
cd /data/Seeyon/Comi/running/comi-table-document-runtime/comi-table-document-runtime
bash bin/startup.sh
bash bin/shutdown.sh
bash bin/health.sh

常用检查:

ss -lntp | grep -E ':(18080|18081|18084|19000)( |$)' || true
docker ps --filter name=comi-minio --filter name=comi-table-document-runtime
docker inspect --format '{{.State.Health.Status}}' comi-minio
docker inspect --format '{{.State.Health.Status}}' comi-table-document-runtime

# 日志目录

  • 智能表格:/data/Seeyon/Comi/running/comi-cute-tables/logs
  • MinIO:/data/Seeyon/Comi/running/comi-minio/comi-minio/logs
  • 文档运行环境:/data/Seeyon/Comi/running/comi-table-document-runtime/comi-table-document-runtime/logs

# 操作手册

智能表格操作手册详见《CoMi Table智能表格与文档 (opens new window)》。

编撰人:het