修復 RcloneView 中的 Rclone 設定檔損毀與修復問題

2026年4月6日 · 閱讀時間約 8 分鐘

Senior Engineer

損毀的 rclone 設定檔可能導致您所有的雲端遠端全部消失。本指南將說明發生原因、如何修復，以及如何避免問題再次發生。

您的 rclone 設定檔（rclone.conf）儲存了您設定的每一個遠端——雲端憑證、權杖、加密金鑰與連線設定。如果此檔案損毀，您將無法存取所有已設定的遠端，直到修復或重新建立為止。RcloneView 讀寫的設定檔與 rclone CLI 使用的完全相同，因此損毀問題會同時影響兩者。以下說明如何診斷並修復此問題。

在同一處管理與同步所有雲端

RcloneView 是 rclone 的跨平台 GUI。透過清爽的視覺化介面比較資料夾、傳輸或同步檔案，並自動化多雲工作流程。

一鍵作業：複製 · 同步 · 比較
排程器與歷史記錄，打造可靠的自動化
支援 Google Drive、OneDrive、Dropbox、S3、WebDAV、SFTP 等

WindowsmacOSLinux

免費開始使用 →

核心功能免費。Plus 提供自動化功能。

設定檔損毀的症狀

若您遇到以下任一情況，設定檔可能已損毀：

遠端消失 ——RcloneView 的遠端清單中不見了，或 rclone listremotes 沒有回傳任何結果。
啟動時出現解析錯誤，例如 Failed to load config file 或 invalid character。
先前可正常運作的遠端驗證失敗，出現權杖錯誤或憑證不符的情況。
遠端項目不完整 ——部分遠端可載入，但其他遠端遺失或設定不完整。
在文字編輯器中開啟 rclone.conf 時出現亂碼 ——顯示無法辨識的字元，而非 INI 格式的區段內容。

Check RcloneView job history for config-related errors

常見成因

寫入設定檔時被中斷

最常見的原因是寫入操作在完成前被中斷。可能發生於以下情況：

系統在 rclone 儲存權杖刷新（token refresh）時當機或斷電。
您在 RcloneView 或 rclone 更新設定檔時強制關閉程式。
因磁碟空間不足或檔案系統錯誤，導致磁碟寫入失敗。

磁碟與檔案系統錯誤

底層儲存裝置的問題可能悄悄損毀任何檔案，包括您的設定檔：

硬碟出現壞軌。
非正常關機後檔案系統損毀。
網路檔案系統（NFS/SMB）延遲導致寫入不完整。

加密金鑰問題

若您的設定檔使用 RCLONE_CONFIG_PASS 加密，以下情況會導致問題：

密碼環境變數未設定，或在不同工作階段間發生變化。
密碼儲存於已被刪除或重設的金鑰鏈（keychain）項目中。
您將設定檔複製到另一台機器，卻未一併轉移密碼。

手動編輯造成的錯誤

在文字編輯器中開啟 rclone.conf 並不慎引入語法錯誤——遺漏括號、破壞 INI 區段標頭或刪除行——都會導致解析器無法正確讀取設定檔。

找出您的設定檔位置

在進行修復之前，請先找到您的設定檔：

作業系統	預設位置
Windows	`%APPDATA%\rclone\rclone.conf`
macOS	`~/.config/rclone/rclone.conf`
Linux	`~/.config/rclone/rclone.conf`

您也可以在終端機中執行 rclone config file 來查看目前使用中的設定檔路徑。RcloneView 使用的正是同一個檔案路徑。

修復步驟

步驟 1：檢查是否有備份副本

在進行任何變更之前，先尋找自動或手動建立的備份：

有些系統會在同一目錄中建立 .bak 檔案。請檢查是否有 rclone.conf.bak。
若您在家目錄使用備份工具或雲端同步服務，可從最近的快照中還原檔案。
檢查系統的資源回收筒或垃圾桶——有些編輯器會建立暫存副本。

步驟 2：驗證檔案結構

在純文字編輯器中開啟 rclone.conf。正常的設定檔內容應類似下列格式：

[my-gdrive]
type = drive
client_id = ...
client_secret = ...
token = {"access_token":"...","token_type":"Bearer",...}

[my-s3]
type = s3
provider = AWS
access_key_id = AKIA...
secret_access_key = ...
region = us-east-1

請留意：遺失的 [section] 標頭、被截斷的行、二進位字元，或不完整的 JSON 權杖字串。

步驟 3：修復部分損毀

若檔案僅部分損壞：

先備份損毀的檔案 ——將其複製一份為 rclone.conf.corrupt。
移除損壞的區段 ——完全刪除有問題的遠端項目。
在 RcloneView 中重新新增遠端，使用「新增遠端」精靈完成設定。

Re-add a cloud remote in RcloneView after config repair

步驟 4：從頭重建設定檔

若檔案已完全無法讀取：

將損毀的檔案重新命名為 rclone.conf.old。
啟動 RcloneView——它會以全新、空白的設定檔啟動。
使用設定精靈重新新增每個遠端。對於採用 OAuth 驗證的遠端（Google Drive、OneDrive、Dropbox），您需要重新完成授權。
對於相容 S3 的遠端，您需要提供存取金鑰與秘密金鑰。

RcloneView explorer after rebuilding remotes

步驟 5：修復已加密的設定檔

若您的設定檔已加密，且您仍持有密碼：

在環境變數中設定 RCLONE_CONFIG_PASS。
執行 rclone config show 以確認解密是否成功。
若能正確解密，代表設定檔並未損毀——問題只是缺少密碼。

若您已遺失加密密碼，則設定檔將無法解密。您必須從頭重新建立所有遠端。

預防技巧

定期備份 ——每次新增或變更遠端後，將 rclone.conf 複製到安全的位置。只需執行簡單的指令 cp ~/.config/rclone/rclone.conf ~/.config/rclone/rclone.conf.backup 即可。
將憑證分開儲存 ——將 S3 金鑰、SFTP 詳細資料，以及您的 RCLONE_CONFIG_PASS 保存在密碼管理工具中。
切勿在權杖刷新或設定檔儲存過程中強制關閉 RcloneView 或 rclone。
確保設定檔所在磁碟有足夠的可用空間。
使用圖形化介面管理遠端，而非手動編輯 rclone.conf。