使用 Docker Compose 安裝 ownCloud Infinite Scale

對於伺服器安裝,請從 ownCloud 官方ocis_full針對穩定版 8.2 文件提供的 Docker Compose 範例開始。此範例包含 Infinite Scale 服務、反向代理以及可選的辦公室協作服務;.env運行前,請在其文件中設定您的網域、SMTP 寄件者和資料路徑docker compose up -d。此設定專為單一執行個體設計,需要公共 DNS 和可存取連接埠以使用受信任的 Let's Encrypt 憑證。對於沒有網域名稱的內部評估,請遵循下文所述的自簽名憑證限制。

安裝前

此流程遵循 ownCloud 的Infinite Scale 8.2 生產環境 Compose 指南(2026 年 10 月 9 日更新)。該指南適用於已安裝 Docker Engine 和 Docker Compose 的 Ubuntu LTS 24.04 或 22.04 系統。指南建議至少配備 4-6 GB 記憶體。其預設啟用的服務需要約 2.4 GB 的磁碟空間,這還不包括使用者檔案、日誌、備份和未來成長所需的空間。

如果您能夠維護 DNS、防火牆規則和 Linux 主機,請選擇此完整範例。它不僅包含核心文件平台,還包含其他功能;ownCloud 表示,對於無網域評估,該設定使用自簽名憑證。

  • 主機: Ubuntu 24.04 LTS 或 22.04 LTS,具有 SSH 和 sudo 存取權限。
  • 網路:一個網域,其所需的 DNS 記錄解析到伺服器的 WAN 位址;允許防火牆和任何上游路由器中的入站 TCP 連接埠 22、80 和 443。
  • 軟體: Docker Engine 和 Compose 外掛程式。在 Linux 系統上,Docker 透過其軟體包倉庫提供安裝文件;安裝完成後,確認 Compose 是否回應docker compose version。
  • 郵件:此範例需要提供郵件地址值SMTP_SENDER才能啟動。如果您希望接收通知郵件,請完成其他 SMTP 設定。

1. 安裝 Docker Compose 並準備主機

如果 Docker Engine 已存在,請依照Docker 官方 Compose 安裝說明中適用於您 Linux 發行版的方法安裝 Compose 外掛程式。對於已配置 Docker 軟體倉庫的 Ubuntu 或 Debian 系統,文件中列出的軟體包指令為:

sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version

Docker 建議在目前安裝環境中使用外掛程式和docker compose命令列形式。如有需要,請依照 Docker Engine 的官方 Ubuntu 安裝說明進行安裝。

下載設定之前,請將您計劃使用的網域名稱或子網域名稱指向主機的公網 IP 位址。 ownCloud 的範例需要 `<your-domain-name>` OCIS_DOMAIN;如果配置了對應的辦公室服務,它也可能使用 `<your-domain-name>`COLLABORA_DOMAIN和ONLYOFFICE_DOMAIN`<your-domain-name>`。 DNS 名稱必須與 `<your-domain-name>` 中的值相符.env。請檢查您的路由器是否已將連接埠 80 和 443 轉送到此主機,以及本機防火牆是否允許這些連接埠的流量通過。

2. 取得官方的 Compose 範例

使用ownCloud官方部署範例ocis_full分支中的目錄。在裝有瀏覽器的電腦上下載 ZIP 文件,使用 將其傳輸到無頭伺服器,然後按照 ownCloud 指南中的說明將其解壓縮到 目錄下。stable-8.2scp/opt/compose/ocis/ocis_full

在提取更新副本之前,請先儲存目前檔案.env:ownCloud 會警告檔案可能被覆寫。請從專案目錄執行 Compose 指令。

3. 配置網域名稱、憑證、電子郵件和資料路徑

用文字編輯器開啟/opt/compose/ocis/ocis_full/.env。保留範例中的變數名稱和語法,只編輯適用於您目前安裝環境的值:

  • 設定OCIS_DOMAIN為使用者將要輸入的主機名稱。只有當範例中啟用了 Collabora 或 OnlyOffice 服務時,才會設定這些主機名稱。
  • 對於面向互聯網的伺服器,請INSECURE按照範例說明進行註釋。不要啟用其不安全的設定以供公共使用。
  • 設定TRAEFIK_ACME_MAIL為您控制的電子郵件地址。對於初始憑證測試,請設定TRAEFIK_ACME_CASERVER為 Let's Encrypt 的測試伺服器。測試證書不被信任用於正常用途;它們用於在申請生產證書之前測試 DNS 和可及性。
  • 即使您尚未設定可用的郵件中繼,也請務必進行設定SMTP_SENDER。官方指南指出,如果沒有設置,部署將無法啟動。請新增 SMTP 主機、連接埠、憑證、驗證和安全性設定(如有);如果沒有其他郵件設置,執行個體可以啟動,但無法傳送通知。
  • 請查看OCIS_DOCKER_IMAGE範例中的圖片標籤。依照穩定版安裝步驟進行安裝時,請勿隨意切換發布管道。
  • 對於生產伺服器,請考慮將儲存空間分配OCIS_DATA_DIR到OCIS_CONFIG_DIR已規劃的主機路徑,並確保儲存容量充足且備份覆蓋範圍足夠。預設設定使用 Docker 管理的捲,這很方便,但 ownCloud 指出,這些卷的位置、快照、備份、還原、重設和遷移都取決於 Docker 主機的儲存。

