# CoMi V3.0环境准备指导手册
北京致远互联软件股份有限公司
2026年10月
# 前言
本手册对致远新一代智能体产品家族CoMi V3.0版本服务器环境准备相关事宜进行说明,如对本手册中相关内容存在疑问,请与致远互联的客户服务人员联系。
CoMi V3.0暂时只支持V5产品线(A6、A8、G6、A8N、G6N),不支持V8云原生产品线(A9C)。且对V5产品线版本和BuildID有明确要求,详细支持版本信息详见 [版本支持矩阵] (opens new window) 在线文档。
视频讲解:如对本文内容还有疑惑,可通过视频讲解加强理解,详细视频访问《CoMi飞书知识库环境资源准备 (opens new window)》查看。
CoMi部署完成后,如需了解相关功能,请参考 《CoMi云文档知识库 (opens new window)》,也可使用平台的智能搜索咨询:

# CoMi环境准备
# 部署架构图
客户端、协同OA与CoMi V3.0版本相关服务的部署关系如下图所示(图中每个节点对应一个服务,多个服务可以根据情况部署在一台服务器):

注意:
CoMi系列服务可部署在一台服务器,当前仅支持单机模式,暂无高可用方案
外网端口开放说明: 如客户需要外网或移动端使用CoMi,仅需开放Nginx上的内外网端口映射即可,CoMi也基于Nginx做出口。
协同主服务、CoMi等服务需要在同一局域网环境(或千兆内网),确保网络可达和足够带宽,避免出现访问故障和缓慢。
访问公网说明:如客户需要使用CoMi安全助理智能体则需要开通访问外网的权限(无此需求可忽略),服务会定期采集外部热门威胁情报:
- (1) 致远官方漏洞库查询接口:https://service.seeyon.com
- (2) 国际漏洞库CVE查询工具 :https://www.cve.org ; https://cveawg.mitre.org 详细说明见《CoMi用户操作手册》
协同OA和CoMi服务的对应关系:
- 协同OA和CoMi服务是一一对应关系,不允许出现两套OA连接同一个CoMi服务的情况
- CoMi部署时需要配置协同OA的Nginx访问地址,这个地址是唯一的,故也必须做到一一对应。
- 不支持测试环境部署的CoMi切换到生产环境,生产环境需要重新部署【详见FAQ (opens new window)】。
CoMi V3.0相关服务说明及配置建议:
- 协同OA服务/协同数据库:必须,老客户已部署协同无需增配,全新客户参考协同部署手册准备资源
- LLM大语言模型:必须,需客户准备,具体要求见后续大模型章节
- Embedding文本向量模型:必须,需客户准备,具体要求见后续大模型章节
- ReRank重排序模型:非必须,需客户准备,具体要求见后续大模型章节
- Nginx服务:必须,建议资源不低于
2C/4G/100G,老客户已部署无需增配,可独立部署、也可部署至协同OA服务器或部署至CoMi服务器,CoMi需要依赖Nginx才能实现与协同OA保持同域和安全通信 - AI-Engine服务:必须,端口8000,建议资源不低于
4C/8G/200G,推荐与其它CoMi服务部署至一台服务器 - AI-Manager服务:必须,端口8181,建议资源不低于
4C/16G/200G,依赖关系数据库存储数据(支持范围见CoMi数据库),针对当前服务新建一个库,推荐与其它CoMi服务部署至一台服务器 - AI-Security服务:非必须,端口9000,建议资源不低于
4C/8G/200G,仅使用安全助理智能体可选装,推荐与其它CoMi服务部署至一台服务器 - CoMi Server服务,必须,端口8081,建议资源不低于
4C/8G/200G,依赖关系数据库存储数据(支持范围见CoMi数据库),针对当前服务新建一个库,CoMi前端UI和CoMi APP均需要此服务,推荐与其它CoMi服务部署至一台服务器。 - AI-DocumentParse文件解析服务,必须,端口9880,CoMi V2.0.2版本新增文件解析服务,AI-Manager上传的知识库文件,AI-DocumentParse也需要读取,故要求AI-Manager和AI-DocumentParse部署在同一服务器中。
- comi-deno 沙箱为必部署组件,占用端口 8877,该组件在 CoMi V2.0.2 版本新增,核心用于对工作流代码节点的运行进行安全隔离与权限管控,仅允许执行预设白名单内的方法,规避非合规代码执行带来的安全风险,保障系统运行安全;该组件需要与 AI-Engine 服务部署在同一服务器,供 AI-Engine 访问调用(沙箱在Docker中安全运行,安装工具支持自动安装Docker Engine及沙箱镜像)。注:CoMi Docker 部署模式不涉及沙箱服务(容器本身就是一种安全隔离)。
- ElasticSearch向量库:必须,端口9200、9300,建议资源不低于
4C/8G/200G,推荐与其它CoMi服务部署至一台服务器。这里的ElasticSearch ≠ 协同全文检索服务,两者是各自独立的服务,需要分别部署维护。注:CoMi早期版本使用Qdrant作为向量库,自CoMi 2.1.0开始替换为ElasticSearch作为向量库,老版本升级迁移见升级手册。 - 关系型数据库:必须,支持MySQL、SQLServer、Oracle、达梦、金仓,数据库有版本要求(详见后续章节),可复用现有数据库资源,也可与其它CoMi服务部署至一台服务器。
- 协同驾驶舱BI:非必须,端口8058、5432,智能问数场景需要部署,依赖PostgreSQL做数仓,如老客户已部署协同驾驶舱BI,则需要参考智能问数部署手册检查是否需要升级BI程序版本。 V8云原生产品线(A9C)不涉及此服务。
- CoMi Table智能表格服务:非必须,端口 18080(comi-cute-tables 智能表格主服务)、18081/18084(comi-table-document-runtime 智能文档运行时与协同预览网关)、19000(comi-minio 对象存储)。CoMi V3.0 版本新增智能表格与文档协同特性,需要不低于
4C/8G/100G资源。该服务依赖minio、redist、postgresql(无平替),仅有智能表格协同分析需求的客户才需部署,如无此需求请勿安装。 - CoMi Table 智能表格系列服务:非必须(CoMi V3.0 新增核心特性),仅在需要使用「CoMi Table 智能表格与文档协同分析」场景时部署。依赖服务较多,需要额外预留不低于
8G内存资源和充足磁盘空间,包含以下组件:- PostgreSQL:端口 5432,必须自行提前部署或使用 Docker 内置,需新建独立空库
comi_table。 - Redis 6 或 7 单机版:端口 6379,缓存服务,可复用 OA 集群模式的单机 Redis(预留 1 个空逻辑库,默认 db0)。
- MINIO 对象存储(comi-minio):端口 19000,智能表格底层文件资源存储,由部署工具或 Docker 一体化脚本自动部署。
- 智能表格核心服务(comi-cute-tables):端口 18080,提供智能表格业务处理与交互。
- 智能文档运行环境(comi-table-document-runtime):端口 18081(服务端口)与 18084(实时协作与预览网关),提供协同编辑与文档渲染。
- PostgreSQL:端口 5432,必须自行提前部署或使用 Docker 内置,需新建独立空库
- 录音卡服务(comi-note-server):非必须,端口 8905,仅在使用智能硬件会议录音卡设备对接、会议纪要生成与语音转写场景时按需选装,依赖 Redis 和 MySQL(
recoding库)。 - OCR解析服务:非必须,无此服务则CoMi无法解析图片、PDF 扫描件。支持两种方案:本地OCR服务部署(需客户自备GPU算力)或 客户付费购买公有云API(无需本地算力)。仅 V5 产品线适用,V8 新一代不用部署。
- 在单台服务器资源足够大的前提下,推荐 CoMi 系列基础服务(AI-Engine、AI-Manager、AI-Security、CoMi Server、AI-DocumentParse、deno沙箱、ElasticSearch)部署在同一台服务器利于集中维护。其它扩展服务(智能问数BI、智能表格 CoMi Table、OCR图片解析)根据实际环境要求与硬件资源单独部署或分机部署。部署CoMi所需总资源见后续章节。
# 服务器准备
根据上一章节多个服务可以集中部署在一台服务器原则,以下是生产环境推荐服务器规划(项目上可根据实际情况自行调整):
| 服务器 | 数量 | 配置要求 | 备注 |
|---|---|---|---|
| Nginx服务器 | 1台 | CPU>=2C/内存>=4G/数据盘100G | 单独部署灵活性更高,但不要求绝对单独部署,建议Linux/信创系统部署NG(Windows下NG性能扩展极差) |
| CoMi服务器 | 1台 | 不含问数/智能表格 CPU>=16C/内存>=32G/数据盘>=500G 含智能问数/智能表格 CPU>=16C/内存>=64G/数据盘>=1000G | 1台服务器部署CoMi系列服务,需要Linux/信创系统,无需GPU算力 |
| OCR本地GPU方案 | 1台 | CPU>=4C/内存>=32G/数据盘500G/显存>=16GB | 非必须,与OCR公有云API二选一,无此服务影响无法解析图片和扫描件,仅V5产品线适用 |
| OCR公有云API方案 | - | CoMi服务器部署代理服务+购买OCR公有云解析服务 | 非必须,与OCR本地GPU二选一,无此服务影响无法解析图片和扫描件,仅V5产品线适用 |
| LLM大语言模型 | - | 公有云建议qwen3.7-plus 本地化建议Qwen3.8-27B-NVFP4 | 必备,客户提供,公有云和本地化均支持,需要OpenAI请求协议 |
| Embedding文本向量模型 | - | 公有云建议bge-m3、text-embedding-v4 本地化建议bge-m3 | 必备,客户提供,需要OpenAI请求协议,此模型配置使用后不可更改[FAQ (opens new window)] |
| ReRank重排序模型 | - | 公有云建议bge-reranker-v2-m3、qwen3-rerank 本地化建议bge-reranker-v2-m3 | 非必须,客户提供,需要 /v1/rerank 请求协议 |
| 协同OA服务器 | - | - | 必备,CoMi依赖协同OA主服务 |
注:
- CoMi服务器硬件资源用于部署服务:Ai-Engine、AI-Manager、AI-Security、APP Server、AI-DocumentParse、deno沙箱、ElasticSearch向量库、驾驶舱高级版(智能问数)、智能表格服务。不含OCR图片理解服务、大模型等。
- OCR有三种方案:第一种不部署(影响图片解析)、第二种选择购买公有云OCR服务[参考手册 (opens new window)]、第三种选择部署本地化OCR(需要GPU/NPU算力支持)[参考手册 (opens new window)]
# 大模型作用和推荐
# 一、LLM语言模型(必须)
依赖LLM大语言模型(必须),需客户准备:
- LLM语言模型作用:CoMi使用语言模型进行意图识别、调用决策、分析总结,LLM模型是超级核心。CoMi V3.0开始内置Harness自主智能引擎,对语言模型多轮指令遵循要求很高。
- 支持公有云或本地化模型,需要提供OpenAI规范的API协议(
{baseurl}/v1/chat/completions),同时提供Function Calling功能(如不支持,涉及调用协同和第三方的智能体应用均无法使用),本地化部署模型建议关闭思考过程(除非能保证高吞吐,否则执行速度极慢)。 - 公有云模型推荐:阿里百炼平台 (opens new window) 的 qwen3.7-plus(产研首推,指令遵循效果好,性价比高),其它旗舰级模型待测试。
- 本地化模型推荐:Qwen3.8-27B-NVFP4(产研首推,指令遵循效果好)。CoMi V3.0开始内置Harness自主智能引擎,任务模式涉几十上百轮自动化任务,对模型能力要求高,2026年之前发布的模型均不推荐。 如客户仅做大模型智能问答,可以尝试早期模型。
- 由于各厂商LLM模型发布过于频繁,推荐模型无法全部涵盖,项目上如有不在推荐范围内的模型,可通过如下方式判断CoMi是否可以接入:确认模型提供商提供了OpenAI API接口协议(
{baseurl}/v1/chat/completions)+ 通过CURL命令测试可用性 + CoMi部署后测试验证,详细教程见 【视频教程 (opens new window)】。 - 生产级本地化模型部署推荐使用高效的vllm推理引擎[vllm和ollama对比 (opens new window)],Tokens上下文建议256K及以上,吞吐量建议30tokens/秒/用户 以上,预估每次推理平均上下文20K。
- 并发预估:不同客户对AI使用习惯和频次不同,无法绝对评估,只能给一个大概数量,正常按照在线人数1/100测算(即1000人在线,则大模型使用10并发左右;如客户确认深度使用可按照在线人数1/50测算),并发越高意味着所需算力越多,消耗Tokens越大。
- 算力问题:国产化厂商的算力卡支持部署的模型型号和部署方案千差万别(附 [昇腾社区模型支持列表 (opens new window)] ),我司无相关推荐,具体请咨询算力厂商!我们能提供的是上面那些推荐模型、上下文建议等,再结合并发提供一个大概的显存占用数据供客户参考购买多大的算力集群,显存占用测算公式参考【算力测试在线文档 (opens new window)】。
# 二、Embedding向量模型(必须)
依赖Embedding文本向量模型(必须),需客户准备:
- 作用:解决无法检索企业私域知识的关键模型,将企业文本数据转化为向量,实现语义搜索,让CoMi能够实现自然语言检索协同内部知识的能力。
- CoMi在使用前需进行数据初始化,初始化操作依赖Embedding模型进行数据向量化,故该模型必须。
- 支持公有云和本地化模型,需要提供OpenAI规范的API连接接口(
{baseurl}/v1/embeddings),Embedding模型别名为词嵌入模型。 - 模型需支持不低于8192 Tokens(8K上下文长度)的输入,向量维度默认1024
- 公有云推荐 硅基流动AI平台bge-m3 (opens new window)、华为云大模型平台bge-m3(以后可较低成本切本地bge-m3模型),如长期使用公有云模型可以选择阿里百炼平台 (opens new window) 的text-embedding-v4
- 本地化部署Embedding模型 推荐 bge-m3 (opens new window), 附 [bge-m3模型启动运行命令 (opens new window)],供有部署维护能力的客户参考。Embedding模型所需算力较少(8GB显存要求),可以在宽裕的算力卡上部署,或与ReRanker模型共用一张RTX 4080 16G即可。
- 特别提醒:Embedding模型必须提前确认,CoMi一旦使用Embedding模型初始化后,无法更换成其它型号的Embedding模型,详细解释见[FAQ (opens new window)]。
# 三、ReRank重排序模型(按需)
依赖ReRank重排序模型(非必须),需客户准备:
- 作用:如需向量检索+全文检索多路召回能力提升检索质量,则必须使用ReRank模型
- 支持公有云和本地化模型,需要提供 cohere的API接口标准 (opens new window)(
{path}/v1/rerank),该接口被Jina、vLLM、SGLang以及华为云等多个厂商遵守(如使用vllm启动则天然支持rerank接口请求)。 - 公有云推荐 硅基流动AI平台bge-reranker-v2-m3 (opens new window)、华为云大模型平台bge-reranker-v2-m3
- 本地化部署ReRank模型推荐 bge-reranker-v2-m3 (opens new window)(支持8k token上下文),附 [bge-reranker-v2-m3模型启动运行命令 (opens new window)],供有部署维护能力的客户参考。ReRank模型所需算力较少(8GB显存要求),可以在宽裕的算力卡上部署,或与Embedding模型共用一张RTX 4080 16G即可。
# 四、CoMi配置大模型资料
- 如需了解什么是OpenAI接口,接口应该如何测试可参考《CoMi模型配置操作手册 (opens new window)》中的测试示例。
- 不同算力卡部署本地化模型方案不同,我司无相关专业手册资料,请咨询算力厂商。
- 如客户具备自主部署维护模型能力,想了解最低算力和相关模型下载地址,可参考《CoMi知识库-硬件成本预估 (opens new window)》在线文档和视频。
# CoMi服务器部署规划
CoMi相关服务器资源规划: CoMi可以在一台,也可以多个服务分离部署,无论哪种方式需要确保服务器资源足够(避免引发生产系统性能故障)
- 如单台服务器资源足够大,可以考虑CoMi多个相关服务部署在一起
- 如服务器数量充足,或此前已经部署过BI,可以复用现有服务器资源,只针对CoMi其它服务准备一台服务器

