运维文档

# 方寸智脑私有化部署手册（适用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

方案二无算力服务器配置+客户自备大模型：

本方案适用于：购买方寸 智文中枢或AI文枢智写版 + 客户自备大模型 场景，此类插件依赖大模型AI算力，如客户已经自备方寸所需大模型，提供无算力服务器资源：

  • 客户CPU型号可能与推荐不同，确保规格与推荐接近或更优
  • 当前配置不含GPU算力，如客户使用 智文中枢或AI文枢智写版 需要自备大模型算力
  • 方寸要求提供三款模型（缺一不可）：qwen3.6-27b（语言模型）、bge-reranker-v2-m3（重排序模型）、qwen3_emebeddng_0.6b（文本向量模型），其它模型需联系方寸评估是否适配

1787586897727.png

方案三含算力服务器配置+方寸部署大模型：

本方案适用于：购买方寸 智文中枢或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 暂无国产化替代项目

# 复杂部署交付&定制开发需求

如项目涉及复杂环境部署交付、定制开发需求，需通过公司流程发起《项目交付作业单》，由方寸专业承接（实施费用会抵扣项目成本），支持内容含：

  • 集群高可用需求方案和部署
  • 涉密专用机、特殊架构芯片适配方案和部署
  • 本地算力大模型部署
  • 信创中间件、信创数据库、非标大模型定制、特定版本开源组件定制 支持
  • 方寸产品定制开发需求

# 正式安装

# K3s部署

# 方寸部署

# 部署包准备

镜像下载地址

  • 方寸标品镜像包（v5.6版本） 链接：https://bj15513.apps.aliyunfile.com/disk/s/SFtuGaRWGt2?pwd=730083&domainId=bj15513 密码：730083

  • 致远定制检索镜像： 链接：https://bj15513.apps.aliyunfile.com/disk/s/rDBMxNAmR8a?pwd=621363&domainId=bj15513 密码：621363

代码包下载地址

  • yaml部署文件包： 链接：https://bj15513.apps.aliyunfile.com/disk/s/YHMqjB7YccW?pwd=600764&domainId=bj15513 密码：600764

  • 方寸标品代码包 链接：https://bj15513.apps.aliyunfile.com/disk/s/iJPg3cN7yxL?pwd=871936&domainId=bj15513 密码：871936

  • 致远定制检索代码包： 链接：https://bj15513.apps.aliyunfile.com/disk/s/AvrDS1hytoG?pwd=961795&domainId=bj15513 密码：961795

  • 方寸智脑代码包： 链接：https://bj15513.apps.aliyunfile.com/disk/s/QpUw185gFGG?pwd=532567&domainId=bj15513 密码：532567

部署包分类

将以上所有下载链接的包都下载并上传到服务器上，这些包主要分3类

  • yaml部署文件
yaml.tar.gz
  • 代码包文件
check_duplicate-2026-07-24.tar.gz
integration-2026-07-24.tar.gz
official_ocr-2026-07-24.tar.gz
slc_online-2026-07-24.tar.gz
workbench-images-x86-0428-2026-07-24.tar.gz
crm-2026-07-24.tar.gz
langchain-2026-07-24.tar.gz
officialsearch-so.amd-2026-08-17.tar.gz
textabstract-2026-07-24.tar.gz
x86-nodejs-v20.19.5-2026-07-24.tar.gz
docsserver-2026-07-24.tar.gz
information-extraction-2026-07-24.tar.gz
mysql-2026-07-24.tar.gz
officialsearch-so.amd-2026-08-24.tar.gz
text_contrast-2026-07-24.tar.gz
yaml.tar.gz
nginx-2026-07-24.tar.gz
rerankerservice-2026-07-24.tar.gz
workbench-2026-07-24.tar.gz
  • 镜像文件
ifuncun-crm-amd.tar
ifuncun-es813-amd.tar
ifuncun-integration-v5.6-amd.tar
ifuncun-minio-amd.tar
ifuncun-mysql-amd.tar
ifuncun-py3.11-v5.5.amd.tar
ifuncun-python-amd.tar
ifuncun-redis-amd.tar
nginx_1.29.8_amd.tar

