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

當 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 以實現鎖定機制。

在更改 ownCloud 之前,請先檢查 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 實例。

使用 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 和後端日誌,並與您的管理員一起調查緩慢的資料庫查詢或鎖定爭用問題。

官方參考資料

留下評論

使用正確的後端解決 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,準備相容的憑證和端點,並檢查存取權限,避免將掛載點與主儲存點混淆。