# 方寸智脑私有化部署手册(适用V11.0版本)
# 关于方寸智脑
方寸智脑是方寸的新一代智慧公文产品,自协同V5 V11.0版本开始标准集成方寸智脑,而V5早期版本集成方寸智慧公文。
# 安装前准备
# 适用协同版本
方寸智脑服务支持的协同版本如下:
- V8新一代云原生微服务平台支持:当前暂无版本支持。
- V5产品支持:V11.0版本开始标准支持方寸智脑平台。V5集成方寸智脑所需插件和能力详见 《智能公文指导手册 (opens new window)》 - V11.0版本方寸文会事套件场景 部分。

# 环境部署要求
# 操作系统
- 非信创:centos7.6以上,ubuntu 20.04 server 以上都支持
- 信创:银河麒麟高级服务器操作系统 V10 SP3 2403、openEuler 22.03 LTS SP4、统信服务器操作系统 V20(1050e)
# 服务器资源准备
服务器资源方案引导:
选择不同的方寸集成插件所需服务器资源不同:
| V5致远商务插件 | 所需服务 | 服务器资源方案 |
|---|---|---|
| 智文助手、智文引擎、AI文枢标准版 | 方寸智脑基础服务(此类插件不涉及智慧公文写作,无需大模型) | 方案一无算力服务器配置 |
| 智文中枢、AI文枢智写版 | 方寸智脑基础服务+大模型算力(此类插件涉及智慧公文写作,需要大模型)+ 问办通服务 (opens new window) | 以下方案2选1: 方案二无算力服务器配置+客户自备大模型 方案三含算力服务器配置+方寸部署大模型 |
注:
- 智文中枢、AI文枢智写版场景下,除了部署方寸智脑基础服务、准备大模型之外,还需要部署 问办通服务 (opens new window) (资源充足的前提下理论可以部署在CoMi服务器上)
方案一无算力服务器配置:
本方案适用于:购买方寸 智文助手/智文引擎/AI文枢标准版 任意插件场景,此类插件不涉及大模型算力,提供无算力服务器资源即可:
- 客户CPU型号可能与推荐不同,确保规格与推荐接近或更优
- 客户使用 智文助手、智文引擎或AI文枢标准版 插件不涉及大模型,此场景无需准备大模型算力

如项目无需本地化算力部署,最低配置如下:
| 类型 | 最低服务器硬件配置 | 参考CPU | 数量 | 并发数 | 用途 | 备注 |
|---|---|---|---|---|---|---|
| 最低配置 | CPU>=32核心 内存:128G 硬盘:500G SSD | intel xeon 6530* 1 | 1台 | 5 | 前端 + 网关 + 数据库 + 基础算法服务 | 原则5并发方寸需要256G内存+1T固态硬盘,若项目无需算力,最低配置可以降低到128G内存+500G SSD硬盘(硬盘强烈建议1T以上) |
方案二无算力服务器配置+客户自备大模型:
本方案适用于:购买方寸 智文中枢或AI文枢智写版 + 客户自备大模型 场景,此类插件依赖大模型AI算力,如客户已经自备方寸所需大模型,提供无算力服务器资源:
- 客户CPU型号可能与推荐不同,确保规格与推荐接近或更优
- 当前配置不含GPU算力,如客户使用 智文中枢或AI文枢智写版 需要自备大模型算力
- 方寸要求提供三款模型(缺一不可):qwen3.6-27b(语言模型)、bge-reranker-v2-m3(重排序模型)、qwen3_emebeddng_0.6b(文本向量模型),其它模型需联系方寸评估是否适配

如项目无需本地化算力部署,最低配置如下:
| 类型 | 最低服务器硬件配置 | 参考CPU | 数量 | 并发数 | 用途 | 备注 |
|---|---|---|---|---|---|---|
| 最低配置 | CPU>=32核心 内存:128G 硬盘:500G SSD | intel xeon 6530* 1 | 1台 | 5 | 前端 + 网关 + 数据库 + 基础算法服务 | 原则5并发方寸需要256G内存+1T固态硬盘,若项目无需算力,最低配置可以降低到128G内存+500G SSD硬盘(硬盘强烈建议1T以上) |
方案三含算力服务器配置+方寸部署大模型:
本方案适用于:购买方寸 智文中枢或AI文枢智写版 + 客户无大模型 场景,此类插件依赖大模型AI算力,需按要求提供带算力服务器资源:
- 客户CPU型号可能与推荐不同,确保规格与推荐接近或更优
- 服务器供方寸独享:部署方寸基础服务 和 三个大模型 qwen3.6-27b、bge-reranker-v2-m3、qwen3_emebeddng_0.6b
- 如客户GPU型号与推荐不同且需要方寸部署模型,需提前联系方寸评估是否支持
- 部署大模型或方案咨询,请发起《项目交付作业单》备注详细诉求,由方寸评估并提供部署方案

