ONLYOFFICE Docker部署中editor.bin加载失败的解决方案

在使用Docker部署ONLYOFFICE DocumentServer时，经常会遇到editor.bin文件加载失败的问题。这种情况通常出现在通过Nginx反向代理访问ONLYOFFICE服务时，本文将深入分析问题原因并提供完整的解决方案。

问题现象

当用户通过Nginx反向代理访问ONLYOFFICE服务时，浏览器控制台会出现类似"editor.bin下载失败"的错误。具体表现为：

1. 主服务通过代理访问正常（如访问/oo路径）
2. 但静态资源请求仍直接访问原始端口（如8889端口）
3. 导致跨域或资源加载失败

根本原因

这个问题的核心在于ONLYOFFICE DocumentServer的配置没有正确识别反向代理设置。默认情况下，服务会基于原始请求生成资源URL，当存在反向代理时，这些URL会指向错误的地址。

完整解决方案

1. 正确配置Nginx反向代理

在Nginx配置中，需要确保所有相关路径都被正确代理：

location /oo/ {
    proxy_pass http://127.0.0.1:8889/;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

2. 修改DocumentServer配置

在Docker环境中，需要通过环境变量设置正确的服务地址：

docker run -d -p 8889:80 \
    -e DOCSERVICES_PORT=8889 \
    -e DOCSERVICES_HOST=yourdomain.com \
    -e DOCSERVICES_PROTOCOL=http \
    onlyoffice/documentserver

3. 配置前端集成参数

在集成ONLYOFFICE的前端代码中，需要设置正确的文档服务地址：

var docEditor = new DocsAPI.DocEditor("placeholder", {
    "document": {
        "fileType": "docx",
        "key": "key",
        "title": "document.docx",
        "url": "http://yourdomain.com/oo/document.docx"
    },
    "editorConfig": {
        "callbackUrl": "http://yourdomain.com/oo/callback"
    }
});

进阶配置建议

1. HTTPS支持：如果使用HTTPS，需要额外配置SSL证书并设置DOCSERVICES_PROTOCOL为https

2. 路径重写：对于复杂的代理路径，可能需要使用Nginx的rewrite规则

3. 缓存配置：适当配置静态资源缓存可提高性能

4. 健康检查：配置Nginx对后端服务的健康检查，确保服务可用性

验证方法

部署完成后，可通过以下步骤验证配置是否正确：

1. 打开浏览器开发者工具
2. 检查所有资源请求是否都通过代理路径
3. 确认没有跨域错误
4. 测试文档的完整编辑功能

通过以上配置，可以彻底解决ONLYOFFICE在Docker部署中遇到的editor.bin加载失败问题，确保文档编辑服务正常工作。