扩展文档预览/编辑
Cloudreve 会通过文件的扩展名自动选择预览器。Cloudreve 内置了多种文件格式的预览器，包括视频、音频、代码、文本、Office 文档等。其中 Office 文档预览器提供了较高的扩展性，你可以在 后台 - 参数设置 - 图像与预览 - 文件预览 中更换默认的文档预览服务地址。也可以通过开启 WOPI 集成，将 Office 文档预览器替换为更强大的预览/编辑器，并自主定义可被预览/编辑的文件扩展名。本文将介绍三种支持 WOPI 协议的服务的部署及对接方式。你也可以通过实现自己的 WOPI 客户端，扩展 Cloudreve 的预览编辑能力（不仅限于 Office 文档）。
docker pull collabora/code
docker run -t -d -p 127.0.0.1:9980:9980 \
-e "aliasgroup1=< 允许使用此服务的 Cloudreve 地址，包含明确端口>" \
-e "username=<面板管理员用户名>" \
-e "password=<面板管理员密码>" \
--name code --restart always collabora/code
以官方演示站为例：
docker run -t -d -p 127.0.0.1:9980:9980 \
-e "aliasgroup1=https://demo.cloudreve.org:443" \
-e "username=<面板管理员用户名>" \
-e "password=<面板管理员密码>" \
--name code --restart always collabora/code
Container 启动后，配置 Nginx 或其他 Web 服务器反向代理
https://127.0.0.1:9980, 可参考 Proxy settings，确保反代后的服务能够被你的最终用户访问，你可以手动访问 <你的服务主机>/hosting/discovery 来确认是否返回了预期的 XML 响应。在 后台 - 参数设置 - 图像与预览 - 文件预览 - WOPI 客户端 中开启
使用 WOPI 并在 WOPI Discovery Endpoint 中填入<你的服务主机>/hosting/discovery。保存后可在前台测试文档预览和编辑：
docker run -i -t -d -p 8080:80 -e WOPI_ENABLED=true onlyoffice/documentserver
你可以手动访问
<你的 OnlyOffice 主机>/hosting/discovery 来确认是否返回了预期的 XML 响应。在 后台 - 参数设置 - 图像与预览 - 文件预览 - WOPI 客户端 中开启
使用 WOPI 并在 WOPI Discovery Endpoint 中填入<你的服务主机>/hosting/discovery。保存后可在前台测试文档预览和编辑：
OnlyOffice 不支持过滤 WOPI 请求来源，如果你有对公使用需求，请通过外部应用防火墙检查预览页面请求中
wopisrc 参数是否为预期的 Cloudreve 站点。你可以手动访问
<你的 OnlyOffice 主机>/hosting/discovery 来确认是否返回了预期的 XML 响应。在 后台 - 参数设置 - 图像与预览 - 文件预览 - WOPI 客户端 中开启
使用 WOPI 并在 WOPI Discovery Endpoint 中填入<你的服务主机>/hosting/discovery。保存后可在前台测试文档预览和编辑：
Office Online Server 不支持过滤 WOPI 请求来源，如果你有对公使用需求，请通过外部应用防火墙检查预览页面请求中
wopisrc 参数是否为预期的 Cloudreve 站点。Web Application Open Platform Interface (WOPI) 协议是一种用于集成 Web 文档编辑器的协议，你可以在 微软的文档 中阅读详细的协议定义。Cloudreve 可以对接实现了 WOPI 协议的文档处理服务，用于扩展已有的文档预览和编辑能力。
Cloudreve 对 WOPI REST 方法的实现情况如下表所示：
Method | 支持情况 |
|---|---|
CheckFileInfo | ✅ |
GetFile | ✅ |
Lock | ⚠️（可调用但无效果） |
RefreshLock | ⚠️（可调用但无效果） |
Unlock | ⚠️（可调用但无效果） |
PutFile | ✅ |
PutRelativeFile | ❌ |
RenameFile | ✅ |
最近更新 1mo ago