开源低代码档案系统与客户关系管理CRM集成三步核心可复制实操

前置准备

先明确本次选择的开源免费、无额外授权的工具，解决卡壳的第一门槛：

• 档案系统：OnlyOffice Docs Community Server v12.1.1（直接下载地址：https://github.com/ONLYOFFICE/DocumentServer/releases/tag/v12.1.1）
• CRM系统：SuiteCRM v8.4.0（直接下载地址：https://github.com/salesagility/SuiteCRM/releases/tag/v8.4.0）
• 服务器：至少2核4G云服务器，预装Ubuntu 22.04 LTS
• 工具集：提前安装Docker Compose v2.20.0（执行以下2条命令即可）

 第一步：下载Docker Compose二进制文件
sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
第二步：赋予执行权限
sudo chmod +x /usr/local/bin/docker-compose

第一步：分别部署两个系统到同一Docker网络

1.1 创建专属Docker网络

避免跨网络访问失败，必须创建固定网络名的桥接网络：

sudo docker network create crm-archive-net

1.2 部署OnlyOffice Community Server

创建onlyoffice-compose.yml配置文件，复制以下完整内容：

version: '3.8'
services:
onlyoffice-document-server:
container_name: onlyoffice-crm-archive
image: onlyoffice/documentserver:12.1.1
restart: always
environment:
- JWT_ENABLED=true
- JWT_SECRET=your_custom_jwt_secret_key_123abc
ports:
- "8080:80"
networks:
- crm-archive-net
volumes:
- onlyoffice-logs:/var/log/onlyoffice
- onlyoffice-data:/var/www/onlyoffice/Data
- onlyoffice-lib:/var/lib/onlyoffice
networks:
crm-archive-net:
external: true
volumes:
onlyoffice-logs:
onlyoffice-data:
onlyoffice-lib:

关键配置说明：JWT_SECRET必须设置为强密码，后面CRM配置要用到；external:true表示用刚才创建的专属网络。

启动OnlyOffice：

sudo docker-compose -f onlyoffice-compose.yml up -d

验证部署成功：打开浏览器访问http://你的云服务器公网IP:8080，出现OnlyOffice Docs欢迎页即可。

1.3 部署SuiteCRM

创建suitecrm-compose.yml配置文件，复制以下完整内容：

version: '3.8'
services:
suitecrm:
container_name: suitecrm-main
image: salesagility/suitecrm:8.4.0-apache
restart: always
ports:
- "8081:80"
networks:
- crm-archive-net
volumes:
- suitecrm-config:/var/www/html/public/legacy/config.php
- suitecrm-uploads:/var/www/html/public/legacy/upload
depends_on:
- suitecrm-db
environment:
- DATABASE_HOST=suitecrm-db
- DATABASE_NAME=suitecrm
- DATABASE_USER=suitecrm
- DATABASE_PASSWORD=suitecrm_db_pass_123
- DATABASE_PORT=3306
suitecrm-db:
container_name: suitecrm-db
image: mariadb:10.6
restart: always
networks:
- crm-archive-net
volumes:
- suitecrm-db-data:/var/lib/mysql
environment:
- MYSQL_ROOT_PASSWORD=suitecrm_root_pass_123
- MYSQL_DATABASE=suitecrm
- MYSQL_USER=suitecrm
- MYSQL_PASSWORD=suitecrm_db_pass_123
- MARIADB_AUTO_UPGRADE=1
networks:
crm-archive-net:
external: true
volumes:
suitecrm-config:
suitecrm-uploads:
suitecrm-db-data:

关键配置说明：所有数据库密码必须统一，防止后续登录SuiteCRM后台失败；depends_on确保先启动数据库再启动SuiteCRM。

启动SuiteCRM：

sudo docker-compose -f suitecrm-compose.yml up -d

首次登录SuiteCRM配置：打开浏览器访问http://你的云服务器公网IP:8081，按提示输入管理员用户名admin、刚才设置的数据库密码，5分钟内完成初始化即可。

第二步：SuiteCRM后台配置OnlyOffice集成

2.1 安装OnlyOffice SuiteCRM插件

插件免费开源，直接下载最新适配SuiteCRM v8的版本：https://github.com/ONLYOFFICE/onlyoffice-suitecrm/releases/download/v3.0.0/onlyoffice-suitecrm-3.0.0.zip

登录SuiteCRM后台（admin/刚才设置的管理员密码），按以下步骤操作：

1. 点击左侧导航栏Admin → Module Loader
2. 点击Upload Package，选择刚才下载的onlyoffice-suitecrm-3.0.0.zip，点击Upload
3. 在上传列表找到OnlyOffice Integration，点击Install → 勾选同意协议 → Commit，等待安装完成（约30秒）

2.2 配置OnlyOffice连接参数

回到Admin页面，找到OnlyOffice模块，点击进入OnlyOffice Configuration，按以下表格填写所有必填项：

关键注意：两个内部地址必须用Docker容器名，因为在同一专属网络内；填写完成后点击Save → Test Connection，显示绿色Success即为配置成功。

第三步：验证集成效果并测试核心功能

3.1 测试创建关联客户的档案

1. 点击左侧导航栏Accounts → 点击右上角Create Account
2. 填写必填项Account Name（比如“测试集成客户”），点击Save
3. 进入该客户详情页，找到Documents子模块，点击Create Document
4. 填写必填项Document Name（比如“测试档案.docx”），在Create with OnlyOffice下拉框选择Word Document，点击Save & Edit in OnlyOffice

此时会自动跳转到OnlyOffice编辑器，输入测试内容后点击右上角Save，编辑器会自动关闭并跳回SuiteCRM，详情页Documents子模块会显示刚才创建的文件。

3.2 测试在线编辑已上传的档案

1. 在刚才的客户详情页Documents子模块，点击Upload Document
2. 选择本地任意Word/Excel/PPT文件，点击Save
3. 上传成功后，点击该文件右侧的Edit in OnlyOffice按钮，即可在线编辑并保存。

3.3 关闭不必要的端口（安全优化）

在云服务器安全组中仅开放8081（SuiteCRM外部访问），关闭8080（OnlyOffice外部访问，仅内部网络调用即可），防止恶意攻击。

常见卡壳问题排查

• Test Connection失败：检查JWT_SECRET是否一致、Docker网络是否正确配置为external:true、容器名是否拼写错误
• OnlyOffice编辑器无法打开：检查安全组是否误关8081、SuiteCRM External Address是否填写了正确的公网IP
• 保存文件失败：检查Docker卷是否有足够权限（执行sudo chown -R 33:33 ./suitecrm-uploads/ 修复）