共用方式為

Azure 儲存體總管疑難排解指南

  • 發行項

注意

本篇文章實用嗎？ 您的輸入對我們很重要。 請使用此頁面上的 [ 意見反應 ] 按鈕，讓我們知道這篇文章為您運作得有多好，或我們如何加以改善。

Microsoft Azure 儲存體總管是一個獨立應用程式，可讓您在 Windows、macOS 和 Linux 上輕鬆使用 Azure 儲存體資料。 應用程式可以連線至裝載於 Azure、國家雲端和 Azure Stack 上的儲存體帳戶。

本指南摘要說明儲存體總管中常見的問題解決方案。

Azure RBAC 權限問題

Azure 角色型訪問控制 （Azure RBAC） 可將一組許可權結合為角色，以對 Azure 資源進行高度細微的存取管理。 以下是讓 Azure RBAC 在儲存體總管中以最佳方式運作的一些策略。

我要如何在儲存體總管中存取我的資源？

如果您在透過 Azure RBAC 存取儲存體資源時發生問題，您可能未獲指派適當的角色。 下列各節說明儲存體總管目前存取儲存體資源所需的權限。 如果您不確定是否有適當的角色或權限，請洽詢您的 Azure 帳戶管理員。

"Read: List/Get Storage Account(s)" 權限問題

您必須擁有列出儲存體帳戶的權限。 若要取得此權限，您必須獲派讀者角色。

列出儲存體帳戶金鑰

儲存體總管也可以使用帳戶金鑰來驗證要求。 您可以透過更強大的角色取得帳戶金鑰存取權，例如參與者角色。

注意

存取金鑰會將不受限制的權限授與給持有這些權限的任何人。 因此，我們不建議您將這些金鑰交給帳戶使用者。 如果您需要撤銷存取金鑰，可以從 Azure 入口網站重新產生存取金鑰。

資料角色

您必須至少指派一個角色，以授與從資源讀取資料的存取權。 例如，如果您想要列出或下載 Blob，至少需要記憶體 Blob 資料讀取者角色。

為什麼我需要管理層角色才能查看儲存體總管中的資源？

Azure 儲存體有兩層存取權：管理和資料。 訂用帳戶和儲存體帳戶是透過管理層來存取。 您可以透過資料層存取容器、Blob 和其他資料資源。 例如，如果您想要從 Azure 取得儲存體帳戶的清單，請將要求傳送至管理端點。 如果您想要帳戶中的 Blob 容器清單，請將要求傳送至適當的服務端點。

Azure 角色可授與您管理或資料層存取權的權限。 例如，讀者角色會授與管理層資源的唯讀存取權。

嚴格來說，「讀者」角色不提供資料層權限，也不需要存取資料層。

儲存體總管可透過收集連接至 Azure 資源所需的資訊，讓您輕鬆地存取資源。 例如，若要顯示您的 Blob 容器，儲存體總管將「列出容器」要求傳送至 Blob 服務端點。 為了取得該端點，儲存體總管會搜尋您可存取的訂用帳戶和儲存體帳戶清單。 若要尋找您的訂用帳戶和儲存體帳戶，儲存體總管也需要存取管理層。

如果您沒有授與任何管理層權限的角色，儲存體總管無法取得連接到資料層所需的資訊。

如果我無法取得系統管理員所需的管理層權限，該怎麼辦？

如果您想要存取 Blob 容器、Azure Data Lake Storage Gen2 容器或目錄或佇列，可以使用 Azure 認證來附加至這些資源。

  1. 開啟 [ 連接] 對話框。
  2. 選取您要連接的資源類型。
  3. 選取 [使用 Microsoft Entra ID>Next 登入]。
  4. 選取與您連結之資源相關聯的用戶帳戶和租用戶，然後選取 [ 下一步]。
  5. 輸入資源的 URL，然後輸入連接的唯一顯示名稱。 選取 [下一步>連線]。

目前，其他資源類型沒有 Azure RBAC 相關解決方案。 因應措施是，您可以要求共用存取簽章 URL，然後將它附加至您的資源：

  1. 開啟 [ 連接] 對話框。
  2. 選取您要連接的資源類型。
  3. 選取 [共用存取簽章][SAS][>下一步]。
  4. 輸入您收到的共用存取簽章 URL，並輸入連線的唯一顯示名稱。 選取 [下一步>連線]。

