Seafile与OnlyOffice集成问题排查指南

问题背景

在使用Seafile CE 11.0版本时，尝试按照官方文档将OnlyOffice文档服务器与Seafile进行集成，但遇到了集成失败的问题。主要症状表现为OnlyOffice无法正确回调Seafile服务，且文件下载请求被拒绝。

配置分析

核心配置问题

1. HTTPS配置不一致：虽然系统启用了HTTPS，但seahub_settings.py中的SERVICE_URL仍配置为HTTP协议，这会导致回调URL生成错误。

2. 网络连接问题：日志显示OnlyOffice尝试连接127.0.0.1:443失败，这表明容器间的网络通信可能存在问题。

3. 回调URL路径错误：OnlyOffice尝试访问/onlyoffice/editor-callback/路径时返回404错误，说明Seafile服务未正确配置或未识别该回调端点。

解决方案

1. 修正HTTPS配置

确保所有相关配置都使用HTTPS协议：

# seahub_settings.py中修改
SERVICE_URL = "https://localhost.127.0.0.1.nip.io"
FILE_SERVER_ROOT = "https://localhost.127.0.0.1.nip.io/seafhttp"

2. 检查网络连接

验证Docker容器间的网络通信：

1. 确认所有服务都在同一个Docker网络(seafile-net)中
2. 测试从OnlyOffice容器到Seafile容器的网络连通性
3. 确保端口映射和容器间通信配置正确

3. 验证回调URL配置

检查Seafile的OnlyOffice集成配置：

1. 确认ENABLE_ONLYOFFICE设置为True
2. 验证ONLYOFFICE_APIJS_URL路径是否正确
3. 确保JWT密钥在Seafile和OnlyOffice配置中一致

深入排查建议

1. 容器网络诊断

使用以下命令检查容器网络状态：

docker network inspect seafile-net
docker exec -it seafile-oods ping seafile

2. 日志分析要点

重点关注以下日志信息：

1. OnlyOffice的docservice和converter日志
2. Seafile的nginx访问日志和错误日志
3. 检查是否有跨域(CORS)相关的错误

3. 配置验证清单

完成以下配置验证：

1. [ ] 所有URL配置使用HTTPS
2. [ ] JWT密钥在两端匹配
3. [ ] 文件服务器URL可访问
4. [ ] 回调URL路径正确
5. [ ] 容器间网络通信正常

总结

Seafile与OnlyOffice集成失败通常源于配置不一致或网络问题。通过系统性地检查HTTPS配置、网络连接和回调URL设置，大多数集成问题都可以解决。建议按照本文提供的步骤逐一验证，特别注意容器化环境中的网络隔离问题。