修正 ownCloud 桌面同步用戶端中的「SSL 憑證驗證失敗」問題

即使伺服器在瀏覽器中看起來可以訪問，ownCloud 桌面用戶端也可能停止同步並報告 SSL 憑證驗證失敗。此訊息表示客戶端無法確認 HTTPS 伺服器憑證對於伺服器位址是否有效，以及是否受客戶端環境信任。這是 TLS 身份驗證問題，而非密碼錯誤。重複接受未經驗證的證書可能會導致帳戶憑證和文件被攔截。

首先檢查伺服器位址、憑證有效期和憑證鏈。盡可能在伺服器或其反向代理上更正這些資訊。如果伺服器有意使用私有憑證授權單位 (CA)，請將該 CA 的已驗證根憑證新增至電腦的受信任儲存區。然後重新啟動桌面用戶端，並確認同步恢復且不再出現憑證警告。

首先檢查您使用的 ownCloud 客戶端和伺服器。

ownCloud 目前同時提供 ownCloud Classic Server（版本 10 和 11）和 ownCloud Infinite Scale (oCIS)。兩者並非可以互換使用所有桌面應用程式版本。截至 ownCloud 下載頁面 2026 年 9 月 1 日的列表，桌面應用程式 7.1.1 適用於 Infinite Scale，而 ownCloud Classic 則支援 6.x 用戶端；該頁面列出的 Classic 版本為 6.0.3。如果用戶端最近進行了升級，且後端為 ownCloud Server 10 或 11，請在將連線失敗視為憑證故障之前，先檢查相容性。

同時，請確認同步帳戶中配置的確切 URL。該 URL 中的主機名稱必須與伺服器憑證中的名稱相符。對於安裝在特定路徑下的 Classic 伺服器，帳戶可能類似於 `<path>` https://cloud.example.com/owncloud；oCIS 安裝可能使用不同的基本 URL。請使用管理員配置的位址，而不是在主機名稱、IP 位址和備用網域名稱之間切換。

依序分析可能的原因。

1. 檢查日期、網路和確切的伺服器名稱

請確保計算機的日期、時間和時區設定正確。時鐘設定錯誤會導致目前有效的憑證顯示為已過期或尚未生效。接下來，在同一台電腦的瀏覽器中開啟同步帳戶中指定的 ownCloud URL。檢查證書詳細信息，包括主機名稱、到期日期和頒發者。如果瀏覽器能夠正常載入頁面且未顯示任何警告，這是一個有用的線索，但這並不能證明桌面用戶端使用相同的憑證存儲，也不能證明每個 WebDAV 請求都遵循相同的代理路徑。

如果故障僅出現在飯店、機場、學校或公共 Wi-Fi 網路上，請完成該網路的登入入口網站並重試。 ownCloud 桌面應用程式的發行說明中提到，當強制入口網站導致憑證不符時，應暫停同步，然後在清除入口網站後重新啟動同步。入口網頁攔截 HTTPS 並非信任意外憑證的理由。

2. 檢查伺服器提供的證書

請伺服器管理員驗證公共端點（包括終止 HTTPS 的 Web 伺服器或反向代理）上的 TLS 憑證。此證書應為有效證書，包含用戶端使用的確切 DNS 名稱，並包含所需的中間證書。常見的部署錯誤是僅配置了葉憑證而非完整的憑證鏈。如果證書最近續期，請確保反向代理提供的是新證書而非過期證書。

在安裝了 OpenSSL 的系統上，您可以使用下列指令檢查 TLS 握手程序並核對主機名稱。請將範例名稱替換為 ownCloud 主機名，無需包含 URL 路徑：

openssl s_client -connect cloud.example.com:443 \
  -servername cloud.example.com \
  -verify_hostname cloud.example.com \
  -verify_return_error </dev/null

檢查驗證結果和證書日期。此測試會檢查執行它的電腦上的端點；它不會重現桌面用戶端信任儲存區的所有細節。如果輸出結果顯示憑證過期、主機名稱不符、缺少頒發者或 CA 不受信任，請在 TLS 端點處修正憑證或憑證鏈，然後再次測試。切勿嘗試透過在每台桌面上安裝不相關的憑證來修復伺服器端的主機名稱或憑證鏈問題。

3. 當伺服器是公有伺服器時，請使用公有信任的憑證。

對於面向互聯網的 ownCloud 服務，最直接的解決方案通常是使用由當前作業系統信任的公共 CA 頒發的憑證。為公用主機名稱設定 HTTPS 端點，並驗證憑證續訂是否正常運作。如果 HTTPS 由反向代理處理，則憑證應位於該代理程式上；僅變更 ownCloud 應用程式設定不會變更用戶端收到的憑證。