部署包整理

# 创建目录
mkdir /opt/funcun/k3s_cs/data/fczn -p
mkdir /opt/funcun/k3s_cs/data/{redis,minio}
chown -R 1000:1000 /opt/funcun/k3s_cs/data/{redis,minio}

# yaml部署文件包解压
tar -zvxf yaml.tar.gz -C /opt/funcun/k3s_cs

# 代码包解压
tar -zvxf check_duplicate-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data
tar -zvxf integration-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data
tar -zvxf official_ocr-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data
tar -zvxf slc_online-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data
tar -zvxf crm-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data
tar -zvxf langchain-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data
tar -zvxf textabstract-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data
tar -zvxf information-extraction-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data
tar -zvxf mysql-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data
tar -zvxf text_contrast-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data
tar -zvxf yaml.tar.gz -C /opt/funcun/k3s_cs/data
tar -zvxf nginx-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data
tar -zvxf rerankerservice-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data

# 先解压 officialsearch-so.amd-2026-08-24.tar.gz ，然后重命名
tar -zvxf officialsearch-so.amd-2026-08-24.tar.gz -C /opt/funcun/k3s_cs/data
mv /opt/funcun/k3s_cs/data/officialsearch /opt/funcun/k3s_cs/data/officialsearch-v8
# 再解压08-17的包
tar -zvxf officialsearch-so.amd-2026-08-17.tar.gz -C /opt/funcun/k3s_cs/data

# 智脑代码包解压，这里是解压到fczn目录下
tar -zvxf docsserver-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data/fczn
tar -zvxf workbench-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data/fczn
tar -zvxf workbench-images-x86-0428-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data/fczn
tar -zvxf x86-nodejs-v20.19.5-2026-07-24.tar.gz -C /opt/funcun/k3s_cs/data/fczn

ES数据分包整理

联系方寸获取es数据分包下载链接

下载81个分包文件，并上传到服务器的单临时目录，比如 /pkg/es813

1790590168073.png

# 下载并上传完成后，进入该目录下进行合并
cd /pkg/es813
cat es_new* > es_new.tar.gz

# 解压并重命名
tar -zvxf es_new.tar.gz
mv es_new /opt/funcun/k3s_cs/data/es813

镜像目录

mkdir /opt/funcun/k3s_cs/imgs

把上文提到的 .tar 镜像文件拷贝到该目录

完整目录结构

# 总目录结构
/opt/funcun/k3s_cs/
├── data
├── yaml
└── imgs

# 以下是子目录结构
# 代码包目录
/opt/funcun/k3s_cs/data
├── check_duplicate
├── crm
├── es813
├── fczn
├── information-extraction
├── integration
├── langchain
├── mysql
├── nginx
├── official_ocr
├── officialsearch
├── officialsearch-v8
├── rerankerservice
├── slc_online
├── textabstract
└── text_contrast

/opt/funcun/k3s_cs/data/fczn
├── docsserver
├── workbench
├── workbench-images-x86-0428
└── x86-nodejs-v20.19.5

# yaml文件目录
/opt/funcun/k3s_cs/yaml
├── check-duplicate.yaml
├── fczn
├── integration-law.yaml
├── integration-sync.yaml
├── minio.yaml
├── nginx.yaml
├── officialsearch.yaml
├── rerankerservice.yaml
├── text-contrast.yaml
├── crm.yaml
├── information-extraction.yaml
├── integration-llm.yaml
├── integration-word.yaml
├── mysql.yaml
├── official_ocr.yaml
├── pv_pvc.yaml
├── slc_cpu.yaml
├── es813.yaml
├── integration-fixed.yaml
├── integration-pol.yaml
├── langchain.yaml
├── namespace_config.yaml
├── officialsearch-v8.yaml
├── redis.yaml
└── textabstract.yaml