如需如何附加至資源的詳細資訊，請參閱附加至個別資源。

數個 Azure 內建角色可以提供使用 儲存體總管 所需的許可權。 其中一些角色包括：

注意

擁有者、參與者和儲存體帳戶參與者角色會授與帳戶金鑰存取權。

SSL 憑證問題

本節討論 SSL 憑證問題。

瞭解 SSL 憑證問題

請先確定您已閱讀儲存體總管網路文件中的 [SSL 憑證] 區段，再繼續進行操作。

使用系統 Proxy

如果您只是使用支援 [使用系統 Proxy] 設定的功能，請嘗試使用該設定。 若要閱讀有關系統 Proxy設定的詳細資訊，請參閱儲存體總管中的網路連接。

匯入 SSL 憑證

如果您有自我簽署憑證的複本，就可以指示儲存體總管信任它們：

  1. 取得憑證的 Base-64 編碼 X.509 (.cer) 複本。
  2. 移至 [編輯]>[SSL 憑證]>[匯入憑證]。 然後使用檔案選擇器來尋找、選取和開啟 .cer 檔案。

如果有多個憑證 (根憑證和中繼憑證)，也可能會發生此問題。 若要修正此錯誤，您必須匯入所有憑證。

尋找 SSL 憑證

如果您沒有自我簽署憑證的複本，請向 IT 系統管理員尋求協助。

請按照以下步驟尋找：

  1. 安裝 OpenSSL：

    • Windows：任何輕量版都應足夠。
    • Mac：OpenSSL 應隨附於您的作業系統中。
    • Linux：OpenSSL 應隨附於您的作業系統中。

  2. 執行 OpenSSL：

    • Windows：開啟安裝目錄，選取 /bin/，然後按兩下openssl.exe。
    • Mac：從終端執行 openssl。
    • Linux：從終端執行 openssl。

  3. 針對您儲存體資源背後的任何 Microsoft 或 Azure 主機名稱，執行命令 openssl s_client -showcerts -connect <hostname>:443。 如需詳細資訊，請參閱儲存體總管經常存取的主機名稱清單。

  4. 尋找自我簽署憑證。 如果主體 ("s:") 和簽發者 ("i:") 相同，則憑證最可能會自我簽署。

  5. 當您找到自我簽署憑證時，請針對每個憑證複製所有專案，並將其貼-----BEGIN CERTIFICATE----------END CERTIFICATE-----到新的.cer檔案中。

  6. 開啟儲存體總管，並至 [編輯]>[SSL 憑證]>[匯入憑證]。 然後使用檔案選擇器來尋找、選取並開啟您建立的 .cer 檔案。

停用 SSL 憑證驗證

如果您依照下列步驟仍找不到任何自我簽署憑證，請透過意見反應工具與我們連絡。 您也可以從命令列使用 --ignore-certificate-errors 旗標開啟儲存體總管。 使用此旗標開啟時，儲存體總管會忽略憑證錯誤。 不建議使用此旗標。

登入問題

本節討論您可能會遇到的登入問題。

瞭解登入

請先確定您已閱讀登入儲存體總管文件，再繼續進行操作。

經常需要重新輸入認證

必須重新輸入認證，很可能是您Microsoft Entra 系統管理員所設定的條件式存取原則結果。當 儲存體總管 要求您從帳戶面板重新輸入認證時，您應該會看到 [錯誤詳細數據] 連結。 選取該連結以查看儲存體總管要求您重新輸入認證的原因。 需要重新進入認證的條件式存取原則錯誤可能看起來像這樣：

  • 重新整理權杖已過期。
  • 您必須使用多重要素驗證才能存取。
  • 您的系統管理員進行了設定變更。

若要減少因上述錯誤而必須重新輸入認證的頻率，請與您的 Microsoft Entra 系統管理員交談。

條件式存取原則

如果您有需要針對您的帳戶滿足的條件式存取原則，請確定您是使用 [登入方式] 設定的 [預設網頁瀏覽器] 值。 如需該設定的詳細資訊，請參閱變更登入的發生位置。