管理員更新端點後，請使用與受影響電腦相同的網絡，測試主機名稱。瀏覽器和命令列檢查應不再報告憑證警告，ownCloud 用戶端應在重試或重新啟動後重新連線。如果只有部分電腦仍然出現故障，請比較它們的作業系統更新、信任儲存、代理設定和用戶端版本。

4. 僅當伺服器預期使用私有 CA 時才信任該 CA。

組織通常會為私有 ownCloud 服務使用內部 CA。在這種情況下，請透過已認證的管道取得組織的根 CA 證書，並與管理員驗證其指紋。使用作業系統憑證管理流程或企業託管裝置策略，在每台受影響的用戶端電腦上安裝根 CA。不要因為同步用戶端提供了從警告頁面下載的憑證就將其新增為根憑證；請先驗證該憑證是否屬於目標 CA。

Windows 系統：管理員可以使用 Microsoft 管理主控台中的「憑證」管理單元，將已驗證的根憑證匯入到對應的「受信任的根憑證授權單位」儲存區。請遵循組織策略，確定信任是針對每個使用者還是整台電腦。
macOS：使用「鑰匙串存取」將已驗證的憑證新增至對應的鑰匙串，並查看其信任設定。 Apple 文件介紹如何將憑證檔案新增至鑰匙圈；受管理的 Mac 應透過組織的裝置管理流程取得私有根憑證。
Ubuntu：對於 PEM 格式的 CA 證書，請將.crt檔案放置在指定位置/usr/local/share/ca-certificates/並執行命令sudo update-ca-certificates。這將更新使用該憑證的應用程式的系統信任儲存區。 Ubuntu 提醒，Snap 應用程式可能不會自動使用新增至主機儲存區的證書，因此受限軟體套件可能需要特定於軟體套件的信任解決方案。

更新信任設定後，請重新啟動 ownCloud 桌面用戶端。客戶端軟體包和作業系統可能會影響其讀取的憑證儲存區。如果已安裝憑證授權單位 (CA) 且瀏覽器信任該站點，但桌面應用程式仍然無法正常運作，請檢查用戶端軟體套件的信任行為和日誌，而不是隨意匯入多個伺服器憑證副本。

不要將桌面信任與 ownCloud 伺服器憑證匯入混淆。

ownCloud 伺服器有一個occ security:certificates命令，用於管理伺服器本身必須信任的證書，例如用於聯合身份驗證或外部儲存的證書。這是一個伺服器端信任儲存區。它不會修復使用者桌面同步用戶端連接到 ownCloud 網站時做出的信任決策。如果出現桌面驗證錯誤，請修復 HTTPS 端點或受影響電腦的信任配置。

請勿將禁用證書驗證作為永久性解決方案。 ownCloud 命令列用戶端文件中提供了此--trust選項，但抑製或接受驗證失敗並不能修復憑證過期、主機名稱錯誤、CA 鏈缺失或不受信任的連線等問題。此類信任控制措施僅應在經過驗證的測試計劃下使用，切勿將其作為生產同步帳戶上正確 TLS 配置的替代方案。

確認同步正常

修正憑證或信任庫後，關閉並重新開啟 ownCloud Desktop 用戶端。
確認帳戶狀態從 SSL 或重新連線錯誤變為已連線或正在同步狀態，且沒有新的憑證警告。
在同步資料夾中建立一個小型測試文件，並確認它出現在伺服器上。然後在網頁介面中進行少量更改，並確認更改已同步到桌面。
如果狀態仍然不明確，請查看用戶端日誌以確認 HTTPS/WebDAV 連線是否成功。 ownCloud 5.3 故障排除指南中介紹如何開啟“進階”>“日誌設定”，或使用 F12、Ctrl+L 或 Cmd+L 顯示日誌視窗。其他客戶端版本的選單名稱可能有所不同。

如果網站可以打開，但 TLS 檢查通過後同步仍然無法連接，請繼續檢查 WebDAV 和伺服器配置。 ownCloud 桌面應用程式使用 WebDAV 連接 ownCloud Classic；供應商的故障排除指南建議，當所有用戶端都無法連接但瀏覽器存取正常時，檢查 WebDAV 端點是否可存取。如果憑證錯誤已消失，但登入或同步仍失敗，請調查日誌中顯示的其他驗證、反向代理程式或 WebDAV 錯誤。