Nginx服务器规划: (服务器数量有限情况下)协同可与Nginx同一台服务器,或者CoMi与Nginx同一台服务器,确保服务器总资源是否满足需求。
注:不推荐Nginx部署在Windows服务器,Nginx官方申明Nginx for Windows是beta测试版本 (opens new window),稳定性扩展性差,请务必让客户知晓风险!

(服务器数量有限情况下)生产环境不推荐CoMi系列服务与文档通、数科、致信等服务部署在一起,避免端口冲突、资源争抢等问题:

(客户已经在使用自己的SLB、ELB或F5等Web服务)这种场景下依然需要追加至少1台Nginx服务,将Nginx放在客户专属Web服务后面、协同OA前面,示意图如下:
- 如果协同本身是单机 或 客户不在乎NG的高可用性,则部署1台NG即可:可单独服务器、也可以直接在协同OA上部署1个NG 或 在CoMi服务器部署1个NG
- 如果客户对负载均衡节点有高可用性要求,则前置部署两台NG即可解决问题

# 安装包准备
从商务公布的安装程序地址下载(文档中心-文档库-营销中心-营销体系销售管理知识库-产品下载地址-提交给区域产品下载地址xxx.xls),产品线对应AI:

# 适配协同版本
CoMi V3.0并不支持全部协同版本,在部署之前需要参考 【CoMi和协同对应关系表 (opens new window)】 检查版本适配性,如版本不支持则需要升级,如版本备注需打补丁则按要求准备补丁包。

