Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Collabora Online integration issues (WOPISrc missing + socket connection error behind reverse proxy)

未关闭
#59 7 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
35/100
Issue 类型
缺陷
描述清晰度
需要澄清
活跃度
冷清
技术栈
docker

调研方向

从 Cloudreve 的 WOPI URL 生成路径以及为 console.domain.ext 和 docs.domain.ext 显示的 Caddy 配置开始。使用提供的 Docker 设置复现打开文档的过程,然后跟踪 WOPISrc 和 WebSocket 请求。完成的标准是:通过反向代理打开文档时,不再出现缺少 WOPISrc 或套接字连接错误。

由索引模型根据 Issue 内容生成。

描述

Description:

Hello,

I'm trying to integrate Collabora Online (CODE) with Cloudreve (Docker, pro version) using WOPI, but I’m facing two blocking issues.

Setup:

Cloudreve running in Docker behind Caddy reverse proxy
Public domain: https://console.domain.ext/
Collabora Online running in Docker (collabora/code)
Collabora exposed via Caddy on https://docs.domain.ext
Storage: Cloudflare R2 (working correctly)

Cloudreve reverse proxy (Caddy):

console.domain.ext {
    reverse_proxy localhost:5212 {
        header_up Host {host}
        header_up X-Forwarded-Proto {scheme}
        header_up X-Forwarded-Host {host}
    }
}

Collabora setup:

docker run -d \
  --name collabora \
  -p 127.0.0.1:9980:9980 \
  -e "aliasgroup1=https://console.domain.ext" \
  -e "domain=console\\.domain\\.ext" \
  -e "extra_params=--o:ssl.enable=false --o:ssl.termination=true" \
  collabora/code

Issues:

WOPI error in Collabora

When opening a document:

Wrong or missing WOPISrc parameter

It seems Collabora is not receiving a valid WOPISrc URL from Cloudreve.

WebSocket / reverse proxy error

Collabora frontend shows:

Failed to establish socket connection or socket connection closed unexpectedly. The reverse proxy might be misconfigured.

Observations:

Cloudreve backend is working correctly (upload/download OK)
API /api/v4/file/content works fine
No database or storage errors
The issue only happens when opening documents in Collabora

Question:

Could you clarify:

  • How Cloudreve generates the WOPISrc URL (is it based on SiteURL or request headers)?
  • What is the recommended reverse proxy configuration for WOPI + Collabora behind Caddy/Nginx?
  • Are there any required environment variables to force external base URL for WOPI?
  • Any known issues with Docker + reverse proxy causing localhost WOPISrc generation?
主要语言
TypeScript
星标
18
派生
41
PR 合并指标
30 天内没有已合并 PR

贡献指南

这个仓库没有索引到贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

cloudreve/docs 的其他 Issue

查看 cloudreve/docs 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。