基于 Collabora 的 Web 文档在线编辑集成指南

注意 iframe 不成功，可能是 Collabora 的 loolwsd.xml 配置的问题，找到 loolwsd.xml 中的 frame_ancestors 配置项，改为 <frame_ancestors>*</frame_ancestors> 即可。

参数解析

• WOPISrc：文档在你的服务上的访问地址（需实现 WOPI 协议端点）。
• fileUrl 示例：https://your-domain.com/wopi/files/{fileId}。
• 解释 fileId：后端会通过 fileId 对文件进行定位处理。

实现 WOPI 后端接口（Java 示例）

代码示例 检查文件权限：

@RestController
@RequestMapping("/wopi")
public class WOPIController {
    // 检查文件权限，向前端提供这个 api 接口就可以，保存接口会通过 wopi 协议自动调用
    @GetMapping("/files/{fileId}")
    public ResponseEntity<Map> checkFileInfo(@PathVariable String fileId) {
        return ResponseEntity.ok(Map.of(
            "BaseFileName", "document.docx",
            "OwnerId", "user123",
            "Size", 10240,
            "UserCanWrite", true // 控制编辑权限
        ));
    }

    // 查看
    @GetMapping("/files/{fileId}/contents")
    public ResponseEntity<UrlResource> getFile(@PathVariable String fileId) {
        // 根据 fileId 获取文件可下载的 url 地址
        String url = getFileUrl(fileId); // getFileUrl 方法自行实现
        UrlResource resource = new UrlResource(url);
        // 设置响应头
        HttpHeaders headers = new HttpHeaders();
        headers.add(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + tFileInfDO.getFileOldName() + "\"");
        return ResponseEntity.ok()
            .contentType(MediaType.parseMediaType("application/octet-stream"))
            .headers(headers)
            .body(resource);
    }

    // 保存文档
    @PostMapping("/files/{fileId}/contents")
    public void saveFile(@PathVariable String fileId, @RequestBody byte[] content) {
        // 将 content 写入你的存储系统
    }
}

高级功能：自定义工具栏按钮

代码示例 添加打印按钮：

const params = new URLSearchParams({
  'WOPISrc': fileUrl,
  'permission': 'edit',
  'custom_settings': JSON.stringify({
    'ToolbarCustomization': [{ "name": ".uno:Print", "type": "action" }]
  })
});
iframe.src = `https://collabora-host/loleaflet.html?${params}`;

支持动作列表 参考 Collabora 官方文档。

PostMessage API — SDK

结语

通过 Collabora 和 WOPI 协议，可以在 Web 应用中嵌入全功能 Office 编辑器，显著提升生产力。下一步可以尝试集成 OnlyOffice 或实现版本历史功能。