使用正確的後端解決 ownCloud 檔案鎖定逾時問題
區分資料庫鎖定和過期的 WebDAV 鎖定,然後選擇並設定正確的 ownCloud 10 修復程式。
當 ownCloud 報告檔案鎖定逾時時,請勿立即刪除資料庫鎖定行或停用鎖定。首先要確定該訊息指的是檔案操作期間的交易鎖定,還是使用者建立的具有過期時間的 WebDAV 鎖。對於重複出現的交易鎖定逾時,對於繁忙的伺服器,通常可行的解決方案是將鎖定快取從資料庫遷移到 Redis;對於低流量部署,如果資料庫後端運作狀況良好,則可以保留資料庫後端。
事務性檔案鎖定可在 ownCloud 處理上傳、同步、移動和其他變更時保護檔案。預設情況下啟用此功能,除非配置了鎖定緩存,否則鎖定資訊會儲存在資料庫中。因此,資料庫速度慢或過載可能會導致檔案操作等待。 ownCloud Server 10.16 指南建議使用 Redis 進行外部事務鎖定,以降低資料庫負載。
手動檔案鎖定有所不同:使用者主動鎖定檔案以防止其他使用者修改,而 WebDAV 鎖定功能則設定了過期時間。在 ownCloud Server 10.16 中,管理員可以設定預設和最大超時時間,並定義解鎖群組。操作:在套用修復程式之前,請使用日誌訊息、受影響的檔案以及使用者是否看到鎖定指示器來確定鎖定機制。
類似 MySQL 的「鎖定等待逾時」這樣的訊息可能表示資料庫事務正在等待另一個事務,而不是使用者鎖定過期。同樣,「Redis 斷開連線」指的是 Redis 連線問題,而不是檔案過期。操作:檢查 ownCloud 日誌和資料庫/Redis 日誌中相同時間戳記的日誌;不要將所有「鎖」錯誤都視為同一個問題。
| 情況 | 務實的選擇 | 權衡 |
|---|---|---|
| 私有、低流量家庭伺服器 | 在調查資料庫健康狀況期間,請保持資料庫鎖定。 | 需要管理的服務減少了,但鎖定活動增加了資料庫工作量。 |
| 繁忙的單一伺服器 | 配置 Redis 進行鎖定;如果可用,請使用 APCu 作為本機快取。 | 減少資料庫的鎖定負載,但 Redis 及其 PHP 擴充功能必須保持可用。 |
| 多個應用程式伺服器 | 使用每個 Web 節點均可存取的共用 Redis 端點 | 支援通用鎖定快取;Redis 網路存取、身份驗證和可用性成為運維依賴項。 |
ownCloud 文件指出 Memcached 無法提供事務性文件鎖定所需的持久鎖定機制,因此請勿將其設定memcache.locking為 Memcached。 Redis 是此角色的首選方案。操作:如果您已使用 Memcached 進行分散式緩存,請將該功能獨立出來,並專門配置 Redis 以實現鎖定機制。
確認 Redis 已安裝、正在運行、可從 PHP Web Worker 訪問,並已根據您的網路設計進行保護。 PHP Redis 擴充功能也必須可供 Web 執行階段使用;僅檢查命令列 PHP 可能無法證明 Apache 或 PHP-FPM 使用了相同的擴充。對於本地 Redis 實例,ownCloud 的文檔支援 TCP 或 Unix 套接字。在叢集中,所有應用程式節點必須指向同一個 Redis 鎖定服務,而不是指向不同的本機 Redis 資料庫。
編輯前,請備份config/config.php並記錄所有現有的本機或分散式快取設定。不要將刷新整個 Redis 資料庫作為常規的第一步:這可能會刪除無關的快取資料或會話,具體取決於 Redis 的共享方式。操作:在維護之前,確定 Redis 資料庫索引以及其他應用程式是否正在使用該 Redis 實例。
將下列條目新增或合併至config/config.php. 請勿建立重複的 PHP 陣列鍵;請更新現有條目。此範例使用同一主機上的 TCP 協定運行 Redis:
'filelocking.enabled' => true,
'memcache.locking' => '\OC\Memcache\Redis',
'redis' => [
'host' => '127.0.0.1',
'port' => 6379,
'timeout' => 0,
'password' => 'replace-with-your-redis-secret',
'dbindex' => 0,
],
使用與您的部署環境相符的 Redis 主機、連接埠、密碼、資料庫索引和套接字路徑。將 Redis 限制為僅供受信任的本地或私有網路用戶端訪問,切勿將其公開。對於 Unix 套接字,ownCloud 的範例使用套接字路徑,並將其host設定port為0。 Web 伺服器使用者必須擁有存取該套接字的權限。
僅當安裝設定程序需要時才重新啟動或重新載入相關的 PHP/Web 服務。然後檢查管理概覽和 ownCloud 日誌,查看是否有快取或鎖定異常。操作:在確認變更完成之前,請使用測試帳戶進行小規模的上傳、重新命名和同步操作。
如果使用者建立的鎖定持續時間過長,請檢查「設定」>「管理」>「常規」下的「手動檔案鎖定」設定。 ownCloud 10.16 文件中occ提供了設定預設和最大 WebDAV 鎖定持續時間的範例:
sudo -u www-data ./occ config:app:set files lock_timeout_default --value 1800
sudo -u www-data ./occ config:app:set files lock_timeout_max --value 86400
這些值以秒為單位。範例中的預設值並非適用於所有策略;請選擇與使用者實際需要持有鎖的時間相符的持續時間。對於真正被放棄的鎖,鎖的擁有者或許可以從文件詳細資料視圖解鎖。管理員還可以配置一個解鎖組。建議:優先使用支援的 UI/API 或基於群組的復原路徑,而不是直接編輯 WebDAV 鎖定記錄。
更改後,請驗證上傳和同步操作是否完成,同時編輯是否會導致檔案損壞,以及日誌是否不再顯示重複出現的鎖定後端逾時。如果日誌現在報告 Redis 連線失敗,請修復 Redis 可用性、憑證、擴充功能載入或套接字權限問題;在不了解故障原因的情況下重複切換可能會掩蓋根本原因。
請勿停用交易鎖定以消除逾時問題。交易鎖定可保護檔案操作,移除交易鎖定可能會在並發活動下造成完整性問題。除非 ownCloud 支援文件針對特定故障指示您這樣做,否則請勿從鎖定表中刪除資料庫行或刷新共享的 Redis 資料庫。操作:如果在確認已配置的後端及其運行狀況後問題仍然存在,請捕獲帶有時間戳的 ownCloud 和後端日誌,並與您的管理員一起調查緩慢的資料庫查詢或鎖定爭用問題。
區分資料庫鎖定和過期的 WebDAV 鎖定,然後選擇並設定正確的 ownCloud 10 修復程式。
透過有針對性的檢查,追蹤 ownCloud Web 空白畫面的原因,包括瀏覽器快取、缺少 Web 資源、服務錯誤或反向代理 URL 設定。
設定 ownCloud 的 Web PHP 記憶體限制,重新啟動對應的服務,並驗證活動值,不要將其與 CLI 設定或上傳限制混淆。
找出 MySQL、PHP、套接字設定或資料庫權限是否阻止了 ownCloud 10 的運行,然後驗證安全修復方案。
在 ownCloud Classic 中強制設定公共連結過期時間,設定最長有效期,並檢查可能需要單獨清理的現有共享。
透過 Keycloak 啟用 TOTP,安全地註冊用戶,並了解 Infinite Scale 的路由級 MFA 設定何時適用。
檢查問題是否為 OC10 和 7.x 的相容性問題,或 CSync 日誌損壞,然後套用正確的修復方法,不要刪除已同步的檔案。
選擇 HTTP-01 或 DNS-01,設定 ownCloud 反向代理,並驗證 Certbot 是否自動續訂 HTTPS 憑證。
在部署之前,配置 oCIS LDAP 登錄,調整使用者和群組查找,並驗證 TLS 和架構設定。
將 Amazon S3 儲存桶新增至 ownCloud 10,準備相容的憑證和端點,並檢查存取權限,避免將掛載點與主儲存點混淆。