# 操作系统支持
CoMi V3系列(不含OCR图片解析)服务支持如下操作系统:
| 分类 | 支持情况 |
|---|---|
| 权限要求 | 需要以管理员(root)权限操作 (root所需权限说明 (opens new window)) |
| 支持操作系统 | CentOS 7、CentOS 8 RedHat 7、RedHat 8 、RedHat9 openEuler 24.03-LTS Anolis 8.10 Ubuntu 22.04 LTS 麒麟V10 统信UOS V20 其它Linux类系统理论支持,请直接部署测试 |
| 服务器类型 | x86、Arm |
注:
OCR图片解析服务GPU/NPU版部署要求: 详见部署手册《OCR Docker部署手册GPU版 (opens new window)》、《OCR图片理解模型服务Docker部署手册(NPU版) (opens new window)》。
不支持Windows系统部署CoMi:没有部署维护工具。
# 适配数据库版本范围
CoMi V3.0系列版本支持的数据库版本要求如下,不在版本范围的数据库不可用。数据库参数配置兼容要求与协同OA一致,故可以复用协同OA数据库服务(新建comi的数据库):
- mysql5.7、mysql8.0 、mysql8.4(mysql都用utf8-mb4字符集)
- 达梦8.4
- 人大金仓(电科金仓)V8R6、V9R1(Oracle兼容模式)
- postgreSQL 13.3
- sqlServer 2019
- oracle 19c(其它Oracle版本不支持)
不涉及信创合规性,也推荐快速部署MySQL 或 PostgreSQL(更推荐),实现CoMi单独数据库维护:
# CoMi系列服务部署方式
# 部署模式和资料
CoMi V3系列服务支持多种部署方式,项目上可根据用户情况选择合适的部署模式:
| 方案 | 部署方式 | 支持操作系统 | 部署说明 | 推荐指数 | 部署手册 |
|---|---|---|---|---|---|
| 方案1 | 向导式部署 | Linux、信创系统 | 自动安装CoMi基础服务、智能问数、智能表格,浏览器网页可视化启停+调整参数,简单易用 适合大部分环境,尤其信创项目 当前方案不支持自动部署如下服务:Nginx、数据库、Redis,这些服务需要手工部署 | ★★★★★ | 手册链接 (opens new window) |
| 方案2 | Docker容器部署 | Linux、信创系统 | 自动安装docker和CoMi基础服务,包括MySQL数据库、智能问数、智能表格、Nginx均可自动安装,适合快速搭建出效果,需要具备一定Linux维护经验 当前方案不支持集成信创数据库,且技术要求较高,建议POC环境使用 | ★★★☆☆ | 手册链接 (opens new window) |
# 方案1智能工具部署
推荐生产系统使用此方案部署,当前方案主要是通过浏览器进行部署、升级,以及后续的日常启停、获取日志维护,适合全部维护人员。
基于工具部署,如果是新客户,您可以参考《CoMi V3.0部署工具安装维护手册 (opens new window)》来完成CoMi的部署,如客户已使用此工具部署了老版本,则可以参考《CoMi V3.0 智能部署工具升级手册 (opens new window)》来完成升级。
推荐部署路线:
- 提前自行准备大模型
- 提前自行准备与CoMi版本匹配的协同OA
- 提前自行准备Nginx,确保Nginx能代理到OA并且通过NG能正常访问使用OA
- 提前自行准备数据库,如MySQL,也可以复用协同OA库,CoMi有多个服务需要接数据库
- 先进行CoMi基础服务部署,参考部署工具安装维护手册完成基础服务的部署,包含:AI-Manager、AI-Engine、AI-Security、ElasticSearch、CoMi Server、AI-DocumentParse、CoMi沙箱 (ai-engine-sandbox)。最终结果:完成服务部署、大模型配置、CoMi数据初始化。
- 再按需部署其它服务,用户需要使用什么额外功能再去进行额外服务部署:
- 如需智能问数,则追加智能问数的部署:参考手册先准备一个PostgreSQL数仓库,再部署BI,最后初始化接入数仓即可使用
- 如需智能表格,则追加智能表格的部署:参考手册先准备一个PostgreSQL、Redis,再部署CoMi Table即可
# 方案2Docker容器部署
推荐POC环境通过Docker容器的形式快速部署,前提是部署人员对Docker非常熟悉,否则后续维护升级都很麻烦。
基于Docker部署,如果是新客户,您可以参考《CoMi V3.0 Docker模式安装维护手册 (opens new window)》来完成CoMi的部署,如客户已使用此CoMi Docker老版本,则可以参考《CoMi V3.0 Docker升级操作手册 (opens new window)》来完成升级。
推荐部署路线:
- 提前自行准备大模型
- 提前自行准备与CoMi版本匹配的协同OA
- 如客户有Nginx就用自己的NG,如没有就用CoMi Docker内置的NG
- 以上完成后,不用准备额外数据库,直接下载CoMi Docker离线包,然后根据客户实际需求一次选择好全部服务,一次部署完成
- CoMi Docker内置了CoMi服务所需的Nginx、Redis、MySQL、PostgreSQL,部署效率会高很多,但后期维护没有工具可视化方便
# 其它独立服务部署手册
| 编号 | 服务名 | 支持操作系统 | 部署说明 | 部署手册 |
|---|---|---|---|---|
| 1 | Nginx | Linux、信创系统 | Nginx部署手册参考 (opens new window) | |
| 2 | 数据库 | Windows Server、Linux、信创系统 | 可复用协同数据库,如CoMi单独使用更推荐选择PostgreSQL(CoMi、BI和CoMi table都依赖PG) | MySQL8.4部署手册参考 (opens new window) Postgresql数据库安装参考手册 (opens new window) |
| 3 | 智能问数 | Windows Server、Linux、信创系统 | 向导式部署工具支持自动部署智能问数,只有无法使用向导式工具场景才需参考手册独立部署 | 协同驾驶舱智能问数手册 (opens new window) |
| 4 | 智能表格 | Linux、信创系统 | CoMi 3.0新增CoMi Table智能表格能力,建议先部署CoMi基础服务,再部署智能表格,工具部署和Docker模式均提供了部署能力 | CoMi V3.0智能表格工具部署维护手册 (opens new window) CoMi V3.0 Docker模式安装维护手册 (opens new window) |
| 5 | OCR图片解析服务 | 可选本地化算力部署 或 调用云端OCR API服务 | 本地化算力部署则选择GPU版手册,掉欧阳那个云端OCR API服务则选择API版手册 | OCR Docker部署手册GPU版 (opens new window) OCR Docker部署手册API版 (opens new window) |
快速跳转