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

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

查看OnlyOffice Converter的日志：docker logs -f 容器名

发现日志文件中存在如下报错：

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下的内容

docker exec -it onlyoffice-server /bin/bash

# 搜索并修改以下字段为true
nano /etc/onlyoffice/documentserver/default.json

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

重启容器后恢复正常

2026-06-18 补充：可通过配置Docker容器环境变量解决

编辑配置文件方式，在重新创建容器后会失效，每次都要重新编辑，使用环境变量一劳永逸

services:
  onlyoffice-server:
    image: onlyoffice/documentserver:latest
    container_name: onlyoffice-server
    restart: always
    ports:
      - 80:80
    volumes:
      - /data/compose_data/onlyoffice/logs:/var/log/onlyoffice # 日志
      - /data/compose_data/onlyoffice/cert:/var/www/onlyoffice/Data # 证书数据
      - /data/compose_data/onlyoffice/lib:/var/lib/onlyoffice # 文件缓存
      - /data/compose_data/onlyoffice/db:/var/lib/postgresql # 数据库
      - /etc/localtime:/etc/localtime:ro
    environment:
      ALLOW_META_IP_ADDRESS: true
      ALLOW_PRIVATE_IP_ADDRESS: true