Kopia 還原停滯：快照可見時如何查核內容下載及寫入？

Kopia 還原停滯而快照清單仍可讀時，先分辨快照瀏覽、內容取得與本機寫入。固定來源物件，把小範圍內容還原到新的空資料夾，查核檔案與錯誤，再決定是否比較網絡，不先修改儲存庫。

關鍵要點：

• 快照可見不驗證所有引用內容可下載。
• 先固定源 ID 與路徑，不依賴可變的 latest。
• 以獨立空目的地保留原檔及儲存庫資料。
• 淺層佔位項並非需要的原檔內容。
• 公開內容傳輸有錯誤證據才換路，之後仍需查核檔案。

Kopia 還原停滯涉及哪個操作？

官方指令可用物件 ID 還原檔案或目錄，並限定子目錄，也可展開既有佔位項。不同來源形式有不同含義，先記下實際選擇。［2］

入門指引分開連接儲存庫、快照及還原。瀏覽頁顯示記錄有用，但不能代替在真正執行主機上取得內容。［1］

現象	要辨別甚麼	下一步
無法列出快照	連接與憑據	核對儲存庫
清單成功，內容請求逾時	中繼資料與內容讀取	嘗試固定的小範圍還原
出現佔位項	淺層模式與完整復原	查看要求的模式
下載有進度，輸出失敗	傳輸與本機寫入	檢查權限和空間
內容或完整性錯誤反覆出現	儲存庫資料與路徑	保存證據交擁有者調查

更廣的問題可參考設備排障次序；一般雲端同步條件另行查核，不將同步佇列視為 Kopia 快照。

步驟 1：確認儲存庫與快照身份

記下 Kopia 版本、系統、儲存庫類型和所需快照，核對備份主機、用戶、來源路徑與時間。不僅憑看來較新便選某條記錄。［1］

保存明確的檔案或目錄 ID，以及子目錄選擇。官方將物件 ID 來源與可能受快照時間影響的路徑選擇分開；明確來源才可確認兩次讀取相同歷史內容。［2］

保存首錯及時間，分辨程式報連接錯誤與你因速度慢而取消。記錄足以重現的指令或選擇，但分享時遮蔽密碼、雲端密鑰、簽署網址、個人檔案名與私人儲存庫資料。

找出真正執行主機。某部電腦的界面、瀏覽器或終端可以控制另一程序；取得物件及寫入結果的主機才決定網絡和檔案系統，觀看者的 VPN 不證明它已換路。

不要斷開儲存庫並重建來清除錯誤，也不在診斷中刪快照、開始維護或換加密憑據。這些行為改變復原條件，並非測試選定內容。

**檢查點：**來源是正確儲存庫中的特定歷史選擇，首錯已私人保存。無法與另一主機或儲存庫區分時，停止。

步驟 2：建立空目的地並查核覆寫

用工作項目、儲存庫本體及其他同步資料夾以外的新本機位置。以 Kopia 執行帳戶建立及刪除無害測試檔案確認可寫，空間按還原內容估算，不以雲端壓縮大小估算。

官方指出，對既有目標還原時預設可覆寫內容，並提供檔案、目錄及符號連結控制。獨立空目標比逐一推算生產目錄的碰撞容易。［2］

保持 delete-extra 關閉。這個選項會刪除目標有而快照沒有的條目，測試一個檔案無需使用。亦不啟用忽略錯誤選項，免得把不完整還原誤當完成。［2］

每次嘗試用另一個空資料夾，前一次檔案才不會被誤認為新下載。作業開始時建立目錄，不表示內容已取得。

需要完整檔案時，不要求 shallow 模式。官方說明淺層條目是可稍後展開的佔位項，它們存在不等於原資料已復原。［2］

**檢查點：**目的地空且可寫、沒有破壞性選項，模式符合實際內容復原。可能取代唯一現有副本時，停止。

步驟 3：分開內容取得與本機處理

以固定來源、新目標做小範圍還原。保存實際錯誤與輸出，辨認在等待儲存庫、取回資料、建立佔位項還是寫入失敗，不僅看百分比或耗時。

把大寫佔位符換成已核對的來源和新空目的地，沿用安全的儲存庫及憑據設定，不在指令中加入密碼。

kopia snapshot restore OBJECT_ID/SUBPATH RESTORE_DIR --no-overwrite-files --no-overwrite-directories --no-overwrite-symlinks --no-delete-extra

Kopia 快照還原失敗時，查每個物件是否都失敗，還是同一快照只有一個檔案失敗。這有助縮小內容範圍，但不驗證其餘儲存庫健康。

清單可讀而內容請求逾時，支持調查內容路徑。同一檔案反覆報缺失或無效物件，則保存 ID 與錯誤交擁有者，不靠不斷換路修復。

