排查 ownCloud 10 MySQL 連線故障

當 ownCloud 10 報告「無法連接資料庫」時,首先要確定 MySQL 是否無法存取、帳戶被拒絕,或缺少 PHP 驅動程式。檢查資料庫服務以及 ownCloud 中儲存的主機名稱、資料庫名稱和使用者名稱是否正確config/config.php;然後在變更授權或重新建立任何內容之前,先從 ownCloud 伺服器測試這些憑證。本指南適用於使用 MySQL 或 MariaDB 的 ownCloud Server 10.16。選單標籤和軟體包命令可能會因作業系統和安裝方法而異。

了解錯誤訊息的含義

「資料庫連線失敗」是一則通用訊息。 ownCloud 日誌或 Web 伺服器日誌中更具體的 MySQL 或 PHP 錯誤通常會指出問題根源。例如,MySQL 錯誤 2002 或 2003 等連線錯誤通常表示服務已停止、套接字或連接埠錯誤、網路路徑被阻塞,或伺服​​器未在 ownCloud 預期的位置監聽。 「存取被拒絕」訊息通常表示 MySQL 已收到連接,但不接受該使用者名稱、密碼或用戶端主機。

MySQL 指的是資料庫伺服器;MariaDB 是 ownCloud 支援的相容資料庫選項。 PDO MySQL 是 PHP 資料庫驅動程序,它允許 ownCloud 與 MySQL 或 MariaDB 進行通訊。操作:請記下完整的錯誤文字和時間戳,然後將其與以下檢查進行比對,而不是將每次連線失敗視為密碼錯誤。

更改設定前請做好準備

  • 確認 ownCloud 和 MySQL 是在同一台機器上運行、在不同的機器上運行,還是在單獨的容器中運行。
  • 了解 ownCloud 安裝路徑、資料庫主機、連接埠或套接字、資料庫名稱和專用資料庫使用者名稱。
  • 請確保管理員會話或控制台存取權限可用。config/config.php編輯前請務必備份,切勿在支援請求中發布資料庫密碼。
  • 僅在必要時以管理員身份執行命令。請將範例名稱和路徑替換為您實際安裝的值。

請勿在初始故障排除步驟中刪除或重新建立資料庫:現有使用者檔案和元資料依賴該資料庫。操作:在進行任何資料庫層級的變更之前,請務必對 ownCloud 資料目錄和資料庫進行已驗證的備份。

檢查資料庫服務和連線路徑

  1. 檢查 MySQL 或 MariaDB 是否正在運作。在 systemd Linux 主機上,使用系統上安裝的服務名稱檢查服務:
sudo systemctl status mysql
sudo systemctl status mariadb

您的發行版中可能不存在某個服務名稱。如果該服務已停止,請檢查其日誌和資料庫錯誤日誌以尋找原因,然後再重新啟動它。操作:在排查 ownCloud 憑證問題之前,請先解決啟動錯誤,例如磁碟已滿或資料庫配置無效。

  1. 檢查 ownCloud 伺服器的主機和連接埠。測試與資料庫主機和連接埠(通常為 3306)的 TCP 連線。對於遠端資料庫,請確認名稱解析、防火牆規則以及 MySQL 監聽的介面是否可從 ownCloud 伺服器存取。請勿將 3306 連接埠直接暴露給網際網路。
  2. 了解本機主機套接字的差異。在類別 Unix 系統中,MySQL 用戶端連接到資料庫時localhost通常使用本機 Unix 套接字,127.0.0.1強制使用 TCP 協定。當資料庫位於本機,但 PHP 和 MySQL 使用不同的套接字路徑時,這一點尤其重要。解決方法:將套接字路徑和主機設定與資料庫伺服器的實際配置進行比較,或者如果 TCP 是預期路徑,則特意測試 TCP 連線。

使用與 ownCloud 相同的資料庫使用者名稱、主機名稱和資料庫名稱,從 ownCloud 伺服器進行測試登入:

mysql --protocol=TCP -h db.example.net -P 3306 -u oc_user -p owncloud

請在提示字元處輸入密碼;不要直接在命令中輸入密碼,否則密碼可能會被儲存到 shell 歷史記錄中。對於本機套接字連接,請測試與您的配置相符的主機和套接字模式。登入成功證明 MySQL 接受該連線路徑和帳戶,但並不能證明 PHP 擁有其驅動程式或 ownCloud 正在讀取相同的設定。操作:如果此命令失敗,請使用 MySQL 錯誤訊息選擇下一步檢查。

驗證 ownCloud 設定、PHP 驅動程式和權限

ownCloud 的安裝精靈會將資料庫類型、資料庫名稱、使用者名稱、密碼、主機和表格前綴寫入設定檔config/config.php。請仔細檢查這些數值,切勿將密碼複製到日誌或聊天記錄中。設定檔中dbhost可能包含主機和連接埠;如果顯示“” localhost,請檢查 PHP 進程是否可以使用預期的套接字。

如果命令列用戶端運行成功但 ownCloud 仍然失敗,請驗證 Web 伺服器使用的 PHP 運行時是否已pdo_mysql安裝並啟用。類似 `php-run` 這樣的 shell 指令php -m只會報告 CLI 的 PHP 執行時,這可能與 Apache 或 PHP-FPM 不同。操作:檢查活動的 Web PHP 配置,並在啟用擴充功能後重新啟動相關的 Web/PHP 服務。

