邦成为寄卖连锁1. 为什么选择OnlyOffice与JeecgBoot集成
在低代码开发领域，文档协作功能已经成为企业级应用的标配需求。作为国内领先的低代码平台，JeecgBoot需要一套稳定可靠的在线文档解决方案来满足用户的日常办公需求。经过多轮技术评估，OnlyOffice DocumentServer凭借以下核心优势成为我们的首选：
格式兼容性实测表现：在压力测试中，OnlyOffice对MS Office文档（特别是复杂的PPT动画和Excel公式）的渲染准确率达到98%，远超同类开源方案。我们曾用一份包含VBA宏的.xlsm文件测试，OnlyOffice是少数能正确识别并警告宏存在的方案。
Docker化部署的天然优势：与JeecgBoot的微服务架构完美契合。通过容器化部署，我们可以实现：
- 资源隔离：文档服务不影响主应用性能
- 版本控制：镜像tag明确，回滚方便
- 横向扩展：通过k8s轻松实现多实例负载均衡
实际部署中的性能数据：在4核8G的测试机上，单个OnlyOffice容器可稳定支持15人同时编辑不同文档。当启用文档历史版本功能时，内存占用会增加约20%，这是需要特别注意的。
重要提示：生产环境务必选择x86_64架构服务器。我们在ARM平台（如树莓派）上测试时，发现字体渲染会出现错位，这是libreoffice底层兼容性问题导致的。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 部署前的关键准备工作
2.1 硬件资源规划建议
根据我们的部署经验，不同规模团队推荐配置如下：
| 团队规模 | CPU核心 | 内存 | 磁盘类型 | 预计支持并发 |
|---|---|---|---|---|
| 5人以下 | 2核 | 4GB | SSD | 5-8文档 |
| 20人团队 | 4核 | 8GB | NVMe | 15-20文档 |
| 50人以上 | 8核+ | 16GB+ | RAID10 | 需集群部署 |
磁盘IO的隐藏坑：当多人同时编辑大型PPT时，临时文件写入会暴发式增长。我们曾遇到服务器卡死，最终发现是机械硬盘IOPS不足导致的。强烈建议使用SSD并预留20%的冗余空间。
2.2 网络拓扑注意事项
典型的JeecgBoot+OnlyOffice架构中，需要特别注意这些网络关系：
code复制[浏览器]
↓ HTTPS
[JeecgBoot Nginx]
↓ HTTP 反向代理
[OnlyOffice容器:9000]
↑↓ WebSocket
[用户浏览器]
必须开放的端口：
- 9000/tcp（文档服务主端口）
- 9876/tcp（OnlyOffice内部通信端口）
- 443/tcp（如果走HTTPS直连）
我们在某次客户部署中，因为漏开9876端口导致协作光标位置不同步，这个坑足足排查了3小时。
2.3 镜像版本选择策略
OnlyOffice官方提供多个镜像变体，我们的实测结论：
- 常规选择：
onlyoffice/documentserver:7.1.1（指定版本号，避免自动升级导致兼容性问题） - 中文优化：
onlyoffice/documentserver:7.1.1-zh（含思源宋体等中文字体） - 开发测试：
onlyoffice/documentserver-de（可试用高级功能，但30天后会禁用保存功能）
血泪教训：曾因使用latest标签导致自动升级到7.2版本，结果与JeecgBoot的插件接口不兼容。现在坚持所有生产环境锁定具体版本号。
3. 步步为营的部署实操
3.1 拉取镜像的加速技巧
直接docker pull可能会非常慢，建议先配置国内镜像源：
bash复制# 创建或修改daemon.json
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": [
"https://docker.mirrors.ustc.edu.cn",
"https://hub-mirror.c.163.com"
]
}
EOF
# 重启docker服务
sudo systemctl restart docker
# 拉取镜像（示例使用清华源）
docker pull registry.docker-cn.com/onlyoffice/documentserver:7.1.1
验证镜像完整性：
bash复制docker inspect --format='{{.RepoDigests}}' onlyoffice/documentserver:7.1.1
正确的输出应包含sha256摘要值，若为<none>则表示镜像可能被篡改。
3.2 启动容器的黄金参数
这是经过20+次实战验证的最佳启动命令：
bash复制docker run -d --name onlyoffice \
--restart=unless-stopped \