限制對伺服器及其設定檔的存取。自簽名憑證僅適用於內部評估,不適用於受信任的公共部署。

在專案目錄中,啟動容器之前,請先驗證合併後的配置:

cd /opt/compose/ocis/ocis_full
docker compose config

請先修復報告的變數或 YAML 錯誤,然後再繼續。此命令會渲染 Compose 設定以供檢查;它並不能證明 DNS、憑證、儲存權限或 SMTP 連線是否正常運作。

4. 啟動服務並完成證書設置

在後台啟動堆疊:

docker compose up -d

首次運行會拉取鏡像並啟動服務,因此可能比後續重新啟動耗時更長。請使用以下命令檢查服務狀態:

docker compose ps -a

然後檢查日誌,看服務是否已停止或網址是否無法載入:

docker compose logs --follow

首先查看 Traefik 的日誌。憑證錯誤通常指向 DNS 和.env值不符、連接埠 80/443 封鎖或 ACME 電子郵件地址無效。請先修復錯誤原因,然後再試一次。請勿將docker compose down -v其用作重置:它會刪除所有項目卷,包括資料。

當暫存憑證檢查成功後,請按照 ownCloud 的憑證流程操作:停止部署,僅移除範例憑證磁碟區(ocis_full_certs),清除暫存 CA 設置,然後重新開始申請受信任的生產憑證。移除磁碟區之前,請務必確認磁碟區名稱的準確性docker volume ls。請勿移除資料卷或配置磁碟區。

驗證存取權並保護部署

開啟設定的 URL OCIS_DOMAIN。成功意味著瀏覽器透過 HTTPS 存取登入頁面,且沒有憑證警告,並顯示所需服務正在執行。使用 ownCloud 文件中記錄的初始憑證( / ,除非您設定了不同的初始密碼)docker compose ps -a登錄,然後立即變更管理員密碼。adminadmin

如果網站無法存取,請檢查 DNS、連接埠轉送、Traefik 的 ACME 日誌,以及 Infinite Scale 服務日誌。如果登入正常但郵件通知無法接收,請檢查 SMTP 設定。

在儲存重要文件之前,請確認備份涵蓋配置和資料。 Docker 管理的磁碟區便於評估;明確主機路徑更容易放置在單獨的磁碟上,並包含在主機備份中。當 HTTPS 有效、服務在重新啟動後仍能正常運作、管理員登入正常且備份覆蓋所選儲存區域時,即可完成備份。

留下評論

在 ownCloud oCIS 中按使用者角色設定預設儲存配額

在 ownCloud oCIS 中按使用者角色設定預設儲存配額

按角色為新的 ownCloud Infinite Scale 使用者指派基於位元組的儲存限制,並提供 proxy.yaml 範例和安全性驗證清單。

修正 TLS 來源端的 ownCloud 同步憑證錯誤

修正 TLS 來源端的 ownCloud 同步憑證錯誤

透過檢查伺服器主機名稱、憑證鏈、私有 CA 信任和強制入口網站問題,恢復 ownCloud 桌面同步,而無需停用 TLS 驗證。

升級後清除 ownCloud 完整性警告

使用無效文件報告來識別不匹配的核心文件或應用程式簽名,恢復正確的發布文件,並安全地驗證完整性檢查。

使用 Docker Compose 安裝 ownCloud Infinite Scale

從官方 Compose 範例部署 ownCloud Infinite Scale,配置網域和持久存儲,然後驗證 TLS、容器和首次登入。

為 ownCloud Infinite Scale 配置 S3 Blob 存儲

為 ownCloud Infinite Scale 配置 S3 Blob 存儲

設定 S3NG 驅動程式、儲存桶權限、持久性元資料儲存和上傳大小,以便 ownCloud Infinite Scale 可以可靠地儲存檔案內容。

當 ownCloud 上傳進度停滯在 99% 時,請檢查這些限制。

當 ownCloud 上傳進度停滯在 99% 時,請檢查這些限制。

檢查檔案狀態、配額、臨時磁碟空間、PHP 限制和代理逾時,找出 ownCloud 伺服器上傳接近完成時停止的原因。

安全地清除 ownCloud Apache .htaccess 警告

安全地清除 ownCloud Apache .htaccess 警告

僅對 ownCloud 的 Web 根目錄設定 AllowOverride All,驗證活動的 Apache 虛擬主機,然後安全地重新載入以恢復 .htaccess 規則。

設定 ownCloud 企業審計並驗證日誌

啟用 ownCloud 的企業審計應用程序,將 admin_audit 事件路由到受保護的日誌文件,並確認正在記錄真實使用者的操作。

使用 OIDC 將 ownCloud Infinite Scale 連接到 Keycloak

使用 OIDC 將 ownCloud Infinite Scale 連接到 Keycloak

讓 Keycloak 的 realm 頒發者、Web 用戶端和使用者聲明保持一致,以便 ownCloud Infinite Scale 能夠可靠地在 Web 和行動用戶端上登入使用者。

將 ownCloud 檔案轉移給新所有者而不丟失共享份額

使用 ownCloud 的 occ 指令傳輸擁有的檔案和要傳出的共享,以了解哪些內容會保留下來,並在刪除舊帳戶之前驗證存取權限。