如何通过Nextcloud界面配置OnlyOffice并解决健康检查报错问题

报错原因 #

• 输入自有服务器地址出现「未找到路径domaine/healthcheck」：OnlyOffice需要独立部署的专用服务器，你的服务器上还没安装OnlyOffice Document Server，自然不存在健康检查所需的/healthcheck路径。
• 输入Nextcloud路径出现「bad healthcheck」：Nextcloud本身并非OnlyOffice服务端，它的目录下没有OnlyOffice的健康检查接口，因此验证失败。

核心前提 #

OnlyOffice插件只是Nextcloud与OnlyOffice服务端的连接工具，必须单独部署OnlyOffice Document Server，不能用Nextcloud的地址替代。

解决步骤 #

1. 部署OnlyOffice Document Server #

推荐用Docker快速部署（操作最简单）：

docker run -i -t -d -p 8080:80 onlyoffice/documentserver

部署完成后，OnlyOffice服务器地址为你的服务器IP/域名+端口，例如 http://你的服务器IP:8080，这就是插件配置时需要填写的「OnlyOffice服务器地址」。

2. 获取Secret密钥 #

• Docker部署的默认密钥存放在容器内的/etc/onlyoffice/documentserver/local.json文件中，可通过以下命令查看：

docker exec 容器ID grep -A 2 "secret" /etc/onlyoffice/documentserver/local.json

（将「容器ID」替换为你的OnlyOffice容器ID，可通过docker ps命令获取）

• 也可手动自定义密钥：修改local.json中services.CoAuthoring.secret.inbox.string和services.CoAuthoring.secret.outbox.string为相同值，之后重启容器生效。

3. 配置Nextcloud的OnlyOffice插件 #

• 在Nextcloud插件设置页面，填入刚才获取的OnlyOffice服务器地址（如http://你的服务器IP:8080）
• 填入对应的Secret密钥，保存后验证连接，即可正常打开Word文件。

额外注意事项 #

• 确保服务器的8080端口（或你指定的自定义端口）对外开放，且Nextcloud服务器能访问该端口
• 若使用HTTPS，需为OnlyOffice配置SSL证书，避免混合内容报错
• 同一服务器部署Nextcloud和OnlyOffice时，注意不要出现端口冲突

内容的提问来源于stack exchange，提问作者Benjamin Loupiac