Cloudreve 与 OnlyOffice 集成配置指南

以下是 ‌Cloudreve 与 OnlyOffice 集成配置指南‌，整合多平台实践经验与安全优化策略：

一、OnlyOffice Document Server 部署

Docker 快速部署‌

运行以下命令启用 WOPI 协议并启动 OnlyOffice 服务：

bash

Copy Code

docker run -d --restart=always --name onlyoffice \

  -p 1080:80 \

  -v /opt/onlyoffice/data:/var/www/onlyoffice/Data \

  -e WOPI_ENABLED=true \          # 强制启用 WOPI 协议:ml-citation{ref="1,3" data="citationList"}

  -e JWT_ENABLED=false \          # 若无需加密可关闭 JWT:ml-citation{ref="2" data="citationList"}

  onlyoffice/documentserver:7.4   # 确保版本 ≥6.4:ml-citation{ref="1" data="citationList"}

验证服务：访问 http://服务器IP:1080，确认显示 Welcome 页面。

存储与网络优化‌

映射 /var/www/onlyoffice/Data 目录至 SSD/NVMe 存储介质，提升文档读写性能。

若 Cloudreve 与 OnlyOffice 同主机，使用 Docker 内部网络通信（如 --network host）降低延迟。

二、Cloudreve 后台配置

修改文档预览服务地址‌

路径：‌Cloudreve 管理后台 → 参数设置 → 图像与预览 → 文件预览‌。

文档预览服务地址‌：填写 http://OnlyOffice_IP:1080/web-apps/apps/api/documents/api.js。

允许扩展名‌：添加 .docx, .xlsx, .pptx 等需协作的格式。

WOPI 协议集成‌

在 OnlyOffice 配置文件中 local.json 添加以下内容：

json

Copy Code

"wopi": {

  "enable": true,

  "host": "cloudreve.yourdomain.com"  // 替换为 Cloudreve 域名:ml-citation{ref="1,3" data="citationList"}

}

重启容器使配置生效：docker restart onlyoffice。

三、安全与性能增强

HTTPS 加密配置‌

通过 Nginx 反向代理配置 SSL 证书：

nginx

Copy Code

server {

  listen 443 ssl;

  server_name office.yourdomain.com;

  ssl_certificate /path/to/cert.pem;

  ssl_certificate_key /path/to/key.pem;

  location / {

    proxy_pass http://localhost:1080;  # 指向 OnlyOffice 容器:ml-citation{ref="2,7" data="citationList"}

  }

}

Cloudreve 预览地址改为 https://office.yourdomain.com/web-apps/...。

访问控制‌

防火墙仅开放 Cloudreve 服务器 IP 到 OnlyOffice 的 1080 端口。

启用 JWT 加密（生产环境推荐）：

bash

Copy Code

docker run ... -e JWT_SECRET=your_strong_key:ml-citation{ref="2,8" data="citationList"}

Cloudreve 后台同步配置相同密钥。

四、功能验证与调试

基础功能测试‌

上传 Office 文件至 Cloudreve，点击「预览」应加载 OnlyOffice 编辑器。

编辑并保存文档，确认修改内容同步至 Cloudreve 存储。

常见问题处理‌

编辑器无法加载‌：检查浏览器控制台 Network 面板，排查跨域请求（CORS）拦截。

文档保存失败‌：

确认 Cloudreve 存储目录权限（需 Web 服务用户可写）。

排查 OnlyOffice 容器日志：docker logs onlyoffice。

五、高阶扩展

API 深度定制‌：参考 OnlyOffice 开发文档，在 view.html 中嵌入定制化编辑按钮与回调函数。

多节点负载均衡‌：部署多个 OnlyOffice 实例，通过 HAProxy 分发请求提升并发能力。

通过以上步骤可实现 ‌Cloudreve 与 OnlyOffice 的无缝集成‌，满足私有化文档协作需求。若需离线部署，需提前下载 Docker 镜像与字体依赖库。