使用 Let's Encrypt 和 Nginx 將 ownCloud 部署到 HTTPS。
選擇 HTTP-01 或 DNS-01,設定 ownCloud 反向代理,並驗證 Certbot 是否自動續訂 HTTPS 憑證。
在 ownCloud 伺服器前端的反向代理處終止 TLS 連接,然後使用 Certbot 取得並續訂 Let's Encrypt 憑證。對於單一公網主機名,如果代理可以接受 80 連接埠的入站連接,那麼使用 Nginx 並啟用 HTTP-01 挑戰通常是最簡單的方案。如果 80 連接埠無法開放,或者您需要通配符證書,則應使用 DNS-01 並整合自動化 DNS 服務。
本文針對執行在同一 Linux 主機上的 Docker 容器和 Nginx 伺服器中的 ownCloud Classic Server 11 進行示範。目前的 ownCloud 文件將 TLS 請求指向代理伺服器。這些介面範例使用佔位符主機名,請替換為您自己的主機名稱。
如果您已經執行了一個 TLS 終止代理,請繼續在該代理上管理證書,而無需新增另一個代理程式。 Certbot 的 Nginx 外掛程式會取得憑證並編輯虛擬主機,但會變更您的 Nginx 設定。如果您希望自行管理 Nginx 配置,請使用 Certbot 的僅憑證模式,並手動將憑證路徑配置到您的代理程式中。
| 選擇 | 最佳匹配 | 主要權衡 |
|---|---|---|
| 使用 Nginx 和 Certbot 的 HTTP-01 協議 | 一個公開的單主機名,允許入站 TCP 連接埠 80 存取。 | 簡單來說,它不需要 DNS API 金鑰;它依賴正確的公共 DNS 解析和 80 連接埠的可及性。它無法頒發通配符證書。 |
| DNS-01 附有 DNS 提供者插件 | 連接埠 80 已關閉、服務為私人服務,或您需要通配符。 | 無需公開網路驗證即可運作,但自動續期需要 DNS API 存取權限。請使用範圍較小的憑證並妥善保管。 |
| 現有代理商的 ACME 集成 | 代理伺服器已經為其他網站管理憑證。 | 活動部件更少;續訂行為和配置是特定於該代理的。 |
Let's Encrypt 的可選 tlsserver 設定檔於 2026 年 5 月 13 日開始頒發 45 天有效期的憑證;其預設的經典憑證有效期仍為 90 天,直到 2027 年 2 月 10 日才改為 64 天。 Certbot 經常安排續約;請確認您的續約安排。

cloud.example.com指向伺服器的公用 IPv4 位址。只有當 IPv6 能夠正確存取相同代理伺服器時,才會新增 AAAA 記錄。在主機防火牆以及任何雲端防火牆或路由器中,允許入站 TCP 80 連接埠用於 HTTP-01 驗證,並允許 TCP 443 連接埠用於使用者的 HTTPS 連接。從網路外部檢查 DNS。.env檔案中,取代範例主機名稱並設定相關值:OWNCLOUD_DOMAIN=cloud.example.com
OWNCLOUD_TRUSTED_DOMAINS=cloud.example.com
OWNCLOUD_OVERWRITE_CLI_URL=https://cloud.example.com
OWNCLOUD_OVERWRITE_HOST=cloud.example.com
OWNCLOUD_OVERWRITE_PROTOCOL=https
OWNCLOUD_TRUSTED_PROXIES=PROXY_SOURCE_IP
HTTP_PORT=127.0.0.1:8080
PROXY_SOURCE_IP這是一個佔位符:請使用 ownCloud 實際看到的代理位址,而不是假定的回環位址。 Docker 網路會改變 ownCloud 看到的來源位址。僅信任代理地址或所需的最小地址集;廣泛的信任會導致客戶端偽造轉發的資訊。官方 Compose 範例將 ownCloud 發佈在 8080 連接埠;將主機端綁定到回環位址可以防止應用程式的 HTTP 監聽器在提供的連接埠對映中使用公共介面${HTTP_PORT}:8080。如果您的 Nginx 位於容器中,請使用私有共用的 Docker 網路及其服務位址,而不是此主機回環範例。
保留您現有的資料庫、Redis 和磁碟區設定。編輯檔案後,重新建立 ownCloud 服務,使其讀取更新後的環境docker compose up -d owncloud:

server {
listen 80;
server_name cloud.example.com;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
使用發行版自帶的 Nginx 設定啟用站點,然後檢查並重新載入 Nginx sudo nginx -t。sudo systemctl reload nginx網站啟用路徑因發行版而異。確保 ACME HTTP 質詢路徑可存取;在頒發憑證時,請勿在質詢路徑前設定驗證閘或全域重新導向規則。

sudo certbot --nginx -d cloud.example.com --redirect
Certbot 的 Nginx 安裝程式會取得憑證並設定 HTTPS 和 HTTP 到 HTTPS 重新導向。請在接受變更前檢查 Nginx 的變更。如果您希望 Certbot 在不編輯 Nginx 的情況下頒發證書,請使用 `--certbot-install-certificate-file` 命令,然後使用生成的 `--certbot-install -certificate- file`sudo certbot certonly --nginx -d cloud.example.com和 `--certbot-install-certificate-install` 路徑手動配置 TLS 路徑,並重新載入 Nginx。切勿發布或貼上私鑰檔案。fullchain.pemprivkey.pem
從外部網路開啟https://cloud.example.com。確認瀏覽器報告有效的證書,ownCloud 載入時沒有重定向循環,並且產生的連結使用 HTTPS。如果 ownCloud 報告不受信任的網域名稱或產生 HTTP 鏈接,請檢查 `<host>`、`<host>` 、OWNCLOUD_TRUSTED_DOMAINS` <host>` 和受信任的代理位址。OWNCLOUD_OVERWRITE_HOSTOWNCLOUD_OVERWRITE_PROTOCOL
sudo certbot renew --dry-run
sudo systemctl list-timers --all | grep -i certbot
成功的試運行會檢查續訂路徑,而不會取代現有憑證。 Nginx 安裝程式應透過其續訂整合部署續訂後的憑證;如果您使用僅憑證模式或 Web 根模式,請確保您的續訂設定會在續訂成功後重新載入 Nginx。 Certbot 文件中提供了用於此目的的續訂部署鉤子。安裝或遷移後,請再次檢查調度程序,並在續訂失敗時發出警報,而不是依賴人工手動續訂。
對於 DNS-01,請使用 DNS 提供者提供的插件,建立一個僅限於需要變更的記錄的 API 令牌,並使用相同的 Certbot 試運行來測試自動續約。 Let's Encrypt 指出,DNS-01 支援通配符名稱和非公開服務,但警告稱,Web 伺服器上的廣泛 DNS 憑證會增加安全漏洞的影響。
有關版本特定詳情,請參閱ownCloud Server 11 Docker 安裝指南、反向代理配置和環境變數參考。有關驗證和續約選項,請參閱 Let's Encrypt 的挑戰文件、憑證有效期表以及適用於您作業系統的 Certbot 說明。

選擇 HTTP-01 或 DNS-01,設定 ownCloud 反向代理,並驗證 Certbot 是否自動續訂 HTTPS 憑證。
在部署之前,配置 oCIS LDAP 登錄,調整使用者和群組查找,並驗證 TLS 和架構設定。
將 Amazon S3 儲存桶新增至 ownCloud 10,準備相容的憑證和端點,並檢查存取權限,避免將掛載點與主儲存點混淆。
為 ownCloud Server 安排受保護的 MariaDB 轉儲,安全地處理維護模式,並在依賴每個備份之前進行驗證。
使用支援的應用程式、有序的命令、身份驗證以及需要單獨處理的資料的明確列表,規劃 ownCloud 10 到 oCIS 的遷移。
使用主題應用程式取代 ownCloud Classic 10 標誌並調整 Web UI 顏色,同時避免升級和完整性檢查陷阱。
按角色為新的 ownCloud Infinite Scale 使用者指派基於位元組的儲存限制,並提供 proxy.yaml 範例和安全性驗證清單。
透過檢查伺服器主機名稱、憑證鏈、私有 CA 信任和強制入口網站問題,恢復 ownCloud 桌面同步,而無需停用 TLS 驗證。
使用無效文件報告來識別不匹配的核心文件或應用程式簽名,恢復正確的發布文件,並安全地驗證完整性檢查。
從官方 Compose 範例部署 ownCloud Infinite Scale,配置網域和持久存儲,然後驗證 TLS、容器和首次登入。