將 Nextcloud 連接到 CODE Docker：設定和權衡

透過執行官方collabora/code鏡像將 Nextcloud 連接到 Collabora CODE，將其連接埠限制在主機上，將 HTTPS 辦公室子網域路由到支援 WebSocket 的反向代理，並在 Nextcloud 的 Collabora 整合中設定該公共 URL。只有在 Docker、DNS、TLS 和代理程式都準備就緒的情況下，十分鐘內完成連線才有可能。

首先選擇合適的辦公室服務。截至 2026 年 10 月，Nextcloud 將其基於 Euro-Office 的 Nextcloud Office 與 Collabora Online 區分開來。 CODE 是 Collabora Online 開發版，因此請使用 Collabora 集成，而不是 Euro-Office 連接器。內建的 CODE 應用速度最快，適合個人使用，但 Nextcloud 指出其速度較慢且缺乏高級可擴展性。單獨的容器更易於獨立管理，但會增加代理和更新工作。 CODE 適合家庭使用和測試；如果企業需要生產環境支持，請選擇受支援的 Collabora Online 部署。

開始之前：十分鐘路徑

確保程式碼主機上有一個可用的 Nextcloud HTTPS 位址、一個獨立的、具有有效 TLS 憑證的辦公室主機名，以及 Docker 存取權限。將辦公主機名稱指向一個可以路由到容器的反向代理。使用者的瀏覽器和 Nextcloud 伺服器都必須能夠存取該辦公室 URL。

如果 DNS 或 TLS 尚未準備就緒，請勿將 9980 連接埠作為捷徑公開。請先將其綁定到環回位址並完成代理配置。

1. 啟動 CODE Docker 容器

請將範例 Nextcloud 主機名稱替換為使用者登入時使用的實際 HTTPS 來源位址。此aliasgroup1設定限制了哪些 WOPI 主機（向編輯器提供文件的文件服務）可以連接。請勿使用通配符來掩蓋連線失敗的情況。

docker pull collabora/code

docker run -t -d --name collabora-code -p 127.0.0.1:9980:9980 -e 'aliasgroup1=https://cloud.example.com:443' --restart unless-stopped --cap-add MKNOD collabora/code

綁定到127.0.0.1某個特定連接埠可以確保連接埠的私密性，同時同一主機上的代理伺服器可以存取該連接埠。如果您的代理伺服器位於其他位置，請僅允許該受信任的代理伺服器連接到 9980 連接埠。

檢查容器是否已啟動，以及其發現端點是否在本地回應：

docker ps --filter name=collabora-code
docker logs --tail=50 collabora-code
curl -kfsS -o /dev/null -w 'Discovery HTTP %{http_code}\n' https://127.0.0.1:9980/hosting/discovery

-k僅針對本機自簽名憑證檢查繞過憑證驗證；它不會修復無效的公共憑證。

2. 將公營辦公室主機名稱放在 HTTPS 後面

https://office.example.com使用有效的憑證透過反向代理提供服務，並將請求路由到 CODE。 Collabora 的代理指南涵蓋編輯器資源、發現/功能/cool/以及 WebSocket 轉發。如果未升級 WebSocket，頁面可能可以加載，但編輯器可能無法正常運作。

請使用代理軟體的現有配置。如果它在 CODE 之前終止 TLS，請遵循文件中記錄的後端 TLS 設定；不要全域停用憑證檢查。

3. 在 Nextcloud 中連接 Collabora 集成

在 Nextcloud 中，啟用或安裝適用於您版本的 Collabora 整合應用程式。然後開啟 Office 管理區域，輸入公共 Collabora URL。https://office.example.com目前手冊將此設定標記為「Collabora Online Server」；措詞和應用程式名稱可能會因版本而異，尤其是在 Nextcloud 新增 Euro-Office 選項之後。為此 CODE 伺服器選擇 Collabora Online。除非https://127.0.0.1:9980Nextcloud 本身運行在同一主機上，且該位址也是已配置的服務端點，否則請勿輸入僅容器位址；在建議的代理設定中，請使用公用 Office 主機名稱。

儲存設置，如果您的版本顯示有內建連接檢查，請執行該檢查。如果檢查失敗，請比較 Nextcloud 來源的確切訊息aliasgroup1，確認 Nextcloud 和瀏覽器都能解析並存取公司主機名，並檢查反向代理日誌中是否存在路徑被拒絕或 WebSocket 錯誤。

4. 確認編輯內容，然後選擇程式碼是否符合要求。

在 Nextcloud 中打開一個小型測試文檔，確認它能在瀏覽器編輯器中打開，接受更改，保存，並能以相同的更改重新打開。分別使用普通使用者帳戶和管理員帳戶進行測試。僅憑此發現問題只能確認 CODE 有回應；但並不能證明 WOPI 授權、代理 WebSocket 和文件保存操作都正常運作。

對於個人伺服器或小型團隊而言，CODE Docker 將編輯器與 Nextcloud 的 PHP 堆疊分開。您還需自行管理代理、重新啟動、相容性檢查和鏡像更新。內建的 CODE 應用雖然更簡單，但需要共享主機，且可擴充性較差。對於依賴日常編輯的組織，建議評估受支援的 Collabora Online 服務，而不是將 CODE 視為生產環境的保障。

準備更新程式碼時，拉取新鏡像並使用相同的選項重新建立容器。在更新使用者所依賴的服務之前，請務必查看發行說明並測試文件的開啟和儲存功能；標籤latest可能會移動。當可重複部署至關重要時，請鎖定特定鏡像版本。

確認

當公共辦公室主機名稱提供有效憑證、Nextcloud 連線檢查成功，並且測試文件能夠透過編輯器開啟、儲存和重新開啟時，則表示設定正常運作。如果辦公室登入頁面已載入但編輯卡住，請檢查 WebSocket 轉送。如果 Nextcloud 報告主機不被允許，請修正aliasgroup1以符合實際的 Nextcloud 來源。如果本機 CODE 回應正常，但使用者瀏覽器無法存取，請檢查公共 DNS、防火牆路由和反向代理。

參考資料：Nextcloud 的 Docker 安裝範例；Nextcloud Office 安裝選項; Nextcloud Collabora 配置；Collabora 反向代理設定；官方 CODE Docker 映像詳情；Nextcloud Hub 26 夏季辦公室選項。