瀏覽器抱怨登入期間的 HTTP 重新導向或不安全連線

儲存體總管 在網頁瀏覽器中執行登入時，會在登入程序結束時重新導向localhost。 瀏覽器有時會引發警告或錯誤，指出正在使用 HTTP 而非 HTTPS 來執行重新導向。 某些瀏覽器也可能會嘗試使用 HTTPS 來執行重新導向。 如果發生上述任一問題，視您的瀏覽器而定，您有選項：

  • 忽略警告。
  • 新增 localhost 的例外狀況。
  • 停用強制 HTTPS，無論是全域還是只針對 localhost。

如果您無法執行任何這些選項，也可以變更登入進行整合式登入的位置，以完全避免使用您的瀏覽器。

無法取得權杖，已篩選掉租用戶

您有時候可能會看到錯誤訊息，說明由於已篩選出租用戶，因此無法取得權杖。這表示您嘗試存取資源的租用戶已篩選出。若要包含租用戶，請移至 [帳戶面板]。 確定已選取錯誤中指定的租用戶核取方塊。 如需有關在儲存體總管中篩選租用戶的詳細資訊，請參閱管理帳戶。

驗證程式庫無法正常啟動

如果在啟動時，您會看到錯誤訊息，指出 儲存體總管 的驗證連結庫無法正確啟動，請確定您的安裝環境符合所有必要條件。 不符合必要條件是此錯誤訊息的最可能原因。

如果您認為安裝環境符合所有必要條件，請在 GitHub 上提出問題。 當您提出問題時，請務必包含：

  • 您的OS。
  • 您嘗試使用的 儲存體總管 版本。
  • 您是否已檢查必要條件。
  • 未成功啟動儲存體總管的驗證記錄。 在發生這種類型的錯誤之後，就會自動啟用詳細資訊驗證記錄。

當您使用整合式登入時的空白視窗

如果您選擇使用 整合式登入 ，而且看到空白登入視窗，您可能需要切換至不同的登入方法。 當 Active Directory 同盟服務伺服器提示儲存體總管執行 Electron 不支援的重新導向時，通常會發生空白登入對話方塊。

若要變更為不同的登入方法，請在 [設定]>[應用程式]>[登入] 下變更 [登入] 設定。 如需不同類型登入方法的詳細資訊，請參閱變更登入的發生位置。

重新驗證迴圈或 UPN 變更

如果您處於重新驗證迴圈，或已變更其中一個帳戶的 UPN，請嘗試下列步驟：

  1. 開啟儲存體總管。
  2. 移至 [說明>重設]。
  3. 請確定已至少選取 [驗證]。 清除您不想要重設的其他項目。
  4. 選取 [重設]。
  5. 重新啟動儲存體總管，然後嘗試再次登入。

如果您在重設之後仍然發生問題，請嘗試下列步驟：

  1. 開啟儲存體總管。
  2. 移除所有帳戶，然後關閉儲存體總管。
  3. 從您的機器中刪除 .IdentityService 資料夾。 在 Windows 上，此資料夾位於 C:\users\<username>\AppData\Local。 對於 Mac 和 Linux，您可以在使用者目錄的根目錄找到資料夾。
  4. 如果您執行 Mac 或 Linux，也需要從作業系統的金鑰儲存區刪除 Microsoft.Developer.IdentityService 項目。 在 Mac 上，金鑰儲存區是 Gnome Keychain 應用程式。 在 Linux 中，此應用程式通常稱為 Keyring，但此名稱可能會因為您的散發版本不同而有差異。
  5. 重新啟動儲存體總管，然後嘗試再次登入。

macOS：Keychain 錯誤或沒有登入視窗

macOS Keychain 有時會進入狀態，導致儲存體總管的驗證程式庫發生問題。 若要讓 Keychain 脫離此狀態，請遵循下列步驟：

  1. 關閉 [儲存體總管]。

  2. 選取 [命令 + 空格鍵]、輸入 Keychain，然後選取 Enter 以開啟 Keychain。

  3. 選取 [登入] Keychain。

  4. 選取掛鎖以鎖定 Keychain。 程序完成之後，掛鎖會顯示為已鎖定。 這可能需要幾秒鐘的時間，視您開啟的應用程式而定。

    顯示掛鎖的螢幕快照。

  5. 開啟儲存體總管。

  6. 系統會提示您輸入「服務中樞想要存取 Keychain」之類的訊息。輸入您的 Mac 系統管理員帳戶密碼，然後選取 [ 永遠允許]。 或者，如果 [永遠允許] 無法使用，請選取 [允許]。

  7. 嘗試登入。