# 信创国产化替代
方寸智脑提供开源合规的安装包,如客户有国产化替代需求,需自购国产中间件进行替代,方寸智脑支持国产化替代产品如下:
- 如项目涉及国产化替代,请发起《项目交付作业单》备注详细诉求,由方寸评估并提供部署方案
| 维度 | 内置中间件 | 国产化替代中间件 | 套数 |
|---|---|---|---|
| 中间件 | Tomcat | 东方通 金蝶 宝兰德 中创 (微服务嵌入式) | 5套 |
| 数据库 | MySQL | 达梦 人大金仓 | 1套,建议主从 |
方寸使用到的其它开源组件主要包含elasticsearch、redis、minio、nginx、python 暂无国产化替代项目
# 复杂部署交付&定制开发需求
如项目涉及复杂环境部署交付、定制开发需求,需通过公司流程发起《项目交付作业单》,由方寸专业承接(实施费用会抵扣项目成本),支持内容含:
- 集群高可用需求方案和部署
- 涉密专用机、特殊架构芯片适配方案和部署
- 本地算力大模型部署
- 信创中间件、信创数据库、非标大模型定制、特定版本开源组件定制 支持
- 方寸产品定制开发需求
# 正式安装
部署方寸智脑前,需先部署智慧公文,参考手册:方寸智慧公文私有化部署手册 (opens new window)
提示:本文中提及的标品即指的智慧公文(OA V10.0SP1及更早版本对接的)
# 方寸智脑部署包
- 智脑data和images下载地址 http://118.186.244.220:39180/download/0428images/workbench-zhiyuan-data-x86-0428--260930.zip?token=3YiZ68v6ph2QO1elBNk3jGyHo728eTpqstHVoX2eAhc
http://118.186.244.220:39180/download/0428images/workbench-zhiyuan-images-x86-0428-260930.tar.gz?token=3YiZ68v6ph2QO1elBNk3jGyHo728eTpqstHVoX2eAhc
- 智脑文档底座下载地址 http://118.186.244.220:39180/download/0428images/docsserver-x86-260428-20260707.tar.gz?token=3YiZ68v6ph2QO1elBNk3jGyHo728eTpqstHVoX2eAhc
http://118.186.244.220:39180/download/0428images/deploy-docsserver.sh?token=3YiZ68v6ph2QO1elBNk3jGyHo728eTpqstHVoX2eAhc
- node下载地址 链接:https://bj15513.apps.aliyunfile.com/disk/s/4goPbEUxGPb?pwd=374288&domainId=bj15513 密码:374288
# 环境准备
1、新建目录
mkdir -p /opt/funcun/fczn/
2、将部署包上传到 /opt/funcun/fczn/ 目录下
- docsserver-x86-260428-20260707.tar.gz
- deploy-docsserver.sh
- workbench-zhiyuan-data-x86-0428--260930.zip
- workbench-zhiyuan-images-x86-0428-260930.tar.gz
- x86-nodejs-v20.19.5.zip
# 文档底座docsserver部署
cd /opt/funcun/fczn/
bash deploy-docsserver.sh
执行脚本过程,镜像导入完成后,会让填写服务器IP地址(按实际网卡IP填写即可),如图

随后部署完成

# 工作台workbench部署
# 解压并导入镜像
cd /opt/funcun/fczn/
# 解压镜像包
tar -zxf workbench-zhiyuan-images-x86-0428-260930.tar.gz
# 导入镜像
cd /opt/funcun/fczn/workbench-images-x86-0428
bash import_images.sh
# 解压代码包
cd /opt/funcun/fczn/
unzip workbench-zhiyuan-data-x86-0428--260930.zip
# 编辑配置文件
# 代理智慧公文
cd /opt/funcun/fczn/workbench
vim workbench-front/conf/workbench.conf.template
# 新增以下内容,IP和端口改成智慧公文crm地址(即智慧公文服务器的IP和crm的端口),加到箭头指的位置
location = /fczn/api {
proxy_pass http://192.168.0.153:18501/;
}
location ^~ /fczn/api/ {
proxy_pass http://192.168.0.153:18501/;
}

