# 方寸智脑私有化部署手册(适用V11.0版本)

# 关于方寸智脑

方寸智脑是方寸的新一代智慧公文产品,自协同V5 V11.0版本开始标准集成方寸智脑,而V5早期版本集成方寸智慧公文。

# 安装前准备

# 适用协同版本

方寸智脑服务支持的协同版本如下:

  • V8新一代云原生微服务平台支持:当前暂无版本支持。
  • V5产品支持:V11.0版本开始标准支持方寸智脑平台。V5集成方寸智脑所需插件和能力详见 《智能公文指导手册 (opens new window)》 - V11.0版本方寸文会事套件场景 部分。

1787478762541.png

# 环境部署要求

# 操作系统

  • 非信创: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文枢标准版 插件不涉及大模型,此场景无需准备大模型算力

1787586860487.png

如项目无需本地化算力部署,最低配置如下:

类型 最低服务器硬件配置 参考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(文本向量模型),其它模型需联系方寸评估是否适配

1787586897727.png

如项目无需本地化算力部署,最低配置如下:

类型 最低服务器硬件配置 参考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型号与推荐不同且需要方寸部署模型,需提前联系方寸评估是否支持
  • 部署大模型或方案咨询,请发起《项目交付作业单》备注详细诉求,由方寸评估并提供部署方案

1787586940089.png

# 信创国产化替代

方寸智脑提供开源合规的安装包,如客户有国产化替代需求,需自购国产中间件进行替代,方寸智脑支持国产化替代产品如下:

  • 如项目涉及国产化替代,请发起《项目交付作业单》备注详细诉求,由方寸评估并提供部署方案
维度 内置中间件 国产化替代中间件 套数
中间件 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填写即可),如图

1792114982433.png

随后部署完成

1792115070823.png

# 工作台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/;
}

1792116581045.png

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

1792117062408.png

# 生成配置文件

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

1792118253792.png

1792118578784.png

3、生成配置文件

运行配置生成脚本:

cd /opt/funcun/fczn/workbench
chmod +x generate_configs.sh
./generate_configs.sh

1792118706613.png

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服务。

1792119257370.png

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
编撰人:het、wangyxyf