Linux：啟動時沒有應用程式視窗或密碼管理員錯誤

如果您在 Linux 系統上啟動 儲存體總管，可能會遇到下列其中一個問題：

  • 沒有應用程式窗口出現。
  • 發生系統密碼管理員的相關錯誤。

儲存體總管 會使用系統的認證管理員來保護您的數據，包括登入認證和SAS連線。 如果未偵測到相容的認證管理員應用程式，儲存體總管 將不會啟動。 如果您的系統未安裝本機認證管理工具，請安裝與 libsecret相容的第三方工具。 例如，在使用 GNOME 桌面環境的 Linux 系統上，您可以安裝 Seahorse。

儲存體總管 通常會在啟動時建立預設索引鍵器。 不過，在某些情況下，這可能不會發生，因此不會發生任何應用程式視窗或密碼管理員服務錯誤。 若要解決問題，請手動設定預設索引鍵器。

如果您使用 Seahorse，而且沒有現有的索引鍵器，或您想要建立新的金鑰器，請遵循下列步驟來建立預設的 Keyring：

  1. 啟動「密碼和金鑰」應用程式。
  2. 選取 [+] 按鈕，然後選取 [密碼密鑰編製]。
  3. 設定新金鑰器的名稱和密碼。
  4. 以滑鼠右鍵按下新的索引鍵器，然後選取 [ 設定為預設值]。

如果您使用 儲存體總管 快照，也必須確定 儲存體總管 已連線到系統的密碼管理員。 若要這樣做，請執行下列命令：

snap connect storage-explorer:password-manager-service :password-manager-service

未開啟預設瀏覽器

如果您在嘗試登入時未開啟預設瀏覽器，請嘗試下列所有方法：

  • 重新啟動儲存體總管。
  • 開始登入之前，先手動開啟您的瀏覽器。
  • 嘗試使用整合式登入。 如需相關指示，請參閱變更登入的發生位置。

其他登入問題

如果上述指示都無法適用於您的登入問題，或是如果無法解決您的登入問題，請在 GitHub 上提出問題。

訂用帳戶遺失和租用戶損毀

如果成功登入後無法擷取您的訂用帳戶，請嘗試下列疑難排解方法：

  • 確認您的帳戶可存取預期的訂用帳戶。 您可以登入想要使用的 Azure 環境入口網站，以確認存取。
  • 確定已使用正確的 Azure 環境 (Azure、Azure 中國 21Vianet、Azure 德國、Azure 美國政府或自訂環境) 來登入。
  • 如果您是在 Proxy 伺服器後方，請確定您已正確設定儲存體總管 Proxy。
  • 嘗試移除再重新新增帳戶。
  • 如果有 [詳細資訊] 或 [錯誤詳細資料] 連結，請檢查哪些錯誤訊息會回報給失敗的租用戶。 如果您不確定如何回應錯誤訊息，請在 GitHub 中提出問題。

AzCopy 傳輸期間與您的 OS 認證存放區互動時發生問題

如果您在 Windows 上看到此訊息，則 Windows 認證管理員很可能已滿。 若要在 Windows 認證管理員中騰出空間，請遵循下列步驟：

  1. 關閉 [儲存體總管]。
  2. 在 [開始] 功能表上，搜尋認證管理員並加以開啟。
  3. 前往 [Windows 認證]。
  4. 在 [一般認證] 下，尋找與您不再使用的程式相關聯的專案，並將其刪除。 您也可以尋找 azcopy/aadtoken/<some number> 等項目並移除這些項目。

如果訊息在完成上述步驟之後仍持續出現，或者如果您在 Windows 以外的平台上遇到這則訊息，您可以在 GitHub 上提出問題。

無法移除附加的儲存體帳戶或資源