內容已下載但不能寫入，應查目標檔案系統。權限、容量、檔案佔用和名稱限制不同於雲端存取，明確本機輸出錯誤時不要改儲存庫憑據。

亦要確認產物是真正檔案而非淺層佔位項。展開是獨立的還原模式，不期待原應用程式理解佔位檔案，也不改名冒充原檔。［2］

本機或組織私人儲存庫需要獲准路徑；下一步公開網絡比較不適用於透過消費 VPN 接入區域網絡共享。

**檢查點：**內容請求或本機寫入階段已辨認。僅連接、下載證據支持才比較路徑；完整性、憑據或目的地問題未解決便停止。

步驟 4：以同一內容選擇比較路徑

記錄直連的源 ID、路徑、目標、開始時間和首錯。選非敏感小範圍，不做全快照；保留版本、憑據、儲存庫及源，讓路徑成為比較變數。

在真正讀取公開內容的電腦連接 AethoVPN，再把相同選擇還原到另一個空目標。Windows 用官網安裝程式；Linux 限 Debian/Ubuntu x64 .deb；Mac 透過官網向導及 VPN 客戶端設定，需 Pro 或 Premium。選目前可用的就近位置，啟用全局模式，分別比較下載及本機寫入結果；換路不重建損壞區塊、不在缺少正確憑據時解密，也不增加磁碟容量。

開始 3 天 Pro 試用，測試所選快照的內容路徑；每名新用戶僅可獲一次試用。

先按VPN 連接核實程序檢查連接，再回到固定 Kopia 來源。Windows 代理相關時，核對其作用範圍及設定，瀏覽器代理改變不等於備份客戶端換路。

這不是性能基準，問題是記錄條件下能否還原該內容。快取亦會影響重試，第二次較快不能獨立證明網絡原因。

只有直連成功便用直連；兩路都報相同缺失物件或寫入錯誤，停止實驗並保存證據。私人或限制來源 IP 的儲存庫，使用獲准路徑，不為新出口放寬政策。

步驟 5：驗證檔案、錯誤與歷史內容

以合適程式開啟結果，核對選定快照的文件修訂、圖片或其他已知標記。大小可輔助，但大小及時間一致不能獨立證明內容正確。

看還原報告的錯誤和跳過項。佔位檔案、空資料夾和快照清單都不達標；進度完成但文件不可讀同樣不合格。

將結果與源 ID 綁定，另一版本可讀只是替代方案，不證明指定版本已成功復原。

小範圍成功後，在另一獨立目標檢查具代表性的資料夾，保留例外。生產替換前，復原負責人須接受內容及適用權限或應用一致性檢查。

Kopia 儲存庫連接問題持續時，提供版本、backend、所選源、首錯、模式及遮蔽敏感資訊後的路徑比較。缺失或損壞資料要做儲存庫調查，不刪快照或用維護作業充當網絡修復。

這只驗證所選檔案，不驗證全部快照或未來還原。較大復原接受前，保留原資料及設定。

總結

• 固定歷史來源和實際執行主機。
• 空目標及關閉刪除選項保護現有檔案。
• 分開中繼資料、內容、佔位項和寫入。
• 公開傳輸有證據才換路。
• 以可讀歷史內容及相關錯誤報告驗收。

常見問題

快照可列出，為何檔案不能還原？

兩者測試不同操作。保存來源及首個內容錯誤，先分辨存取、資料缺失、傳輸或本機輸出，再決定設定調整。

應還原到現有工作資料夾嗎？

診斷用獨立空目的地。還原可以覆寫內容，新位置既保護工作資料，亦使每次嘗試產物容易辨認。

淺層佔位項是完整復原嗎？

它們不是原檔內容。shallow 模式有意用佔位項表示部分目錄樹，須按官方展開程序取得實際資料。

換路能解決本機權限問題嗎？

路徑改變內容到客戶端的傳輸，不改變寫入目的地的身份。錯誤明確指向本機時，先查帳戶及檔案系統，不重複下載。

應開啟 delete-extra 或忽略錯誤嗎？

兩者不適合小範圍診斷。刪除多餘檔案會改變現有資料，忽略錯誤會隱藏不完整復原；保留獨立目標並檢查錯誤。

甚麼證明所選快照已還原？

實際檔案可讀、符合歷史內容且沒有未解決錯誤。佔位項、建立目錄或 IP 改變都不提供這種證據。

何時停止改變 Kopia 的網絡路徑？

兩路相同非網絡失敗、內容缺失損壞，或私人儲存庫存取不明時停止。以源身份及遮蔽敏感資訊後的證據求助，不先改儲存結構。

免責聲明：這是按公開文檔設計的診斷比較，並非更快或必定復原的實測承諾。保留原檔案，按擁有者的復原流程處理。

來源:

1. Kopia — Getting Started Guide
2. Kopia — snapshot restore

Sources checked 2026 年 10 月 7 日。