保姆级教程：用Docker一键部署OnlyOffice，再给Cloudreve装上在线预览插件
零基础实战：Docker+OnlyOffice无缝集成Cloudreve实现文档预览
引言
对于个人站长和小型团队来说，搭建私有云盘已经成为刚需。Cloudreve作为一款开源的网盘系统，凭借其简洁的界面和丰富的功能赢得了不少用户的青睐。然而在实际使用中，许多用户都会遇到一个共同的痛点——无法直接在网页中预览Office文档。每次查看Word、Excel或PPT文件都需要下载到本地，这种体验对于追求效率的用户来说简直是噩梦。
传统解决方案要么依赖第三方服务（存在隐私风险），要么需要复杂的配置（对新手极不友好）。而今天我们要介绍的Docker+OnlyOffice组合，完美解决了这一难题。只需几个简单的命令和配置，就能让Cloudreve获得媲美商业网盘的文档预览能力。
这套方案有三大核心优势：
- 一键部署：全程使用Docker容器化技术，避免环境配置的繁琐
- 零代码修改：无需改动Cloudreve源码，通过标准接口实现集成
- 全平台兼容：无论是Windows服务器还是Linux主机都能完美运行
下面我们就从零开始，手把手教你如何实现这一功能组合。即使你没有任何运维经验，只要跟着步骤操作，30分钟内就能完成全部部署。
1. 环境准备与OnlyOffice部署
1.1 系统要求检查
在开始之前，请确保你的服务器满足以下最低配置要求：
| 组件 | 最低要求 | 推荐配置 |
|---|---|---|
| CPU | 2核 | 4核 |
| 内存 | 2GB | 4GB |
| 磁盘 | 20GB | 50GB |
| 系统 | Ubuntu 18.04+ | Ubuntu 20.04 LTS |
提示：虽然OnlyOffice官方建议2GB内存即可运行，但在实际使用中发现，处理大型文档时4GB内存会更流畅。
1.2 Docker安装与配置
如果你的系统尚未安装Docker，可以通过以下命令快速安装：
# Ubuntu/Debian系统 sudo apt update sudo apt install -y docker.io sudo systemctl enable --now docker # CentOS/RHEL系统 sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo sudo yum install -y docker-ce docker-ce-cli containerd.io sudo systemctl enable --now docker安装完成后，建议将当前用户加入docker组，避免每次都要使用sudo：
sudo usermod -aG docker $USER newgrp docker1.3 部署OnlyOffice文档服务器
OnlyOffice提供了官方Docker镜像，部署非常简单。这里我们使用以下命令启动容器：
docker run -d --restart=always \ --name onlyoffice \ -p 1080:80 \ -e JWT_ENABLED=false \ onlyoffice/documentserver关键参数说明：
-p 1080:80：将容器内的80端口映射到主机的1080端口-e JWT_ENABLED=false：禁用JWT验证，简化集成配置--restart=always：确保容器在意外退出后自动重启
部署完成后，访问http://你的服务器IP:1080，如果看到OnlyOffice的欢迎页面，说明部署成功。
2. 配置OnlyOffice预览接口
2.1 创建view.html预览页面
我们需要创建一个HTML文件作为Cloudreve和OnlyOffice之间的桥梁。新建一个名为view.html的文件，内容如下：
<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <title>文档预览</title> <style> body { margin: 0; padding: 0; } #placeholder { height: 100vh; } </style> </head> <body> <div id="placeholder"></div> <script type="text/javascript" src="http://你的服务器IP:1080/web-apps/apps/api/documents/api.js"></script> <script> function getUrlParam(name) { const reg = new RegExp(`(^|&)${name}=([^&]*)(&|$)`); const r = window.location.search.substr(1).match(reg); if (r != null) return decodeURIComponent(r[2]); return null; } const fileUrl = getUrlParam("src"); const fileName = getUrlParam("name"); const fileExt = fileName.split('.').pop().toLowerCase(); const docEditor = new DocsAPI.DocEditor("placeholder", { "document": { "fileType": fileExt, "permissions": { "edit": false, "comment": true, "download": true, "print": true, "fillForms": true }, "title": fileName, "url": fileUrl }, "editorConfig": { "lang": "zh-CN", "mode": "view" }, "height": "100%", "type": "desktop" }); </script> </body> </html>2.2 将view.html复制到容器内
使用docker cp命令将文件复制到OnlyOffice容器中：
docker cp view.html onlyoffice:/var/www/onlyoffice/documentserver-example/welcome/验证文件是否复制成功：
docker exec onlyoffice ls -l /var/www/onlyoffice/documentserver-example/welcome/view.html如果命令返回了文件信息，说明复制成功。此时访问http://你的服务器IP:1080/welcome/view.html应该能看到空白页面（这是正常的，因为需要参数才能显示内容）。
3. Cloudreve配置与集成
3.1 配置Cloudreve预览设置
登录Cloudreve管理后台，进入"参数设置"→"图像预览"部分，找到"文件预览地址"配置项，填写以下URL：
http://你的服务器IP:1080/welcome/view.html?src={$src}&name={$name}重要注意事项：
- 确保URL中的IP和端口与OnlyOffice部署的一致
- Windows系统下运行Cloudreve时，建议使用管理员权限启动
- 如果使用域名，确保域名已正确解析并配置了SSL证书
3.2 测试文档预览功能
上传一个Office文档到Cloudreve，然后点击预览。如果一切配置正确，你应该能看到文档在网页中完美显示，就像使用本地Office软件一样。
常见问题排查：
- 空白页面：检查浏览器控制台是否有错误，确认api.js路径正确
- 下载失败：检查OnlyOffice容器日志，确认JWT_ENABLED=false
- 格式不支持：OnlyOffice支持主流Office格式，但某些特殊格式可能需要转换
4. 高级配置与优化
4.1 使用WOPI协议集成（可选）
对于Cloudreve最新版本和OnlyOffice 6.4+，可以使用更现代的WOPI协议集成：
# 停止并删除旧容器 docker stop onlyoffice docker rm onlyoffice # 使用WOPI_ENABLED启动新容器 docker run -d --restart=always \ --name onlyoffice \ -p 1080:80 \ -e JWT_ENABLED=false \ -e WOPI_ENABLED=true \ onlyoffice/documentserver然后在Cloudreve的WOPI配置中添加：
http://你的服务器IP:1080/hosting/discovery4.2 性能优化建议
为了提高OnlyOffice的响应速度，可以考虑以下优化措施：
增加容器资源限制：
docker update --memory=4G --cpus=2 onlyoffice启用文档缓存：
docker exec onlyoffice sed -i 's/"browser": false/"browser": true/' /etc/onlyoffice/documentserver/default.json docker restart onlyoffice使用Nginx反向代理：
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; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }
4.3 安全加固
虽然我们禁用了JWT验证简化了配置，但在生产环境中建议采取以下安全措施：
限制IP访问：
iptables -A INPUT -p tcp --dport 1080 -s 允许的IP -j ACCEPT iptables -A INPUT -p tcp --dport 1080 -j DROP定期更新镜像：
docker pull onlyoffice/documentserver docker stop onlyoffice docker rm onlyoffice # 使用新镜像重新运行容器日志监控：
docker logs --tail=100 -f onlyoffice
这套方案在我的多个项目中稳定运行超过一年，处理过数千份文档，从未出现过兼容性问题。唯一需要注意的是，当处理超大型文档（如100MB以上的PPT）时，建议先在本地压缩优化后再上传。