如果您透過使用者介面無法移除連結的帳戶或儲存體資源，則可以刪除下列資料夾，以手動刪除連結的所有資源：

  • Windows：%AppData%/StorageExplorer
  • macOS：/Users/<your_name>/Library/Application Support/StorageExplorer
  • Linux：~/.config/StorageExplorer

在刪除這些資料夾之前，請先關閉儲存體總管。

注意

如果您曾經匯入任何 SSL 憑證，請備份 certs 目錄的內容。 稍後，您可以使用備份來重新匯入 SSL 憑證。

Proxy 問題

儲存體總管支援透過 Proxy 伺服器連接到 Azure 儲存體資源。 如果您在透過 Proxy 連接到 Azure 時遇到任何問題，以下是一些建議。

儲存體總管僅支援使用 Proxy 伺服器的基本驗證。 不支援 NTLM 等其他驗證方法。

注意

儲存體總管不支援使用 Proxy 自動設定檔案來設定 Proxy 設定。

確認儲存體總管 Proxy 設定

[應用程式]>[Proxy]>[Proxy 設定] 設定會決定哪個來源儲存體總管從中取得 Proxy 設定。

如果您選取 [使用環境變數]，請務必設定 HTTPS_PROXY 或 HTTP_PROXY 環境變數。 環境變數會區分大小寫，因此請務必設定正確的變數。 如果這些變數未定義或無效，儲存體總管將不會使用 Proxy。 修改任何環境變數之後，請重新啟動儲存體總管。

如果您選取 [使用應用程式 Proxy 設定]，請確定應用程式內 Proxy 設定是否正確。

診斷問題的步驟

如果您仍然遇到問題，請嘗試下列疑難排解方法：

  1. 如果您可以在不使用 Proxy 的情況下連接到網際網路，請確認「儲存體總管」在沒有啟用 Proxy 設定的情況下運作。 如果「儲存體總管」連接成功，您的 Proxy 伺服器可能有問題。 請與您的系統管理員合作找出問題。
  2. 驗證使用代理伺服器的其他應用程式是否按預期工作。
  3. 確認您可以連接到您嘗試使用的 Azure 環境入口網站。
  4. 確認您可以從服務端點接收回應。 在瀏覽器中輸入其中一個端點 URL。 如果可以連線，您應該會收到 InvalidQueryParameterValue 或類似的 XML 回應。
  5. 檢查其他使用「儲存體總管」與相同 Proxy 伺服器的人是否可連接。 如果他們可以連接，則您可能必須連絡 Proxy 伺服器系統管理員。

診斷問題的工具

網路工具 (例如 Fiddler) 可協助您診斷問題。

  1. 將您的網路工具設定為在本機主機上執行的 Proxy 伺服器。 如果您必須繼續使用實際的 Proxy，可能必須設定您的網路工具以透過 Proxy 連接。
  2. 檢查網路工具使用的連接埠號碼。
  3. 設定 儲存體總管 Proxy 設定，以使用本機主機和網路工具的埠號碼，例如 localhost:8888。

正確設定時，您的網路工具會將 儲存體總管 所提出的網路要求記錄到管理和服務端點。

如果您的網路工具似乎未記錄儲存體總管流量，請嘗試使用不同的應用程式來測試您的工具。 例如，輸入其中一個記憶體資源的端點 URL，例如 https://contoso.blob.core.windows.net/ 在網頁瀏覽器中。 您會收到類似此程式碼範例的回應：

<?xml version="1.0" encoding="UTF-8"?>
<Error>
    <Code>InvalidQueryParameterValue</Code>
    <Message>Value for one of the query parameters specified in the request URI is invalid.
        RequestId:<RequestId> Time:2017-04-10T21:42:17.3863214Z</Message>
    <QueryParameterName>comp</QueryParameterName>
    <QueryParameterValue/>
    <Reason/>
</Error>

回應會建議資源存在，即使您無法存取也一樣。

如果您的網路工具只顯示來自其他應用程式的流量，您可能需要調整儲存體總管中的 Proxy 設定。 否則，您可能需要調整工具的設定。

連絡 proxy 伺服器管理員

如果 proxy 設定正確，您可能要連絡您的 proxy 伺服器管理員，並：

  • 確定 proxy 不會封鎖 Azure 管理或資源端點的流量。
  • 確認 proxy 伺服器使用的驗證通訊協定。 儲存體總管僅支援使用通訊協定的基本驗證。 儲存體總管不支援 NTLM proxy。

