JeecgBoot低代码平台 Docker 部署 OnlyOffice 文档服务完整指南

JeecgBoot AI专题研究 | JeecgBoot低代码在线文档编辑环境搭建实录


为什么选择 OnlyOffice?

在线文档编辑是 JeecgBoot低代码平台的重要办公协作功能之一。OnlyOffice DocumentServer 提供了 Word、Excel、PowerPoint 三大格式的在线编辑能力,且支持 Docker 容器化部署,与 JeecgBoot低代码项目的集成非常便捷。

本文将从 Docker 镜像拉取到服务配置,手把手完成 OnlyOffice 的部署。

版本选择

OnlyOffice 提供两个版本的 Docker 镜像:

版本 镜像地址 并发限制 适用场景
免费版 onlyoffice/documentserver 20 用户 小型团队、开发测试
开发者版 onlyoffice/documentserver-de 30 天试用 正式项目评估、定制化需求

拉取镜像命令:

bash 复制代码
# 免费版
docker pull onlyoffice/documentserver

# 开发者版
docker pull onlyoffice/documentserver-de

对于 JeecgBoot低代码项目的日常开发和小规模团队使用,免费版已经足够。

启动服务

使用以下命令创建并启动 OnlyOffice 容器:

bash 复制代码
docker run -i -t -d -p 9000:80 --name=onlyoffice --privileged=true --restart=always -e JWT_ENABLED=false onlyoffice/documentserver

参数说明:

  • -p 9000:80 --- 将容器的 80 端口映射到宿主机的 9000 端口
  • --privileged=true --- 赋予容器特权模式(OnlyOffice 内部服务需要)
  • --restart=always --- 容器异常退出后自动重启
  • -e JWT_ENABLED=false --- 关闭 JWT 认证(开发环境简化配置)

生产环境建议开启 JWT 认证,配置 JWT_SECRET 环境变量以增强安全性。

关键配置:启用内网 IP 访问

默认情况下,OnlyOffice 出于安全考虑会拒绝私有 IP 地址的回调请求。在 JeecgBoot低代码的内网部署环境中,必须手动开启此权限:

1. 进入容器

bash 复制代码
docker exec -it onlyoffice bash

2. 编辑配置文件

bash 复制代码
vi /etc/onlyoffice/documentserver/default.json

3. 修改以下两项为 true

json 复制代码
{
  "services": {
    "CoAuthoring": {
      "request-filtering-agent": {
        "allowPrivateIPAddress": true,
        "allowMetaIPAddress": true
      }
    }
  }
}

4. 重启容器使配置生效

bash 复制代码
docker restart onlyoffice
常见问题排查

文档保存报错

这是最高频的问题之一。如果在编辑文档后保存时出现错误,通常是因为 JeecgBoot低代码后端的回调地址使用了 localhost 或 127.0.0.1。OnlyOffice 容器内部无法通过这些地址访问到宿主机的服务。

解决方案 :将所有配置中的 localhost 替换为宿主机的实际 IP 地址,例如 192.168.1.100。

服务无法访问

启动容器后,在浏览器中访问 http://服务器IP:9000 验证 OnlyOffice 是否正常运行。如果页面无法加载,检查防火墙规则和 Docker 端口映射是否正确。


总结

OnlyOffice 的 Docker 部署流程本身并不复杂,但内网 IP 访问权限配置和地址设置是容易踩坑的环节。完成本文的配置后,你的 JeecgBoot低代码平台就具备了完整的在线文档编辑能力,可以满足日常办公协作的需求。


本文为 JeecgBoot AI 专题研究系列文章。

相关推荐
AR-26710-3 小时前
docker Day2——镜像 / 容器 / 仓库
运维·docker·容器
好用斋4 小时前
拾光坞G2使用新版Docker懒人包:一键安装、一键升级、一键卸载
java·docker·容器
csdn_aspnet5 小时前
生产环境中 SQL Server 的 Docker 使用建议
运维·microsoft·docker·容器·sqlserver
csdn_aspnet6 小时前
如何在 Docker 上安装 SQL Server
运维·microsoft·docker·容器·sqlserver
csdn_aspnet20 小时前
在 Docker 容器中本地运行 SQL Server
运维·docker·容器·sqlserver
java资料站1 天前
MongoDB 3节点副本集( Docker )
mongodb·docker·eureka
星落梦生1 天前
Docker学习(11)
学习·docker·容器
万里侯1 天前
日志聚类之后别把 noise 扔掉:降噪应该改变视图,不抹掉证据
人工智能·微服务·ai·容器·k8s
byte轻骑兵2 天前
如何为你的 Web 应用添加文档编辑能力:ONLYOFFICE 文档集成实战
docker·私有化部署·系统集成·在线协作·wsl2·onlyoffice docs