OnlyOffice 打开文档时提示下载失败

OnlyOffice 下载失败问题

问题概述

OnlyOffice前端界面出现"下载失败"

问题定位(0:docker内不能够访问)

很常见的一种情况是后端服务地址错误,在docker内无法访问。

请在docker容器中确定这个地址是可以访问的,鉴权是通过的。

bash 复制代码
docker exec -it onlyoffice /bin/bash
curl 后端服务下载文件的地址

问题定位(1:使用内部ip地址访问后端服务)

查看OnlyOffice Converter的日志文件(docker中对应位置/var/log/onlyoffice/logs/documentserver/converter/out.log​

如果发现日志文件中存在

bash 复制代码
Error: DNS lookup xxx.xxx.xxx.xx(family:undefined, host:undefined) is not allowed. Because, It is private IP address.

那么需要编辑配置文件允许私有ip通过:

编辑docker中/etc/onlyoffice/documentserver/default.json​下的内容

搜索并修改以下字段为true

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

也可以将文件复制出来再进行编辑

bash 复制代码
docker cp onlyoffice:/etc/onlyoffice/documentserver/default.json ./
vim default.json

docker cp ./default.json onlyoffice:/etc/onlyoffice/documentserver/default.json

更改后,需要重启容器;

问题定位(2:检查前端请求)

一种情况是Editor.bin​文件无法下载,如果正使用nginx proxy_pass​到onlyoffice服务,请检查转发时是否正确转发了host,否则在下载Editor.bin​文件时会失败;

具体表现为:前端存在如下请求Editor.bin?md5=xxx​处理失败

​​

观察发现地址为localhost:port,这实际上是nginx转发后访问到onlyoffice,onlyoffice所能获取到的地址;

在对应转发配置中加入:

bash 复制代码
proxy_set_header Host $http_host;

更改nginx配置后,需要重载nginx配置:nginx -s reload

其他

在运行docker容器时,我也使用了以下启动选项

bash 复制代码
-e JWT_ENABLED=false -e USE_UNAUTHORIZED_STORAGE=true -e ONLYOFFICE_HTTPS_HSTS_ENABLED=false

原文链接:https://blog.csdn.net/m0_53401243/article/details/133869439

相关推荐
qetfw4 小时前
UOS DHCP Relay:跨网段分配与 IP、DNS、网关验证
linux·服务器·网络·tcp/ip·uos
叼烟扛炮6 小时前
Linux 学习笔记(四十一):TCP 并发演进——从单进程到多线程服务器
linux·运维·服务器·网络·笔记·学习·tcp/ip
ynchyong7 小时前
Linux 有两个 “版本“
linux·发行版·内核版本
叼烟扛炮7 小时前
Linux 学习笔记(四十四):HTTP 协议解析与极简 Web 服务器实战
linux·服务器·学习
叼烟扛炮7 小时前
Linux 学习笔记(四十三):网络编程进阶——自定义协议解决 TCP 粘包与守护进程
linux·开发语言·网络·笔记·tcp/ip
Escalating_xu7 小时前
【Linux 网络编程】DNS 与 ICMP:从域名解析到 ping、traceroute,把“网络通不通”问清楚
linux·网络·php
一枕槐安4879 小时前
大模型限流、重试、超时处理:API 调用健壮性方案
linux·服务器·php·大模型api·指数退避·限流控制·超时预算
西索斯coding9 小时前
gpt-image-2.5-sunburst 和 gemini-3.1-flash-image 差多少?60 组项目素材的成功成本评测框架
java·linux·gpt·ai
箓维9 小时前
应用层协议基础_序列化与反序列化
linux
wuminyu10 小时前
Java字节码学习总结:字节码如何加载、解析和执行
java·linux·c语言·jvm·c++