「無法擷取子系」錯誤訊息

如果透過 proxy 連線至 Azure，請確認您的 proxy 設定正確無誤。

如果訂用帳戶或帳戶的擁有者已授與您資源的存取權，請確認您已讀取或列出該資源的許可權。

連接字串沒有完整的組態設定

如果您收到此錯誤訊息，很可能您沒有取得儲存體帳戶金鑰所需的權限。 若要確認，請移至入口網站並找到您的儲存體帳戶。 以滑鼠右鍵按一下儲存體帳戶的節點，然後選取 [在入口網站中開啟]。 然後，移至 [存取金鑰] 窗格。 如果您沒有檢視金鑰的許可權，您會看到「您沒有存取權」訊息。 若要解決此問題，您可以取得帳戶名稱和金鑰或帳戶共用存取簽章，並用於附加儲存體帳戶。

如果您確實看到帳戶密鑰，請在 GitHub 中提出問題，以便我們協助您解決問題。

「新增連接時發生錯誤：TypeError：無法讀取未定義的屬性 'version'」

如果您嘗試新增自定義連線時收到此錯誤訊息，則儲存在本機認證管理員中的連接數據可能會損毀。 若要解決此問題，請嘗試刪除並重新新增您損毀的本機連線：

  1. 啟動儲存體總管。 從功能表中，移至 [說明]>[切換開發人員工具]。

  2. 在開啟的視窗中，在 [應用程式] 索引標籤上，移至左側的 [本機儲存體]>file://。

  3. 視您遇到問題的連線類型而定，請尋找其金鑰。 然後將其值複製到文字編輯器中。 值是您自訂連接名稱的陣列，例如：

    • 儲存體帳戶
      • StorageExplorer_CustomConnections_Accounts_v1
    • Blob 容器
      • StorageExplorer_CustomConnections_Blobs_v1
      • StorageExplorer_CustomConnections_Blobs_v2
    • 檔案共用
      • StorageExplorer_CustomConnections_Files_v1
    • 佇列
      • StorageExplorer_CustomConnections_Queues_v1
    • 資料表
      • StorageExplorer_CustomConnections_Tables_v1

  4. 儲存目前的連接名稱之後，請將 [開發人員工具] 中的值設定為 []。

若要保留未損毀的連接，請使用下列步驟找出損毀的連接。 如果您不介意遺失所有現有的連接，請略過這些步驟，並遵循平台特定的指示來清除您的連接資料。

  1. 從文字編輯器，將每個連接名稱重新新增至 [開發人員工具]。 然後檢查連接是否仍在運作中。
  2. 如果連接正常運作，表示並未損毀，您可以放將其留在原處。 如果連線無法運作，請從 開發人員工具中移除其值，並加以記錄，以便稍後再新增。
  3. 重複直到您已檢查所有連接為止。

移除連接名稱後，您必須清除其損毀的資料。 接著，您可以使用儲存體總管的標準連接步驟以重新新增連線。

  1. 在 [開始] 功能表上，搜尋認證管理員並加以開啟。
  2. 前往 [Windows 認證]。
  3. 在 [一般認證] 下，尋找具有 <connection_type_key>/<corrupted_connection_name> 索引鍵的專案。 例如 StorageExplorer_CustomConnections_Accounts_v1/account1。
  4. 刪除並重新新增這些連接。

如果您在執行這些步驟之後仍遇到此錯誤，或想要共用您懷疑已損毀的連線，請在 GitHub 頁面上提出問題。

共用存取簽章 URL 的問題

如果您透過共用存取簽章 URL 連接到服務，並遇到錯誤：

  • 請確認 URL 提供讀取或列出資源的必要權限。
  • 請確認 URL 尚未過期。
  • 如果共用存取簽章 URL 是以存取原則為基礎，請確認尚未撤銷存取原則。

