取得 Nextcloud 桌面同步功能，擺脫「處理文件」的束縛

如果 Nextcloud 桌面用戶端一直停留在「正在處理檔案」狀態，請開啟帳戶的同步活動，並確定是否有某個檔案反覆出現錯誤，或者用戶端仍在掃描龐大的資料夾樹。首先檢查該文件，然後檢查忽略文件規則和伺服器連線。重新啟動客戶端或許可以暫時解決問題，但刪除同步資料庫或重新建立同步連線應稍後再做，因為這可能會重置選擇性同步設定或觸發大規模重新檢查。

找出真正卡住的是什麼。

在 Windows 或 Linux 系統中，從系統匣開啟 Nextcloud 選單；在 macOS 系統中，從功能表列開啟 Nextcloud 選單，然後查看帳戶狀態。尋找重複的檔案名稱、可見的錯誤訊息或變更的佇列。客戶端會區分同步中、暫停中、離線中、警告中和錯誤中的狀態；藍色活動圖示本身並不代表資料正在上傳。在經典同步模式下，檔案總管介面的圖示可以幫助判斷：藍色表示正在等待或正在進行同步，綠色對勾錶示目前同步，紅色叉號表示錯誤。虛擬文件/文件提供者模式使用不同的作業系統狀態指示器，因此請檢查客戶端視窗和 Finder 或資源管理器中的詳細信息，而不要想當然地認為經典模式的圖標也適用。

如果待處理項目數量減少，請保持用戶端運行並等待掃描完成，尤其是在新增大型資料夾或重新連接裝置之後。如果同一項目仍排在首位，請開啟其錯誤詳情。在移動、重新命名或編輯任何內容之前，請記錄本機路徑和確切的錯誤訊息。避免在隊列變化期間反覆暫停和恢復；這樣做無法發現原因，並且會使進度評估更加困難。

檢查文件和忽略文件規則

當某個檔案阻塞進度時，請在 Nextcloud Web 介面中將其檔案名稱、路徑和本機狀態與伺服器副本進行比較。確認該檔案未在編輯器中開啟、未被相機或備份程式寫入，或未被其他進程鎖定。如果某個應用程式正在修改該文件，請將其正常關閉，並讓客戶端重試。切勿為了清除狀態而刪除任何副本。

某些文件會被故意忽略。 Nextcloud 會排除某些系統檔案以及其他檔案系統中無法辨識的名稱。在用戶端設定中，開啟「進階」→「編輯忽略的檔案」（標籤可能會因客戶端版本而異），並檢查受影響名稱或其父資料夾的自訂模式。通配符（例如 `\n`）*可以匹配多個字元；?`\n` 可以匹配一個字元；末尾的斜杠可以將模式限制為目錄。只有當檔案需要同步時，才應移除或縮小自訂規則的範圍。請勿sync-exclude.lst先嘗試編輯應用程式自帶的全域設定檔；Nextcloud 警告稱，更改此檔案可能會導致意外行為。

同時檢查客戶端的忽略資料夾或未同步資料夾狀態以及選擇性同步設定。即使客戶端重啟，有意排除的資料夾也不會同步。如果問題僅影響特定路徑，可以暫時在一個簡單的資料夾中建立副本進行測試，這有助於區分路徑特定規則和一般連線問題，但請勿在同一個即時同步目錄上使用第二個雲端同步服務。

將客戶端問題與伺服器連線問題區分開來。

在瀏覽器中登入同一個 Nextcloud 帳戶，並確認文件和資料夾可以載入。如果網頁介面可以正常工作，但所有桌面設備都無法訪問，則可能是伺服器的 WebDAV 端點或其配置存在問題。 Nextcloud 用戶端使用 WebDAV 存取伺服器檔案。對於安裝在 `<server_path>` 的伺服器https://cloud.example.com，其 DAV 端點通常為 `<server_path>` https://cloud.example.com/remote.php/dav；請使用您實際的安裝路徑。在瀏覽器中開啟該位址至少應該會提示進行身份驗證或顯示來自端點的回應。如果發生身份驗證失敗、憑證警告或伺服器錯誤，則應聯絡管理員或檢查伺服器日誌，而不是重置本機用戶端。

檢查是否有其他同步程式、備份工具或離線檔案功能也正在管理同一目錄。 Nextcloud 的故障排除手冊指出，不支援使用多個同步應用程式同步相同目錄，這樣做可能會導致資料遺失。只有在確定哪個應用程式擁有該資料夾並保留本機變更後，才能移除重疊的同步項目。如果只有一台電腦受到影響，請檢查本機磁碟空間、資料夾權限、防毒軟體或即時掃描設置，以及用戶端是否可以讀取和重新命名同步目錄中的檔案。

重新啟動後，收集有用的診斷資訊。

1. 等待所有正在進行的文件操作完成，然後從系統匣或功能表列關閉桌面用戶端。重新啟動客戶端，觀察待處理計數是否有變化。
2. 如果用戶端仍然卡頓，請開啟其設置，然後選擇「進階」→「建立偵錯檔案…」以儲存診斷存檔。此控制項的具體位置可能因版本和平台而異。
3. 查看狀態停止變更前後一段時間的日誌。尋找受影響的路徑以及重複出現的錯誤，例如存取被拒絕、連線失敗或檔案名稱限制。

調試歸檔文件包含日誌和資料庫信息，可能包含敏感的文件名、帳戶詳細信息或伺服器地址。請在與技術支援人員分享之前，請仔細檢查並刪除敏感資訊。 Nextcloud 故障排除文件介紹了偵錯歸檔檔案以及其他擷取用戶端日誌的方法。

僅當出現匹配錯誤時才使用資料庫重置。

不要為了修復通用的「正在處理檔案」狀態而例行刪除客戶端的同步資料庫。 Nextcloud 針對特定的「CSync 未知錯誤」提供了更具體的解決方法：停止客戶端，找到.sync_xxxxxxx.db客戶端配置的帳戶資料夾中的隱藏文件，刪除該資料庫後再重新啟動。文件提醒，此操作也會清除一些關於要下載的文件的設定。請先備份本機同步資料夾並記錄選擇性同步設定；切勿在客戶端執行時刪除資料庫。如果未出現完全相同的錯誤，請先檢查偵錯存檔或聯絡技術支持，然後再嘗試此恢復方法。

確認同步已恢復

變更後，除了檢查載入指示器是否消失外，還應檢查以下內容：待處理佇列應清空，客戶端應顯示已更新且已連線的狀態，且一個小型測試檔案應出現在本機和 Web 介面上的預期位置。確認最初受影響的檔案包含預期內容，且選擇性同步資料夾的配置保持不變。如果同一文件再次出現問題，請保存完整的錯誤資訊以及經過編輯的調試存檔；如果問題反覆出現，例如權限、文件名、WebDAV 或用戶端版本問題，則需要進行針對性修復。

如需目前用戶端控制和故障排除步驟，請參閱Nextcloud 桌面用戶端使用者手冊和Nextcloud 桌面故障排除文件。目前線上使用手冊適用於 Nextcloud 36；用戶端標籤和可用的虛擬檔案功能可能會因桌面用戶端版本和作業系統而異。