cd /opt/funcun/fczn/workbench
# 修改docker compose配置,找 workbench-java 部分
vim compose.yaml
# 把以下地址替换成智慧公文的IP:18501,当前即 192.168.0.153:18501
- FUNCUN_FILE_ELEMENT_EXTRACT_EXTRACT_ARTICLE_URL=http://换成标品公文要素的nginx代理地址/unformatted_file/extract_article
- FUNCUN_FILE_ELEMENT_EXTRACT_URL=http://换成标品公文要素的nginx代理地址/unformatted_file/extract

# 生成配置文件
1、获取机器码
cat /sys/class/dmi/id/product_uuid
将获取到机器码发给商务,申请智脑授权码
2、修改部署配置
编辑 deploy_external.conf 文件,根据实际环境修改外部服务地址:
cd /opt/funcun/fczn/workbench
vim deploy_external.conf
配置文件修改内容如下
# 智慧公文的IP
bp_ip=192.168.0.153
# 智脑文档底座服务IP
docs_ip=192.168.0.153
# 智脑工作台部署服务器ip
zn_ip=192.168.0.153
#############################模型服务配置############################
# 如果有用模型,按实际地址修改
WRITER_MODEL_NAME=qwen3-32b
WRITER_MODEL_URL=http://127.0.0.1:8000/v1
WRITER_MODEL_KEY=sk-f6s8h3ud73hd832hfd823j48fd8
WRITER_ENABLE_THINKING=true
JSON_MODEL_NAME=qwen3-32b
JSON_MODEL_URL=http://127.0.0.1:8000/v1
JSON_MODEL_KEY=sk-f6s8h3ud73hd832hfd823j48fd8
JSON_ENABLE_THINKING=false
TOOL_MODEL_NAME=qwen3-32b
TOOL_MODEL_URL=http://127.0.0.1:8000/v1
TOOL_MODEL_KEY=sk-f6s8h3ud73hd832hfd823j48fd8
TOOL_ENABLE_THINKING=false
# rerank 模型
RERANK_MODEL=bge-reranker-v2-m3
RERANK_BASE_URL=http://127.0.0.1:8000/v1/rerank
RERANK_API_KEY=sk-f6s8h3ud73hd832hfd823j48fd8
# embedding 模型
EMBEDDING_MODEL=qwen3_embedding
EMBEDDING_BASE_URL=http://127.0.0.1:8000/v1
EMBEDDING_API_KEY=sk-f6s8h3ud73hd832hfd823j48fd8
#############################智脑服务配置############################
# 算法模块服务地址 (Nginx)
sf_nginx=http://192.168.0.153:12100
# workbench-server服务中授权配置,填写上一步申请的授权码
LICENSE_KEY=license_key


3、生成配置文件
运行配置生成脚本:
cd /opt/funcun/fczn/workbench
chmod +x generate_configs.sh
./generate_configs.sh

4、配置文件加密
以后修改taiji服务配置文件后都要执行对应加密脚本才能生效
cd /opt/funcun/fczn
unzip x86-nodejs-v20.19.5.zip
# 安装nodejs
cd /opt/funcun/fczn/x86-nodejs-v20.19.5
sudo bash install-node20-binary.sh --offline
# 更新当前bash会话,刷新环境变量
exec bash -l
# 检查node版本,版本大于等于16时即可
node -v
# 配置文件加密
cd /opt/funcun/fczn/workbench/taiji
bash encrypt-taiji-env.sh
# 启动工作台
docker-compose up -d
提示:
日常运维操作,配置文件加密
当修改完箭头指的配置文件后,需要执行目录下的加密脚本,修改的配置才能生效,上述所诉适用于taiji服务。

5、修改智慧公文(老标品)审校服务回调地址
# 获取审校服务配置文件路径
docker inspect fc-integration-word |grep So
"Source": "/data/funcun/deploy/integration",
cd /opt/funcun/deploy/integration
vim config.test
# 将192.168.0.153:18501 改为调用crm-proofread服务,只更改ip端口
# crm-proofread 通过命令:docker ps |grep crm-proofread 查看,默认28077端口,修改如下
file_to_text_url: http://192.168.0.153:28077/open-api/extractFileText
request_mysql_url: http://192.168.0.153:28077/syncWordsProvider/getWordList
# 重启服务
docker restart fc-integration-fixed fc-integration-pol fc-integration-law fc-integration-word fc-integration-sync fc-integration-llm
# 智慧公文更新
请参考《方寸智慧公文私有化部署手册 (opens new window)》中的 智慧公文更新 章节
# 登录方寸智脑
http://ip:10600
账号:admin
密码:Admin@123456, arm架构为admin@123
快速跳转