修復阿里雲驗證錯誤 — NetDrive

上週還能正常掛載阿里雲儲存貯體的建置伺服器，現在 NetDrive 顯示憑證錯誤，從磁碟機讀取建置產物的夜間工作在第一個檔案就失敗了。機器上沒有任何變更。阿里雲磁碟機無法通過驗證時，原因幾乎總是四者之一：存取金鑰、其背後的權限、Endpoint，或儲存貯體名稱。本指南依最快找出問題的順序逐一說明。

讓你的阿里雲磁碟機恢復使用

NetDrive 讓 Google Drive、OneDrive、S3、SFTP、WebDAV 等在 Windows 與 macOS 上顯示為原生磁碟機 — 不需同步，也不需完整下載。

• 掛載前先測試憑證
• Drive Manager 顯示每個磁碟機的狀態
• 重新連線時不會遺失掛載設定

WindowsmacOS

下載 NetDrive →

免費試用。提供終身與訂閱方案。

修改之前先讀錯誤訊息

儲存阿里雲磁碟機時，NetDrive 會測試連線；憑證有問題時，會顯示內嵌訊息，而不是新的磁碟機卡片。這則訊息是你的第一條線索。金鑰被拒絕，表示問題出在 Access Key ID 或密鑰。權限類的拒絕，表示問題出在金鑰背後的 RAM 使用者。完全無法連到儲存貯體，通常是 Endpoint 或儲存貯體名稱的問題。

在編輯欄位之前，先記下你遇到的是哪一種。同時更改多個地方，就無法判斷究竟是哪一項解決了問題。

檢查 1：存取金鑰組

NetDrive 需要 Access Key ID 和對應的密鑰。最常見的失敗原因是金鑰組已失效：

1. 登入阿里雲主控台，開啟擁有該金鑰的 RAM 使用者。
2. 確認金鑰仍在清單中，且狀態為啟用而非停用。
3. 如果金鑰已輪替，NetDrive 中儲存的舊金鑰組就已失效。建立新的金鑰組並立即複製兩個值，因為密鑰只會顯示一次。
4. 將新值貼到磁碟機設定中。注意結尾的空白，複製時很容易帶上。

屬於已刪除 RAM 使用者的金鑰與被停用的金鑰一樣會失敗，所以請確認該使用者仍然存在。

檢查 2：RAM 權限

即使金鑰有效，如果 RAM 使用者對儲存貯體沒有權限，仍會被拒絕。日常掛載請使用 RAM 使用者，而不是帳號的根金鑰，並確保其政策授予對你要掛載的那個儲存貯體的存取權限。如果磁碟機需要寫入檔案，唯讀權限可以瀏覽，但第一次儲存就會失敗。

如果你最近收緊過政策，那很可能就是原因。請將政策與出錯之前的情況比對。

檢查 3：Endpoint 和儲存貯體名稱

阿里雲的 Endpoint 依地區而異，例如杭州是 oss-cn-hangzhou.aliyuncs.com。某個地區的儲存貯體不會在另一個地區的 Endpoint 上回應，所以從錯誤的專案複製貼上會產生看起來像驗證失敗的錯誤。在主控台開啟儲存貯體的 Overview 頁面，從那裡複製 Endpoint。

接著將 Bucket 欄位與主控台逐字元比對。儲存貯體名稱必須完全一致。即使只錯一個字元，或儲存貯體被刪除後在其他地區重新建立，症狀都與金鑰錯誤相同。

重新連線磁碟機

修正出錯的欄位後：

1. 開啟 NetDrive，在 Drive Manager 中找到阿里雲磁碟機。
2. 開啟磁碟機設定，更新金鑰、密鑰、Endpoint 或儲存貯體。
3. 按一下 Test，等待 NetDrive 確認可以連到儲存貯體。
4. 儲存，然後從其卡片連線磁碟機。

如果編輯現有項目後錯誤仍未消除，請移除該磁碟機，並在 Add Drive 對話方塊中用你在主控台核對過的值重新新增。全新的項目可以排除已儲存的舊值造成的干擾。

驗證通過但仍無法掛載

如果 Test 成功但磁碟機仍未出現，問題已超出憑證範圍。Windows 上磁碟機代號已被占用是常見原因，請參閱 Fix Drive Letter Already in Use。如果連線後資料夾顯示為空或內容過時，請依照 Force Folder Refresh 中的說明手動重新整理。

總結

把阿里雲驗證錯誤當作檢查清單：金鑰、權限、Endpoint、儲存貯體。一次只修一處，每次變更後使用 Test，並透過 Drive Manager 重新連線。完整的首次設定請參閱 Mount Alibaba Cloud on Windows with NetDrive。如果你使用的是姊妹服務，Mount Tencent Cloud on Windows 介紹了相同的流程。

— Steve, NetDrive