如果您不小心使用不正確的共用存取簽章 URL 進行附加，而且現在無法中斷連結，請遵循下列步驟：

  1. 當您執行 儲存體總管 時，請選取 F12 以開啟 [開發人員工具] 視窗。
  2. 在 [應用程式] 索引標籤上，選取左側的 [本機儲存體]>file://。
  3. 尋找與共用存取簽章 URI 服務類型相關聯的索引鍵。 例如，如果是 Blob 容器的共用存取簽章 URI 不正確，請尋找名為 StorageExplorer_AddStorageServiceSAS_v1_blob 的索引鍵。
  4. 索引鍵的值應該是 JSON 陣列。 尋找與不正確 URI 相關聯的物件，並將其刪除。
  5. 選取 Ctrl +R 以重載 儲存體總管。

儲存體總管相依性

儲存體總管隨附於 Windows 上執行所需的所有相依性。

較新版本 .NET Core 的 Patch 儲存體總管

針對 儲存體總管 1.7.0 或舊版，您可能必須修補 儲存體總管 所使用的 .NET Core 版本：

  1. 移至 [NuGet] 頁面，並從右側的 [下載套件 ] 鏈接下載 StreamJsonRpc 1.5.43 版。

  2. 下載套件之後，請將其副檔名從 .nupkg 變更為 .zip。

  3. 解壓縮套件。

  4. 開啟 streamjsonrpc.1.5.43/lib/netstandard1.1/ 資料夾。

  5. 將 StreamJsonRpc.dll 複製到儲存體總管資料夾中的下列位置：

    • StorageExplorer/resources/app/ServiceHub/Services/Microsoft.Developer.IdentityService/
    • StorageExplorer/resources/app/ServiceHub/Hosts/ServiceHub.Host.Core.CLR.x64/

Azure 入口網站 中的 [在總管中開啟] 按鈕無法運作

如果 Azure 入口網站中的 [在 Explorer 中開啟] 按鈕無法運作，請確定您使用的是相容瀏覽器。 下列瀏覽器已針對相容性進行測試：

  • Microsoft Edge
  • Mozilla Firefox
  • Google Chrome
  • Microsoft Internet Explorer

收集記錄檔

當您回報問題給 GitHub 時，系統可能會要求您收集特定記錄檔，以協助診斷您的問題。

儲存體總管記錄

儲存體總管會將各種專案記錄到自己的應用程式記錄檔中。 您可以藉由選取 [說明]>[開啟記錄檔目錄]，輕鬆地取得這些記錄檔。 依預設，儲存體總管記錄層級較低的詳細資訊。 若要變更詳細程度層級，請移至 [設定] (左側的 [齒輪] 符號) > [應用程式] > [記錄] > [記錄層級]。 然後，您可以視需要設定記錄層級。 若要進行疑難解答， 建議使用追蹤 記錄層級，因為它是最詳細的層級。 變更記錄層級之後，請重新啟動 儲存體總管 並重現您遇到的問題。

系統會將記錄檔分割成您所執行儲存體總管的每個工作階段的資料夾。 對於您需要共用的任何記錄檔，會將其放在 zip 封存中，並將來自不同工作階段的檔案放在不同資料夾中。

驗證記錄

如需登入或 儲存體總管 驗證連結庫的相關問題，您最可能需要收集驗證記錄。 驗證記錄會儲存在下列位置：

  • Windows：C:\Users\<您的使用者名稱> \AppData\Local\Temp\servicehub\logs
  • macOS：~/.ServiceHub/logs
  • Linux：~/.ServiceHub/logs

一般而言，您可以遵循下列步驟來收集記錄：

  1. 移至 [設定] (左側的齒輪符號) >[應用程式]>[登入]。 選取 [詳細資訊驗證記錄]。 如果 儲存體總管 因為驗證連結庫發生問題而無法啟動，則此步驟會為您完成。
  2. 關閉 [儲存體總管]。
  3. 選擇性/建議：清除 [記錄檔] 資料夾中的現有記錄。 此步驟可減少您必須傳送給我們的資訊量。
  4. 開啟儲存體總管並重現您的問題。
  5. 關閉 [儲存體總管]。
  6. 壓縮 [記錄檔] 資料夾的內容。

AzCopy 登入

