HTTPS环境下Snap包OnlyOffice-DS与NextCloud集成遇404错误

数据老陈

2026-7-10

解决方案

修正OnlyOffice的Nginx路由映射
Snap版OnlyOffice的Nginx配置文件一般在/var/snap/onlyoffice-ds/current/etc/nginx/includes/onlyoffice-documentserver-welcome.conf，打开后检查是否有/welcome/healthcheck的匹配规则。如果没有，添加以下配置：
```
location = /welcome/healthcheck {
    return 200 "OK";
    add_header Content-Type text/plain;
}
```
保存后重启服务：sudo snap restart onlyoffice-ds
检查NextCloud的OnlyOffice配置
登录NextCloud管理后台，进入OnlyOffice设置页面，确认文档服务地址填写的是https://onlyoffice.local（不带/welcome后缀）。NextCloud的OnlyOffice插件默认会自动拼接/healthcheck路径，你之前的请求带/welcome大概率是配置时多填了前缀。
Docker版OnlyOffice的适配处理
如果你切换到Docker版，默认健康检查路径是/healthcheck而非/welcome/healthcheck。同样要确保NextCloud里的文档服务地址是根地址，不要加/welcome。如果需要自定义路径，进入容器修改Nginx配置：
```
docker exec -it <你的OnlyOffice容器名> bash
```
找到对应配置文件添加路由后重启容器内的Nginx服务。
验证健康检查路径
正确的健康检查请求应该是curl https://onlyoffice.local/healthcheck，返回200 OK就说明配置没问题。