Azure 存储资源管理器故障排除指南
注意
本文有帮助吗? 你的输入对我们很重要。 请使用此页上的 “反馈 ”按钮告诉我们本文为你工作得有多好,或者我们如何改进它。
Microsoft Azure 存储资源管理器是一款独立应用,可用于在 Windows、macOS 和 Linux 上轻松处理 Azure 存储数据。 应用可连接到托管在 Azure、National Clouds 和 Azure Stack 上的存储帐户。
本指南汇总了存储资源管理器中常见问题的解决方法。
Azure RBAC 权限问题
Azure 基于角色的访问控制 (Azure RBAC) 通过将一组权限组合到角色中来对 Azure 资源进行高度精细的访问管理。 下面是在存储资源管理器中以最佳方式使用 Azure RBAC 的一些策略。
如何在存储资源管理器中访问我的资源?
如果你在通过 Azure RBAC 访问存储资源时遇到问题,原因可能是你尚未被分配相应的角色。 以下部分介绍了存储资源管理器目前要求提供哪些权限来访问存储资源。 如果你不确定自己是否拥有相应的角色或权限,请联系 Azure 帐户管理员。
“读取:列出/获取存储帐户”权限问题
必须有权列出存储帐户。 若要获取此权限,必须具有“读取者”角色。
列出存储帐户密钥
存储资源管理器还可以使用帐户密钥对请求进行身份验证。 可以通过权限更高的角色(例如“参与者”角色)来获取帐户密钥的访问权限。
注意
访问密钥向其任何持有者授予不受限制的权限。 因此,我们不建议将这些密钥分发给帐户用户。 如果需要撤销访问密钥,可以通过 Azure 门户重新生成访问密钥。
数据角色
必须至少拥有一个可以授予对资源中数据的读取访问权限的角色。 例如,如果要列出或下载 Blob,至少需要存储 Blob 数据读取者角色。
为何需要管理层角色才能在存储资源管理器中查看我的资源?
Azure 存储提供两个访问层:“管理”和“数据”。 订阅和存储帐户是通过管理层访问的。 容器、Blob 和其他数据资源是通过数据层访问的。 例如,若要从 Azure 获取存储帐户的列表,应向管理终结点发送请求。 若要列出帐户中的 Blob 容器,应向相应的服务终结点发送请求。
Azure 角色可以授予你进行管理或数据层访问的权限。 例如,“读取者”角色授予对管理层资源的只读访问权限。
严格地讲,“读取者”角色不提供数据层的权限,并非一定要有该角色才能访问数据层。
在存储资源管理器中,可以通过收集连接到 Azure 资源所需的信息,来轻松访问资源。 例如,若要显示 Blob 容器,存储资源管理器会向 Blob 服务终结点发送“列出容器”请求。 若要获取该终结点,存储资源管理器会搜索你有权访问的订阅和存储帐户列表。 若要查找订阅和存储帐户,存储资源管理器还需要有权访问管理层。
如果你没有一个可以授予任何管理层权限的角色,则存储资源管理器无法获取连接到数据层所需的信息。
如果我无法从管理员获取管理层权限,该怎么办?
若要要访问 Blob 容器、Azure Data Lake Storage Gen2 容器或目录或队列,可以使用 Azure 凭据连接到这些资源。
- 打开“连接”对话框。
- 选择要连接到的资源类型。
- 选择“使用Microsoft Entra ID>下一步登录。
- 选择与要附加到的资源关联的用户帐户和租户,然后选择“ 下一步”。
- 键入资源的 URL,然后键入连接的唯一显示名称。 选择“下一步>连接”。
目前,其他资源类型没有与 Azure RBAC 相关的解决方案。 解决方法是,可以请求共享访问签名 URL,然后将其附加到资源:
- 打开“连接”对话框。
- 选择要连接到的资源类型。
- 选择“共享访问签名”(SAS)>下一步。
- 键入收到的共享访问签名 URL,并输入连接的唯一显示名称。 选择“下一步>连接”。
有关如何连接到资源的详细信息,请参阅连接到单个资源。
建议的 Azure 内置角色
多个 Azure 内置角色可以提供使用存储资源管理器所需的权限。 其中一些角色是:
- 所有者:管理所有内容,包括对资源的访问权限。
- 参与者:管理所有内容,不包括对资源的访问权限。
- 读者:读取和列出资源。
- 存储帐户参与者:完全管理存储帐户。
- 存储 Blob 数据所有者:对 Azure 存储 blob 容器和数据具有完全访问权限。
- 存储 Blob 数据参与者:读取、写入和删除 Azure 存储容器与 Blob。
- 存储 Blob 数据读取者:读取和列出 Azure 存储容器与 Blob。
注意
“所有者”、“参与者”和“存储帐户参与者”角色授予帐户密钥访问权限。
SSL 证书问题
本部分讨论 SSL 证书问题。
了解 SSL 证书问题
在继续操作之前,请确保已阅读存储资源管理器网络文档中的 SSL 证书部分。
使用系统代理
如果仅使用支持系统代理设置的功能,请尝试使用该设置。 若要详细了解系统代理设置,请参阅存储资源管理器中的网络连接。
导入 SSL 证书
如果你有自签名证书的副本,可以指示存储资源管理器信任这些证书:
- 获取证书的 Base-64 编码 X.509 (.cer) 副本。
- 转到“编辑”>“SSL 证书”>“导入证书” 。 然后使用文件选取器查找、选择并打开 .cer 文件。
如果存在多个证书(根证书和中间证书),也可能会出现此问题。 要修复此错误,必须导入所有证书。
查找 SSL 证书
如果没有自签名证书副本,请向 IT 管理员寻求帮助。
按照以下步骤查找证书:
安装 OpenSSL:
- Windows:任何精简版本均可。
- Mac:OpenSSL 应包含在操作系统中。
- Linux:操作系统中应包含 OpenSSL。
运行 OpenSSL:
- Windows:打开安装目录,选择 /bin/,然后双击openssl.exe。
- Mac:从终端运行
openssl
。 - Linux:从终端运行
openssl
。
针对你的存储资源所在的任何 Microsoft 或 Azure 主机名,运行命令
openssl s_client -showcerts -connect <hostname>:443
。 有关详细信息,请参阅此存储资源管理器经常访问的主机名列表。查找自签名证书。 如果使用者
("s:")
和颁发者("i:")
相同,则证书很可能是自签名证书。找到自签名证书时,对于每个证书,复制所有内容
-----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----
并将其粘贴到新的.cer文件中。打开存储资源管理器,然后转到“编辑”>“SSL 证书”>“导入证书”。 然后使用文件选取器查找、选择并打开创建的 .cer 文件。
禁用 SSL 证书验证
如果通过上述步骤无法找到任何自签名证书,请通过反馈工具联系我们以获取更多帮助。 也可通过命令行使用 --ignore-certificate-errors
标志打开存储资源管理器。 使用此标志打开后,存储资源管理器将忽略证书错误。 不建议使用此标志。
登录问题
本部分讨论你可能遇到的登录问题。
了解登录
在继续操作之前,请确保已阅读登录到存储资源管理器文档。
经常需要重新输入凭据
必须重新输入凭据很可能是由 Microsoft Entra 管理员设置的条件访问策略的结果。当存储资源管理器要求你重新输入帐户面板中的凭据时,应会看到错误详细信息链接。 请选择该链接以查看存储资源管理器要求你重新输入凭据的原因。 要求重新输入凭据的条件访问策略错误可能如下所示:
- 刷新令牌已过期。
- 必须使用多重身份验证才能访问。
- 管理员进行了配置更改。
若要减少因上述错误而必须重新输入凭据的频率,请与 Microsoft Entra 管理员交谈。
条件性访问策略
如果你的帐户需要满足条件访问策略,请确保将“默认 Web 浏览器”值用于“登录方式”设置 。 有关此设置的信息,请参阅更改登录的位置。
在登录期间浏览器提示 HTTP 重定向有问题或连接不安全
存储资源管理器在 Web 浏览器中执行登录时,会在登录过程结束时重定向到 localhost。 浏览器有时会发出警告或错误,指出重定向是通过 HTTP 而不是通过 HTTPS 执行的。 某些浏览器可能还会尝试通过 HTTPS 强制执行重定向。 如果出现上述任一问题,具体取决于浏览器,可以选择:
- 忽略此警告。
- 为 localhost 添加异常。
- 针对 localhost 全局或仅禁用强制 HTTPS。
如果无法采取其中的任何一种做法,还可以将登录位置更改为集成登录,以完全避免使用浏览器。
无法获取令牌,租户已被筛除
有时候,你可能会看到一条错误消息,指出由于租户被筛选掉而无法获取令牌。这意味着你正在尝试访问已筛选掉的租户中的资源。若要包括租户,请转到“帐户面板”。 确保错误中指定的租户对应的复选框已选中。 有关在存储资源管理器中筛选租户的详细信息,请参阅管理帐户。
身份验证库未能正确启动
如果在启动时看到一条错误消息,指出存储资源管理器的身份验证库无法正确启动,请确保安装环境满足所有先决条件。 未满足先决条件是导致该错误消息的最常见原因。
如果你认为安装环境满足所有先决条件,请在 GitHub 上提出问题。 提问时,请确保提供以下信息:
- 你的 OS。
- 尝试使用的存储资源管理器版本。
- 是否已检查先决条件。
- 存储资源管理器启动失败时的身份验证日志。 发生此类错误后,会自动启用详细身份验证日志记录。
使用集成登录时出现空白窗口
如果选择使用 集成登录 ,并且看到一个空白登录窗口,则可能需要切换到其他登录方法。 如果 Active Directory 联合身份验证服务服务器提示存储资源管理器执行 Electron 不支持的重定向,则往往会出现空白的登录对话框。
若要更改为其他登录方法,请在“设置”>“应用程序”>“登录”下更改“登录方式”设置 。 有关不同类型的登录方法的信息,请参阅更改登录的位置。
重新验证循环或 UPN 更改
如果你处于重新验证循环中,或者已更改其中一个帐户的 UPN,请尝试以下步骤:
- 打开存储资源管理器。
- 转到“帮助”>“重置” 。
- 确保至少选择了“身份验证”。 清除不想重置的其他项。
- 选择“重置”。
- 重启存储资源管理器并再次尝试登录。
如果在执行重置后仍有问题,请尝试以下步骤:
- 打开存储资源管理器。
- 删除所有帐户,然后关闭存储资源管理器。
- 从计算机中删除 .IdentityService 文件夹。 在 Windows 上,该文件夹位于 C:\users\<username>\AppData\Local 中。 对于 Mac 和 Linux,可以在用户目录的根目录中找到该文件夹。
- 如果运行的是 Mac 或 Linux,则还需要从操作系统的密钥存储中删除
Microsoft.Developer.IdentityService
条目。 在 Mac 上,密钥存储是 Gnome Keychain 应用程序。 对于 Linux,该应用程序通常称为 Keyring,但名称可能会有所不同,具体取决于分发版。 - 重启存储资源管理器并再次尝试登录。
macOS:密钥链错误或无登录窗口
有时,macOS 密钥链可能会进入导致存储资源管理器的身份验证库出现问题的状态。 若要使密钥链脱离此状态,请执行以下步骤:
关闭存储资源管理器。
通过选择“命令 + 空格键”打开密钥链,键入密钥链,然后选择 Enter。
选择“登录”Keychain。
选择挂锁图标以锁定密钥链。 完成此过程后,挂锁图标将显示为锁定状态。 这可能需要几秒钟时间,具体取决于打开的应用。
打开存储资源管理器。
系统提示你收到一条消息,如“服务中心想要访问密钥链”。键入 Mac 管理员帐户密码,然后选择“ 始终允许”。 或者,如果未显示“始终允许”,则选择“允许” 。
请尝试登录。
Linux:启动时不显示应用程序窗口或密码管理器错误
如果在 Linux 系统上启动存储资源管理器,可能会遇到以下问题之一:
- 未显示任何应用程序窗口。
- 发生有关系统密码管理器的错误。
存储资源管理器使用系统的凭据管理器来保护数据,包括登录凭据和 SAS 连接。 如果未检测到兼容的凭据管理器应用程序,则不会启动存储资源管理器。 如果系统未安装本地凭据管理工具,请安装与 libsecret
第三方工具兼容的工具。 例如,在使用 GNOME 桌面环境的 Linux 系统上,可以安装 Seahorse。
存储资源管理器通常会在启动时创建默认键环。 但是,在某些情况下,这可能不会发生,导致没有应用程序窗口或密码管理器服务错误。 若要解决问题,请手动设置默认键环。
如果使用的是 Seahorse,并且没有现有的密钥环,或者想要创建新的密钥环,请按照以下步骤创建默认键环:
- 启动“密码和密钥”应用程序。
- 选择“+”按钮,然后选择 “密码密钥环”。
- 为新密钥环设置名称和密码。
- 右键单击新密钥环,然后选择“ 设为默认值”。
如果使用存储资源管理器快照,还必须确保存储资源管理器已连接到系统的密码管理器。 为此,请运行以下命令:
snap connect storage-explorer:password-manager-service :password-manager-service
默认浏览器无法打开
如果尝试登录时默认浏览器未打开,请尝试以下所有方法:
- 重启存储资源管理器。
- 在开始登录之前,请手动打开浏览器。
- 尝试使用集成登录。 有关说明,请参阅更改登录位置。
其他登录问题
如果上述说明均不适用于你的登录问题或者无法解决你的问题,请在 GitHub 上提出问题。
缺少订阅和中断的租户
如果成功登录后无法检索订阅,请尝试以下故障排除方法:
- 验证你的帐户是否有权访问所需的订阅。 可以通过登录到尝试使用的 Azure 环境的门户,来验证是否能够访问这些订阅。
- 请确保已通过诸如 Azure、Azure 中国世纪互联、Azure 德国、Azure 美国政府或自定义环境之类的正确 Azure 环境登录。
- 如果你在代理服务器后操作,请确保已正确配置存储资源管理器代理。
- 尝试删除并重新添加帐户。
- 如果有“更多信息”或“错误详细信息”链接,请查看针对失败的租户报告的错误消息。 如果你不确定如何处理错误消息,请在 GitHub 上提出问题。
在 AzCopy 传输过程中与操作系统凭据存储交互时出现问题
如果在 Windows 上看到此消息,则 Windows 凭据管理器很可能已满。 若要在 Windows 凭据管理器中腾出空间,请执行以下步骤:
- 关闭存储资源管理器。
- 在“开始”菜单中,搜索“凭据管理器”并将其打开。
- 转到“Windows 凭据”。
- 在“通用凭据”下,查找与不再使用的程序关联的条目并将其删除。 还可以查找与
azcopy/aadtoken/<some number>
类似的条目并将这些条目删除。
如果完成上述步骤后消息继续显示,或者你在 Windows 以外的其他平台上看到此消息,则可在 GitHub 上提出问题。
无法删除附加的存储帐户或资源
如果无法通过 UI 删除附加的帐户或存储资源,可以通过删除以下文件夹来手动删除所有附加的资源:
- Windows:%AppData%/StorageExplorer
- macOS:/Users/<your_name>/Library/Application Support/StorageExplorer
- Linux:~/.config/StorageExplorer
先关闭存储资源管理器,然后删除这些文件夹。
注意
如果你曾经导入过任何 SSL 证书,请备份 certs 目录的内容。 以后,可以使用备份来重新导入 SSL 证书。
代理问题
存储资源管理器支持通过代理服务器连接到 Azure 存储资源。 如果通过代理连接到 Azure 时遇到任何问题,请参考下面的建议。
存储资源管理器仅支持通过代理服务器进行基本身份验证。 不支持其他身份验证方法,例如 NTLM。
注意
存储资源管理器不支持使用代理 auto-config 文件来配置代理设置。
验证存储资源管理器代理设置
“应用程序”>“代理”>“代理配置”设置决定了从哪个源存储资源管理器获取代理配置 。
如果选择“使用环境变量”,请确保设置 HTTPS_PROXY
或 HTTP_PROXY
环境变量。 环境变量区分大小写,因此请务必设置正确的变量。 如果这些变量未定义或无效,则存储资源管理器将不使用代理。 修改任何环境变量后,重启存储资源管理器。
如果选择“使用应用代理设置”,请确保应用内代理设置正确。
用于诊断问题的步骤
如果仍遇到问题,请尝试以下故障排除方法:
- 如果在不使用代理时可以连接到 Internet,请确认未启用代理设置时存储资源管理器可以正常工作。 如果存储资源管理器成功连接,则原因可能是代理服务器有问题。 与管理员合作,找到问题所在。
- 确认使用代理服务器的其他应用程序按预期运行。
- 验证是否能够连接到尝试使用的 Azure 环境的门户。
- 确认可以收到来自服务终结点的响应。 在浏览器中输入其中一个终结点 URL。 如果可以连接,应会收到一个
InvalidQueryParameterValue
或类似的 XML 响应。 - 检查其他人是否可以使用存储资源管理器通过同一代理服务器进行连接。 如果他们可以连接,则可能需要与代理服务器管理员联系。
诊断问题的工具
一个可以帮助你诊断问题的网络工具,例如 Fiddler。
- 将你的网络工具配置为在本地主机上运行的代理服务器。 如果必须继续在实际代理后面工作,则可能必须将网络工具配置为通过代理进行连接。
- 检查网络服务工具使用的端口号。
- 将存储资源管理器代理设置配置为使用本地主机和网络工具的端口号,例如
localhost:8888
。
正确设置后,网络工具将存储资源管理器发出的网络请求记录到管理和服务终结点。
如果你的网络工具看起来没有记录存储资源管理器流量,请尝试使用不同的应用程序来测试你的工具。 例如,输入其中一个存储资源的终结点 URL,例如 https://contoso.blob.core.windows.net/
在 Web 浏览器中。 将收到类似于以下代码示例的响应:
<?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>
此响应表示资源存在,虽然你无法访问它。
如果网络工具仅显示了来自其他应用程序的流量,则你可能需要在存储资源管理器中调整代理设置。 否则,可能需要调整工具的设置。
与代理服务器管理员联系
如果代理设置正确,则可能需要与代理服务器管理员联系,以便:
- 确保代理不会阻止到 Azure 管理或资源终结点的流量。
- 验证代理服务器使用的身份验证协议。 存储资源管理器仅支持基本身份验证协议。 存储资源管理器不支持 NTLM 代理。
“无法检索子级”错误消息
如果通过代理连接到 Azure,请确认代理设置正确无误。
如果订阅或帐户的所有者已授予你对资源的访问权限,请验证你是否具有该资源的读取或列出权限。
连接字符串没有完整的配置设置
如果收到此错误消息,则表示你可能没有所需的权限来获取你的存储帐户的密钥。 若要进行确认,请转到门户并找到你的存储帐户。 右键单击存储帐户的节点并选择“在门户中打开”。 然后转到“访问密钥”窗格。 如果没有查看密钥的权限,你将看到“你没有访问权限”消息。 若要解决此问题,可以获取帐户名称和密钥或帐户共享访问签名并使用它来附加存储帐户。
如果确实看到帐户密钥,请在 GitHub 中提出问题,以便我们可以帮助你解决问题。
“添加新连接时出错: TypeError: 无法读取未定义的属性 'version'”
如果在尝试添加自定义连接时收到此错误消息,则存储在本地凭据管理器中的连接数据可能会损坏。 若要解决此问题,请尝试删除已损坏的本地连接,然后重新添加它们:
启动存储资源管理器。 在顶部菜单中,转到“帮助”>“切换开发人员工具”。
在打开的窗口中的“应用程序”选项卡上,转到左侧的“本地存储”>“file://” 。
根据有问题的连接类型,查找该连接的密钥。 然后将其值复制到文本编辑器中。 该值是自定义连接名称的数组,例如:
- 存储帐户
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
- 存储帐户
保存当前连接名称后,将“开发人员工具”中的值设置为
[]
。
若要保留未损坏的连接,请使用以下步骤来查找损坏的连接。 如果你不介意丢失所有现有连接,请跳过这些步骤,并按照平台特定的说明清除连接数据。
- 在文本编辑器中,将每个连接名称重新添加到“开发人员工具”。 然后检查连接是否仍正常工作。
- 如果连接正常工作,则表示它未损坏,你可以安全地将其保留。 如果连接不起作用,请从 开发人员工具中删除其值,并记录它,以便稍后再添加它。
- 重复此过程,直到检查完所有连接。
删除连接名称后,必须清除其损坏数据。 然后,可以使用存储资源管理器中的标准连接步骤重新添加连接。
- 在“开始”菜单中,搜索“凭据管理器”并将其打开。
- 转到“Windows 凭据”。
- 在“一般凭据”下,找到包含
<connection_type_key>/<corrupted_connection_name>
键的条目。 例如StorageExplorer_CustomConnections_Accounts_v1/account1
。 - 删除并重新添加这些连接。
如果运行这些步骤后仍遇到此错误,或者你想要分享连接损坏原因的看法,请在 GitHub 页上提出问题。
共享访问签名 URL 的问题
如果你通过共享访问签名 URL 连接到服务并遇到错误:
- 请确认 URL 提供了读取或列出资源所需的权限。
- 验证该 URL 是否未过期。
- 如果共享访问签名 URL 基于某个访问策略,请验证该访问策略是否尚未撤销。
如果意外地使用无效共享访问签名 URL 附加了资源,而现在无法分离资源,请执行以下步骤:
- 运行存储资源管理器时,请选择 F12 以打开“开发人员工具”窗口。
- 在“应用程序”选项卡上,选择左侧的“本地存储”>“file://” 。
- 找到与共享访问签名 URI 的服务类型关联的键。 例如,如果 Blob 容器的共享访问签名 URI 有问题,请查找名为
StorageExplorer_AddStorageServiceSAS_v1_blob
的键。 - 键的值应为 JSON 数组。 找到与有问题的 URI 关联的对象,并将其删除。
- 选择 Ctrl +R 以重新加载存储资源管理器。
存储资源管理器依赖项
存储资源管理器随附在 Windows 上运行时所需的所有依赖项。
修补适用于 .NET Core 更高版本的存储资源管理器
对于 存储资源管理器 1.7.0 或更高版本,可能需要修补存储资源管理器使用的 .NET Core 版本:
转到 NuGet 页面,从 右侧的“下载包 ”链接下载 StreamJsonRpc 版本 1.5.43。
下载该包后,将其文件扩展名从 .nupkg 更改为 .zip。
将包解压缩。
打开 streamjsonrpc.1.5.43/lib/netstandard1.1/ 文件夹。
将 StreamJsonRpc.dll 复制到存储资源管理器文件夹中的以下位置:
- StorageExplorer/resources/app/ServiceHub/Services/Microsoft.Developer.IdentityService/
- StorageExplorer/resources/app/ServiceHub/Hosts/ServiceHub.Host.Core.CLR.x64/
Azure 门户中的“在资源管理器中打开”按钮不起作用
如果在 Azure 门户中单击“在资源管理器中打开”按钮不起作用,请确保使用兼容的浏览器。 以下浏览器已通过兼容性测试:
- 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
通常可以按照以下步骤收集日志:
- 转到“设置”(左侧的齿轮图标)>“应用程序”>“登录”。 选择“详细身份验证日志记录”。 如果存储资源管理器由于身份验证库出现问题而无法启动,则此步骤将为你完成。
- 关闭存储资源管理器。
- 可选/建议:清除 logs 文件夹中的现有日志。 此步骤可减少必须向我们发送的信息量。
- 打开存储资源管理器并重现问题。
- 关闭存储资源管理器。
- 压缩 logs 文件夹的内容。
AzCopy 日志
如果在传输数据时遇到问题,可能需要获取 AzCopy 日志。 可以通过两种不同的方法轻松找到 AzCopy 日志:
对于仍在活动日志中的失败传输,请选择“转到 AzCopy 日志文件”。
对于过去失败的传输,请转到 AzCopy 日志文件夹。 可在以下位置找到此文件夹:
- Windows:C:\Users\<你的用户名>\.azcopy
- macOS:~/.azcopy
- Linux:~/.azcopy
网络日志
对于某些问题,需要提供存储资源管理器发出的网络调用的日志。 在 Windows 上,可以使用 Fiddler 获取网络日志。
注意
Fiddler 跟踪可能包含在收集跟踪期间在浏览器中输入或发送的密码。 请确保阅读有关如何清理 Fiddler 跟踪的说明。 请不要将 Fiddler 跟踪上传到 GitHub。 系统会告诉你可以安全地将 Fiddler 跟踪发送到的位置。
第 1 部分:安装和配置 Fiddler
- 安装 Fiddler。
- 启动 Fiddler。
- 转到“工具”>“选项” 。
- 选择“HTTPS”选项卡。
- 确保已选择“捕获连接”和“解密 HTTPS 流量” 。
- 选择“操作”。
- 选择 “信任根证书 ”,然后在下一对话框中选择“ 是 ”。
- 启动存储资源管理器。
- 转到“设置”(左侧的齿轮符号)>应用程序>代理。
- 将代理源下拉列表更改为“使用系统代理”(预览版)。
- 重启存储资源管理器。
- 应会开始看到来自
storageexplorer:
进程的网络调用显示在 Fiddler 中。
第 2 部分:重现问题
- 关闭除 Fiddler 以外的所有应用。
- 使用左上角的 X,在“视图”菜单附近清除 Fiddler 日志。
- 可选/建议:让 Fiddler 设置几分钟。 如果看到与存储资源管理器不相关的网络调用出现,请右键单击它们,然后选择“立即筛选”>“隐藏<进程名称>”。
- 启动/重启存储资源管理器。
- 重现问题。
- 选择“文件”>“保存”>“所有会话” 。 将其保存在你不会忘记的位置。
- 关闭 Fiddler 和存储资源管理器。
第 3 部分:清理 Fiddler 跟踪
- 双击 Fiddler 跟踪(.saz 文件)。
- 选择 Ctrl + F。
- 在出现的对话框中,确保设置了以下选项:搜索 = 请求和响应以及检查 = 标头和正文。
- 搜索你在收集 Fiddler 跟踪时使用的任何密码,以及突出显示的所有条目。 单击右键并选择“删除”>“所选会话” 。
- 如果在收集跟踪时确实在浏览器中输入了密码,但在使用 Ctrl + F 时未找到任何条目,则不想更改密码,或者所使用的密码用于其他帐户时,请跳过向我们发送 .saz 文件。
- 使用新名称再次保存跟踪。
- 可选:删除原始跟踪。
后续步骤
如果这些解决方案都不起作用,请使用以下方法之一:
通过选择左下角的“向 GitHub 报告问题”按钮在 GitHub 上提出问题。
第三方信息免责声明
本文中提到的第三方产品由 Microsoft 以外的其他公司提供。 Microsoft 不对这些产品的性能或可靠性提供任何明示或暗示性担保。
联系我们寻求帮助
如果你有任何疑问或需要帮助,请创建支持请求或联系 Azure 社区支持。 你还可以将产品反馈提交到 Azure 反馈社区。