如果您在傳輸資料時遇到問題，可能需要取得 AzCopy 記錄。 根據預設，AzCopy 會記錄在低層級的詳細資訊。 若要變更詳細資訊層級，請移至 [設定] （左側齒輪符號） >傳輸>AzCopy>記錄層級。 然後，您可以視需要設定記錄層級。 若要進行疑難解答，建議使用偵錯記錄層級，因為它是最詳細的層級。 變更記錄層級之後，請重新啟動 儲存體總管 並重現您遇到的問題。

您可以透過兩種不同的方法輕鬆找到 AzCopy 記錄：

  • 針對仍在活動記錄中的失敗轉移，請選取 [移至 AzCopy 記錄檔]。
  • 針對過去失敗的傳輸，請移至 AzCopy 記錄檔資料夾。 您可以在下列處找到此資料夾：
    • Windows：C:\Users\<您的使用者名稱>\.azcopy
    • macOS：~/.azcopy
    • Linux：~/.azcopy

網路記錄

針對某些問題，您必須提供 儲存體總管 所進行網路呼叫的記錄。 在 Windows 上，您可以使用 Fiddler 來取得網路記錄。

注意

Fiddler 追蹤可能包含您在瀏覽器收集期間，於瀏覽器中輸入或傳送的密碼。 請務必閱讀有關如何淨化 Fiddler 追蹤的指示。 請勿將 Fiddler 追蹤上傳至 GitHub。 系統會告知您可以安全地傳送 Fiddler 追蹤的位置。

第 1 部分：安裝和設定 Fiddler

  1. 安裝 Fiddler。
  2. 啟動 Fiddler。
  3. 移至 [工具]>[選項]。
  4. 選取 [HTTPS] 索引標籤。
  5. 確定已選取 [擷取連接] 和 [解密 HTTPS 流量]。
  6. 選取動作。
  7. 選取 [信任跟證書 ]，然後在下一個對話框中選取 [ 是 ]。
  8. 啟動儲存體總管。
  9. 移至 [設定] （左側齒輪符號） >應用程式>Proxy。
  10. 將 Proxy 來源下拉式清單變更為 [使用系統 Proxy]（預覽版）。
  11. 重新啟動儲存體總管。
  12. 您應該會開始在 Fiddler 中看到來自 storageexplorer: 程序的網路呼叫。

第 2 部分：重現問題

  1. 關閉 Fiddler 以外的所有應用程式。
  2. 使用左上角的 X，在 [檢視] 功能表附近清除 Fiddler 記錄。
  3. 選用/建議：讓 Fiddler 設定幾分鐘。 如果您看到與儲存體總管沒有關聯的網路呼叫，請以滑鼠右鍵按一下這些呼叫，然後選取 [立即篩選] > [隱藏] < [程序名稱]。>
  4. 啟動/啟動/重新啟動儲存體總管。
  5. 重現問題。
  6. 選取 [檔案]>[儲存]>[所有工作階段]。 將其儲存在您能夠記得的位置。
  7. 關閉 Fiddler 和儲存體總管。

第 3 部分：清理 Fiddler 追蹤

  1. 按兩下 Fiddler 追蹤 (.saz 檔案)。
  2. 選取 Ctrl + F。
  3. 在出現的對話框中，確定已設定下列選項：搜尋 = 要求和回應，以及檢查 = 標頭和主體。
  4. 搜尋您收集 Fiddler 追蹤時使用的任何密碼，以及任何反白顯示的專案。 以滑鼠右鍵按一下並選取 [移除]>[選取的工作階段]。
  5. 如果您在收集追蹤時確實將密碼輸入瀏覽器，但在您使用 Ctrl + F 時找不到任何專案，則不想變更密碼，或您使用的密碼用於其他帳戶，請略過將 .saz 檔案傳送給我們。
  6. 使用新名稱重新儲存追蹤。
  7. 選擇性：刪除原始追蹤。

下一步

如果這些解決方案都不適合您，請使用下列其中一種方法：

協力廠商資訊免責聲明

本文提及的協力廠商產品是由與 Microsoft 無關的獨立廠商所製造。 Microsoft 不以默示或其他方式，提供與這些產品的效能或可靠性有關的擔保。

與我們連絡，以取得說明

如果您有問題或需要相關協助，請建立支援要求，或詢問 Azure community 支援。 您也可以向 Azure 意見反應社群提交產品意見反應。