# 智脑部署部分，需要依照依赖次序进行部署
/opt/funcun/k3s_cs/yaml/fczn
├── Account_Sync_Engine.yaml
├── Account_Sync_Server.yaml
├── Docs_Server.yaml
├── Elasticsearch.yaml
├── File_Store_Center.yaml
├── Kafka.yaml
├── MinIO.yaml
├── nginx-docs.yaml
├── Nuts_Compact_Service_Account_Sync.yaml
├── Nuts_Compact_Service.yaml
├── officeWeb.yaml
└── workbench
    ├── chart_mcp.yaml
    ├── chunk.yaml
    ├── crm_gateway.yaml
    ├── crm_proofread.yaml
    ├── crm_retrieval.yaml
    ├── crm_system.yaml
    ├── fc_langchain_agent.yaml
    ├── fc_mcp.yaml
    ├── ingest_worker.yaml
    ├── memory.yaml
    ├── minio.yaml
    ├── playwright_mcp.yaml
    ├── postgres.yaml
    ├── prompt_server.yaml
    ├── rag_document_parser.yaml
    ├── ragflow.yaml
    ├── searxng.yaml
    ├── taiji_server.yaml
    ├── taste_api.yaml
    ├── upload_pvc.yaml
    ├── workbench_front.yaml
    ├── workbench_java.yaml
    ├── workbench_mariadb.yaml
    ├── workbench_redis.yaml
    └── workbench_server.yaml

# 镜像
/opt/funcun/k3s_cs/imgs
├── ifuncun-crm-amd.tar
├── ifuncun-es813-amd.tar
├── ifuncun-integration-v5.6-amd.tar
├── ifuncun-minio-amd.tar
├── ifuncun-mysql-amd.tar
├── ifuncun-py3.11-v5.5.amd.tar
├── ifuncun-python-amd.tar
├── ifuncun-redis-amd.tar
└── nginx_1.29.8_amd.tar

# 导入镜像

cd /opt/funcun/k3s_cs/imgs
k3s ctr i import ifuncun-crm-amd.tar
k3s ctr i import ifuncun-es813-amd.tar
k3s ctr i import ifuncun-integration-v5.6-amd.tar
k3s ctr i import ifuncun-minio-amd.tar
k3s ctr i import ifuncun-mysql-amd.tar
k3s ctr i import ifuncun-py3.11-v5.5.amd.tar
k3s ctr i import ifuncun-python-amd.tar
k3s ctr i import ifuncun-redis-amd.tar
k3s ctr i import nginx_1.29.8_amd.tar

# 部署应用

首先切换目录，cd /opt/funcun/k3s_cs/yaml，再按顺序执行以下命令

  • 1、创建namespace和configmap（配置可编辑修改）
kubectl apply -f namespace_config.yaml

# 查看ns
kubectl get ns funcun
# 查看configmap
kubectl -n funcun get cm dify-shared-config-fc
  • 2、创建存储卷
# 执行前请按根据实际环境修改 pv_pvc.yaml，见下图
kubectl apply -f pv_pvc.yaml

# 查看pv
kubectl -n funcun get pv
# 查看pvc
kubectl -n funcun get pvc

1790737496212.png

1790737540046.png

  • 2、部署基础服务
kubectl apply -f check-duplicate.yaml
kubectl apply -f crm.yaml
kubectl apply -f es813.yaml
kubectl apply -f information-extraction.yaml
kubectl apply -f integration-fixed.yaml
kubectl apply -f integration-law.yaml
kubectl apply -f integration-llm.yaml
kubectl apply -f integration-pol.yaml
kubectl apply -f integration-sync.yaml
kubectl apply -f integration-word.yaml
kubectl apply -f langchain.yaml
kubectl apply -f minio.yaml
kubectl apply -f mysql.yaml
kubectl apply -f nginx.yaml
kubectl apply -f official_ocr.yaml
kubectl apply -f officialsearch-v8.yaml
kubectl apply -f officialsearch.yaml
kubectl apply -f redis.yaml
kubectl apply -f rerankerservice.yaml
kubectl apply -f slc_cpu.yaml
kubectl apply -f textabstract.yaml
kubectl apply -f text-contrast.yaml
编撰人：het、wangyxyf

快速跳转

← 系统监控分析 →