Docker部署OnlyOffice社区版，文档保存失败踩坑记录

确认 ds:example 已运行后再打开管理面板新建一个 Word 文档，保存时就弹出了开头的错误。

docker logs onlyoffice-docs 刷出的日志里反复出现私有 IP 被拒绝的记录。这个报错意味着保存请求根本没有发出去，在网关层就被拦下来了。

根源：私有 IP 回调默认被禁止

OnlyOffice 为了防止服务端被恶意利用，在 CoAuthoring 请求过滤组件中默认拦截所有指向私有 IP、回环地址的请求。测试用例的文档状态回调刚好命中了这条策略，直接导致了保存失败。这个设计在文档里提得比较隐晦，很容易踩坑。

解决：允许私有 IP 回调

OnlyOffice 的精简镜像没有预装 vim，有两种方式修改配置。

直接装 vim 手动改

docker exec -it onlyoffice-docs bash
apt update && apt install -y vim
vim /etc/onlyoffice/documentserver/default.json

找到 services.CoAuthoring 下的 request-filtering-agent，添加（或修改）以下内容：

"request-filtering-agent": {
  "allowPrivateIPAddress": true,
  "allowMetaIPAddress": true
},

保存退出后，重启容器：docker-compose restart。

一行命令 sed 直接改

如果不想装 vim，也可以直接 sed 修改配置文件，例如：

docker exec onlyoffice-docs sed -i '/"request-filtering-agent"/{n;s/"allowPrivateIPAddress": false/"allowPrivateIPAddress": true/}' /etc/onlyoffice/documentserver/default.json

具体 sed 表达式需要根据文件中实际结构微调，建议先确认当前内容再操作。

修改并重启后，再次打开 http://你的服务器IP:19898/example 新建文档，保存不会再弹错误。

几个容易忽略的点

• 测试示例仅用于验证：Demo 级的 ds:example 绝不能放生产环境，验证完应立刻关掉（docker exec onlyoffice-docs supervisorctl stop ds:example）。
• 安全配置要跟上：生产环境务必开启 JWT 验证，将 JWT_ENABLED 设为 true 并配置密钥，同时建议关闭 allowPrivateIPAddress，改用白名单精准控制回调地址。
• 镜像选择：只认准 onlyoffice/documentserver 官方镜像，第三方镜像容易出现兼容性问题。

遇到同类问题的同学，往往都是先排查网络、配置，最后才翻到这个安全限制，绕了不少弯路。记录下来，给后续部署省点时间。