對於「存取被拒絕」錯誤,請檢查 MySQL 中是否存在與使用者名稱和資料庫所見客戶端主機位址均相符的帳戶。 MySQL 會將諸如 `<username>` 和 `<clienthost>` 之類的帳號視為'oc_user'@'localhost'不同的帳號'oc_user'@'10.0.0.5'。如果 ownCloud 應用程式位於容器中,資料庫可能看到的是容器或橋接位址,而不是 ` <username> localhost`。操作:請資料庫管理員檢查符合的帳戶和權限;僅允許來自需要存取權限的 ownCloud 主機或網路的存取權限。

確認資料庫存在且 ownCloud 帳戶可以存取該資料庫。避免授予全域權限或在 ownCloud 中使用 MySQL root 帳號。所需的權限取決於這是首次安裝還是現有實例。操作:請依照 ownCloud 針對特定階段的資料庫設定指南進行操作,切勿變更無關資料庫的所有權或權限。

應用修正並驗證修正效果

僅修改測試中發現的設定:啟動資料庫服務、使用可存取的主機名稱和連接埠、修復套接字不符、啟用 PHP 驅動程式、修復帳戶密碼或調整特定於主機的資料庫授權。如果您要編輯config/config.php,請保持有效的 PHP 語法並先進行備份。切勿憑猜測更改資料庫名稱、表前綴或憑證。

更改後,重新載入 ownCloud 並確認頁面載入成功,不再出現資料庫連線警告。檢查 ownCloud 日誌,確認是否有成功的請求,並確保使用者可以瀏覽現有文件。如果 MySQL 報告「伺服器已斷線」而非連線被拒絕,則表示有其他問題,例如連線中斷、連線逾時或封包大小限制;ownCloud 文件中提供了針對這種情況的 MySQL 逾時和封包大小設定。操作:請參考對應的資料庫故障排除指南,僅當日誌支援該診斷結果時才變更伺服器限制。

ownCloud 目前 Server 10.16 的文件建議使用安裝精靈進行常規資料庫設置,並特別強調了pdo_mysqlMySQL 套接字路徑作為檢查項目。具體的軟體包名稱、PHP 版本和服務名稱取決於主機。操作:最後,從 ownCloud 伺服器重複連接測試,並確認應用程式可以讀取其現有資料。

官方參考資料

留下評論

使用正確的後端解決 ownCloud 檔案鎖定逾時問題

區分資料庫鎖定和過期的 WebDAV 鎖定,然後選擇並設定正確的 ownCloud 10 修復程式。

ownCloud Web 開啟後出現空白頁面時應該檢查什麼

ownCloud Web 開啟後出現空白頁面時應該檢查什麼

透過有針對性的檢查,追蹤 ownCloud Web 空白畫面的原因,包括瀏覽器快取、缺少 Web 資源、服務錯誤或反向代理 URL 設定。

在正確的運行時清除 ownCloud PHP 記憶體警告

設定 ownCloud 的 Web PHP 記憶體限制,重新啟動對應的服務,並驗證活動值,不要將其與 CLI 設定或上傳限制混淆。

排查 ownCloud 10 MySQL 連線故障

找出 MySQL、PHP、套接字設定或資料庫權限是否阻止了 ownCloud 10 的運行,然後驗證安全修復方案。

為 ownCloud 公共連結設定嚴格的過期時間

為 ownCloud 公共連結設定嚴格的過期時間

在 ownCloud Classic 中強制設定公共連結過期時間,設定最長有效期,並檢查可能需要單獨清理的現有共享。

使用 Keycloak 為 ownCloud Infinite Scale 新增 TOTP 雙重登錄

使用 Keycloak 為 ownCloud Infinite Scale 新增 TOTP 雙重登錄

透過 Keycloak 啟用 TOTP,安全地註冊用戶,並了解 Infinite Scale 的路由級 MFA 設定何時適用。

透過將客戶端與伺服器匹配來恢復 ownCloud 同步

檢查問題是否為 OC10 和 7.x 的相容性問題,或 CSync 日誌損壞,然後套用正確的修復方法,不要刪除已同步的檔案。

使用 Let's Encrypt 和 Nginx 將 ownCloud 部署到 HTTPS。

使用 Let's Encrypt 和 Nginx 將 ownCloud 部署到 HTTPS。

選擇 HTTP-01 或 DNS-01,設定 ownCloud 反向代理,並驗證 Certbot 是否自動續訂 HTTPS 憑證。

將 ownCloud Infinite Scale 連接到 LDAP 以實現使用者登入

在部署之前,配置 oCIS LDAP 登錄,調整使用者和群組查找,並驗證 TLS 和架構設定。

將 S3 儲存桶連接到 ownCloud 10 作為外部存儲

將 S3 儲存桶連接到 ownCloud 10 作為外部存儲

將 Amazon S3 儲存桶新增至 ownCloud 10,準備相容的憑證和端點,並檢查存取權限,避免將掛載點與主儲存點混淆。