本文介绍了如何将 OnlyOffice 与 Seafile 私有网盘深度集成，实现文档的在线预览与编辑功能。涵盖四种主流部署方案：独立 Docker 容器部署、docker-compose 统一编排、Nginx 子路径反向代理集成，以及 Seafile Pro 版本的白名单与源码级适配，帮助用户根据实际环境选择最优解。
若您已成功搭建 Seafile 私有云盘，但在尝试在线预览或编辑文档时遇到障碍，很可能是 OnlyOffice DocumentServer 尚未正确接入或服务通信异常所致。为充分发挥协同办公能力，以下提供多种将 OnlyOffice 与 Seafile 高效整合的实操方案。
方案一：基于独立 Docker 容器部署 OnlyOffice 并对接 Seafile
此方式适用于已有 Seafile 容器化环境的场景，仅需额外启动一个轻量级的 OnlyOffice 服务容器，并通过宿主机网络或自定义虚拟网络实现互通。为简化配置流程，建议临时关闭 JWT 身份验证机制。
1. 拉取并启动 OnlyOffice DocumentServer 容器，同时禁用 JWT 认证：
2. 执行如下指令：docker run -d –name onlyoffice –net host -p 7777:80 -e JWT_ENABLED=false onlyoffice/documentserver:7.1
3. 稍等约 1 至 2 分钟，在浏览器中访问 http://服务器IP:7777/welcome，验证欢迎页面能否正常加载。
4. 进入 Seafile 容器内部，打开配置文件 /shared/seafile/conf/seahub_settings.py，追加以下参数：
5. 添加内容如下：ENABLE_ONLYOFFICE = True
VERIFY_ONLYOFFICE_CERTIFICATE = False
ONLYOFFICE_APIJS_URL = ‘http://服务器IP:7777/web-apps/apps/api/documents/api.js’
ONLYOFFICE_FILE_EXTENSION = (‘docx’, ‘xlsx’, ‘pptx’, ‘pdf’)
6. 完成编辑后，重启 Seafile 的 seahub 服务以应用新配置。
方案二：采用 docker-compose 统一编排 Seafile 与 OnlyOffice
该方案通过 docker-compose 实现多服务一体化管理，支持数据持久化、日志独立存储及端口灵活映射，尤其适合生产环境中的长期稳定运行。所有服务共享同一自定义网络，有效避免宿主机端口冲突问题。
1. 创建所需目录结构：mkdir -p /data/seafile/{seafile-data,seadoc-data,seafile-mysql/db,onlyoffice/DocumentServer/{data,logs}}
2. 编写 docker-compose.yml 文件，定义 seafile-mc、mariadb、memcached 和 onlyoffice 四个核心服务，其中 onlyoffice 部分配置示例如下：
3. 关键配置项包括：image: onlyoffice/documentserver:7.1.1
ports: – “8098:80”
environment: – JWT_ENABLED=false
volumes: – /data/seafile/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data
– /data/seafile/onlyoffice/DocumentServer/logs:/var/log/onlyoffice
4. 在 seafile-mc 服务的环境变量中加入：– ONLYOFFICE_APIJS_URL=http://onlyoffice:80/web-apps/apps/api/documents/api.js（此处使用容器名称进行内部通信）。
5. 执行命令 docker-compose up -d 启动全部服务组件。
6. 进入 seafile-mc 容器，检查 seahub_settings.py 中是否已启用 ENABLE_ONLYOFFICE 并确保无语法错误。
方案三：通过 Nginx 反向代理实现子路径集成 OnlyOffice
本方法将 OnlyOffice 部署在 Seafile 同一域名下的子路径（例如 /onlyofficeds），从而规避跨域访问限制，特别适合已启用 HTTPS 的正式线上站点，且 Seafile 运行于根路径的情形。
1. 调整 OnlyOffice 容器启动参数，强制其识别子路径结构：-e ONLYOFFICE_HTTPS_PORT=443 -e ONLYOFFICE_HTTP_PORT=80 -e ONLYOFFICE_SITE_URL=https://yourdomain.com/onlyofficeds
2. 在 Nginx 配置文件的 server 区块内新增 location 规则：
3. 添加如下转发逻辑：location ^~ /onlyofficeds/ { proxy_pass http://onlyoffice:80/; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection “upgrade”; proxy_set_header Host $host; }
4. 修改 Seafile 配置中的 ONLYOFFICE_APIJS_URL 为：https://yourdomain.com/onlyofficeds/web-apps/apps/api/documents/api.js
5. 验证并重新加载 Nginx 配置：nginx -t && nginx -s reload
6. 打开浏览器开发者工具，查看 Network 面板，确认 api.js 和 document.html 资源均返回 200 状态码。
方案四：Seafile Pro 版本专属适配：扩展文件类型支持与后端逻辑调整
Seafile Pro 默认不开放 PDF 文件的在线编辑权限，且部分版本对 OnlyOffice 支持的文件扩展名实施严格校验。因此需手动调整源码级白名单，并确保前后端接口兼容。
1. 登录 Seafile Pro 容器，定位两个关键 Python 脚本：/opt/seafile/seafile-pro-server-*/seahub/seahub/utils/__init__.py 和 /shared/seafile/conf/seahub_settings.py
2. 编辑 __init__.py，在 PREVIEW_FILEEXT 字典中将 DOCUMENT 类别添加 ‘pdf’，同时确保 PDF 类别不再包含 pdf（防止重复匹配）：
3. 修改后的代码片段应为：DOCUMENT: (‘pdf’, ‘doc’, ‘docx’, ‘ppt’, ‘pptx’, ‘xlsx’),
PDF: (‘ai’,)
4. 在 seahub_settings.py 中明确声明支持 PDF 编辑：ONLYOFFICE_EDIT_FILE_EXTENSION = (‘pdf’, ‘docx’, ‘xlsx’, ‘pptx’)
5. 保存更改后，运行命令：supervisorctl restart seahub
6. 向 Seafile 资料库上传一份 PDF 文件，右键选择“编辑”选项，观察 OnlyOffice 编辑器是否成功唤起。
