--- title: "Azure HA vSocket 故障排除" slug: "azure-ha-vsocket-troubleshooting" updated: 2026-09-25T23:12:26Z published: 2026-09-25T23:12:26Z canonical: "knowledge.catonetworks.com/azure-ha-vsocket-troubleshooting" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Azure HA vSocket 故障排除 ## 概述 本文提供了对常见 Azure vSocket HA 部署问题的见解,并提供了解决这些问题的故障排除步骤。本指南旨在协助在通过 HA 脚本或市场部署 HA 解决方案期间和之后识别并解决潜在障碍。 ## 症状 在部署 Azure vSocket HA 时,您可能会遇到以下症状: - **HA 脚本失败** - 手动部署中执行 create_ha_settings 脚本失败。 - 通过市场部署次要 vSocket 时出现问题。 - **HA 切换失败** - 来自 Socket WebUI 的 HA API 测试失败。 - HA 切换失败导致流量未转发到次要 vSocket。 - **HA 状态未就绪** - CMA 显示站点的 HA 状态为未就绪 ## 可能的原因 HA 部署失败的最常见原因包括: - 在 Azure 中使用非公共 DNS。 - 管理接口缺乏互联网访问。 - Azure 账户权限不足。 - Azure 中限制性安全组和路由设置。 - 未能将浮动 IP 地址分配给 LAN 接口。 - LAN 连接性问题。 ## 问题排查 > [!NOTE] > 重要: > > 在开始排查故障之前,请确保验证 Azure HA vSocket 部署的所有前提条件。参见[配置 Azure vSockets 的高可用性 (HA)](/v1/docs/configuring-ha-for-azure-vsockets)和[从市场部署 Azure vSockets](/v1/docs/deploying-azure-vsockets-from-the-marketplace) ### HA 脚本故障排除 Azure HA 脚本 (create_ha_settings) 和通过市场部署次要 vSocket 验证该 Azure 订阅具有两个有效的 vSocket,然后分配**角色**,创建 HA 和切换机制。如果脚本运行失败,请按照这些故障排除步骤操作: #### 检查活动日志 - 在 Azure 中,**活动日志**存储每个 Azure 资源内部发生的所有事件。如果部署不成功并且未分配某一角色,请查看这些日志。浏览到**VM**或**NIC**,选择活动日志 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/17227011216413(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=qpOg10NDCDW9xhwZw7SCbpWZicCGzubvg1hxkFuCXLs%3D) #### 检查 Azure 命名限制 - 在脚本中输入 vSocket 名称时,请确保名称不包含空格或受限字符,具体说明见[命名规则和限制](https://learn.microsoft.com/zh-cn/azure/azure-resource-manager/management/resource-name-rules)。 - 如果在部署期间出现命名问题,错误日志中将显示以下错误。 ```plaintext 参数 disk.name 的值无效。(代码:InvalidParameter,目标:disk.name) ``` #### 检查 Azure DNS 配置 - 确保已为 VNET 和关联的 NIC 配置公共 DNS(或默认的 Azure DNS)。如果在 Azure 中未在 VNET 和 NIC 都配置公开 DNS,则角色创建将失败。 - 要检查 Azure DNS 配置,请参阅 查看 [修复 DNS 配置问题](/v1/docs/azure-ha-vsocket-troubleshooting#h_01HQ15Z6JN49GPAHHNTMBGAJXA) #### 检查 Azure 权限 - 要成功运行 HA 脚本,请确保 Azure 用户具有 所有者 权限。导航到**资源组** > **访问控制 IAM > 查看我的访问**,并验证用户账户设置为**所有者**或更高角色。参见 [Azure 内置角色](https://learn.microsoft.com/zh-cn/azure/role-based-access-control/built-in-roles)。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/17227040198813(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=e2toxCM%2BOvD3tzlNGdtfepfrHWMUkXPJnI4Z9aMnxHg%3D) #### 验证 Azure 角色分配 - 运行在 [验证 Azure 角色分配](/v1/docs/azure-ha-vsocket-troubleshooting#01J7BXC8KYJKXSG7YXCV4AS93V) 中提供的步骤,以确认资源组中列出的身份角色已分配给 LAN NIC、LAN 子网和两个 vSocket VM。 #### 重新运行 HA 脚本 - 如果前述步骤已检查完毕,最后可以重新运行 HA 脚本 (create_ha_settings)。 - 务必[更新 Azure 令牌](/v1/docs/azure-ha-vsocket-troubleshooting#h_01HQ162RV8ERWVSZ6S2VK3GQXW)并删除在第一次运行脚本时创建的 Azure 管理的身份。 ### HA 切换故障排除 如果 HA 脚本成功运行但 vSocket HA 切换未按预期发生(例如,流量未路由到次要 vSocket),请遵循这些步骤: #### 运行 HA API 测试 - 从 vSocket webUI,运行来自两个 vSocket 的 API 测试工具以验证到 Azure 的 API 调用可以成功进行。可以在此处看到权限或浮动 IP 分配的任何错误。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/17227011268253(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=mIUEXn%2F2Sb6P4zivkzITtN2%2Bm%2FvcQhIB%2BdxnBI5iiXM%3D) #### 检查活动日志 - 在 Azure 中,**活动日志**存储每个 Azure 资源内部发生的所有事件。查看这些日志以识别浮动 IP 是否无法传递到**LAN NIC**或 API 测试是否不成功。浏览到**NIC**,选择活动日志 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/17227011279005(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=KgnzX6y7SixK51BZYka4iAHLdglBrrnHN4xdxu%2BOJ44%3D) #### (可选)Ping 浮动IP - 从局域网内的主机使用 Ping 工具,并对浮动IP地址进行 ping 操作。如果此测试不成功,请继续[验证浮动IP分配](/v1/docs/azure-ha-vsocket-troubleshooting#h_01HQ16A0B631616G6Z8RB7TNXR) ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(211).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=4iQicFCyv14scbRQz%2BOUiveo3H5cpIVxSBYr%2BNObk1o%3D) #### 验证浮动 IP 分配 - 为了将流量路由到主 vSocket,Azure 将浮动 IP 分配给当前主 vSocket 的 LAN NIC。转到主要 vSocket VM **LAN NIC > IP 配置** 并验证浮动 IP 是否存在为“次要”。如果没有,请继续以下步骤。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/17227040280477(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=I35PvH3qy%2FGeBAIQHWWrbYQqtrcHi5SSm2EB6dJ9xjI%3D) #### 验证 Azure 角色分配 HA 托管身份必须正确关联到参与故障切换的所有 Azure 资源。 - 在 Azure vSocket 部署期间,HA **身份角色** 被创建并存储在 Azure **托管身份** 中。 - 每个资源应只分配**一个用户分配的**角色。如果策略在 Azure 中添加**系统分配的**身份,则 vSocket 必须排除在外。 - 此角色分配给连接到 vSocket 的各种虚拟资源。 Azure 基础设施中使用该角色的组件为: - 局域网网络接口(**NIC**)用于每个vSocket - 与 LAN NIC 关联的 LAN 子网 - 两个 vSocket 虚拟机 - **NIC** 的角色分配可以在 **访问控制 > 角色分配** 下检查,并应分配给主要和次要的 **LAN NIC**。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/17227040208669(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=IpDagEft1RSopHw5Acr1PyR0Z6vgxuATE4kHAYzB6g4%3D) - LAN子网的**角色**分配可以在**VNET > 子网**下检查,然后选择LAN子网并点击**管理用户 > 角色分配**。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/21650248417181(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=GqIJjC0eeoY7iyPDzpLSMGHk79jiYpbXPJawzBe6DnY%3D) - 对于每个 **vSocket VM**,可以在 **安全性 > 身份** > **用户分配** 下检查身份角色,如下图所示。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/17227011257757(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=RSi6BN5neJHD2jDH7XXQTvnyHxxwWqm2ZXDNh%2FZz9f8%3D) - 任何**系统分配**角色都不应分配给 VM 。 要验证此点,请转到 **安全性 > 身份 > 系统分配** 并确保每个 vSocket VM 的 **状态** 选项已设置为 **关闭**。![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/36264165100957.png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=uwYbqqpDjhZfySMvBtYD6zNlJDfBVHyCsnIJteyA3dI%3D) - 如果此 HA 身份角色没有安装在上述资源上,部署过程可能已失败。如果任何相关资源中缺少角色,您可以再次运行 [Cato HA 脚本](/v1/docs/configuring-ha-for-azure-vsockets)。或者,次要 Azure vSocket 可以[重新部署](/v1/docs/deploying-azure-vsockets-from-the-marketplace),这样会安装缺失的 HA 身份角色。 #### 检查管理接口是否有 DNS 和互联网访问权限 - 确认管理接口有互联网访问权限并且可以连接到已配置的 DNS 服务器。 - 从 Azure 门户检查 *management.azure.com* 的 DNS 解析。 HA API 调用使用此 FQDN。 - 转到**虚拟机 > vSocket > 运行命令 > 运行Shell脚本** - 在文本框中输入**dig management.azure.com**。 - 点击运行 - dig 输出将在门户中显示 DNS 响应。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/17227040290333(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=1oDoU3sS40ewd%2BvfJkHVOpQqqtODsaup5urXBUUl0fI%3D) - 如果没有 DNS 解析,请参阅 [修复 DNS 配置问题](/v1/docs/azure-ha-vsocket-troubleshooting#h_01HQ15Z6JN49GPAHHNTMBGAJXA)。 - 从同一页面尝试访问任何互联网资源以确认互联网访问。例如,`ping -c 4 8.8.8.8`如果 ping 未成功,继续以下步骤。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/18381368031389(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=SzX7ku5Mig%2BatxcvzQFma4JVxEKUDP8CWjUhanefwL0%3D) #### 检查网络安全组是否阻止出站流量。 > [!NOTE] > 注意: > > 如果在 [vSockets 上实施了 2-NIC 解决方案](/v1/docs/migrating-azure-vsockets-to-a-2-nic-solution)。在 WAN 接口上执行此故障排除步骤。 - 快速检查的方法是转到 Azure 中的 MGMT 网络接口并点击屏幕左下方的 "有效的安全规则"。 - 下图显示未分配 NSG,因此出站流量未被阻塞。![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/17227011319837(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=cCUIfx9j%2BmUve51iFPzdOn59Uyp8VraZtNvsNwDrc7Q%3D) #### 检查 MGMT 接口的互联网流量路由。 > [!NOTE] > 注意: > > 如果在 [vSockets 上实施了 2-NIC 解决方案](/v1/docs/migrating-azure-vsockets-to-a-2-nic-solution)。在 WAN 接口上执行此故障排除步骤。 - 如果 MGMT 接口流量通过 Azure 中的第三方防火墙进行路由,请检查是否允许 UDP/53 和 TCP/443 出站连接。 - 可以通过在 Azure 的管理接口页面上点击 "有效路由" 选项来查看路由表。 - 下图显示了使用"下一跳类型"为"互联网"的互联网流量路由,因此防火墙未阻止流量。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/17227011333149(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=AK93%2F8W%2Fo4ojCcyQrh1eT03suOXYYUSWS8wfV0uNOZc%3D) #### 检查路由表的下一跳 - 确认 LAN 路由表指向浮动 IP。如有需要,更改**下一跳 IP 地址**。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/17227011341853(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=NivRMRvpdYfRHIJxlEAZFmN5bIXjVYBOcKAcrsWUHFg%3D) ### 故障排除 HA 状态未就绪 如果CMA显示HA状态未就绪并且两个vSockets都已上线且运行中,则两个vSockets将承担主控角色(**分脑场景**)。可能有两个相关问题: - 两个 vSockets 运行不同的固件版本 - HA 保持活动消息无法到达次要 vSocket ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/17227011352989(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=7uFoy7QMLbAdPCv8ijO6v4ladY5nZ%2BbxCryhcobcoVk%3D) 建议查看两者vSocket的[WebUI](https://support.catonetworks.com/hc/zh-cn/articles/4413265669905-Using-the-Socket-WebUI)页面以确认每个vSocket的HA状态。如果主控和次要 vSocket 都在主控角色中,将出现分脑场景。 WebUI将在主监控页面的顶部显示当前角色。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/17227040342301(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=dJC%2BRfFZ50CA8Y6ivx9BzqqOe9jOQPJlFuUfoFc4Yn0%3D) #### 检查固件版本 为了满足兼容版本标准,两个vSocket必须运行相同的**主版本**,例如v17.xx.yy或v18.xx.yy。vSocket在第一部署后执行初始升级。如果其中一个 vSocket 升级失败,必须对该问题进行故障排除。提交[支持工单](https://support.catonetworks.com/hc/zh-cn/articles/360017066338-Submitting-a-Support-Ticket)以报告该问题。 #### 检查 HA 保持活动 保持活动数据包使用Azure vSocket的端口UDP/20480,并且仅从主控vSocket发送到备用vSocket。当两个 vSocket 都成为主控角色时,会出现分脑状况,这可能由于 vSocket 之间的 LAN 连接问题,导致 HA 保持活动消息无法到达次要 vSocket。 运行以下检查以确认 LAN 连接性: - 检查网络安全组是否阻止了端口UDP/20480。快速检查 NSG 规则的方法是转到 Azure 中的每个 LAN 网络接口,然后在屏幕左下角单击"有效安全规则"。 - 确认两个 LAN 接口均关联到相同的 LAN 子网。 - 从两个 vSocket 的 WebUI [运行数据包捕获](/v1/docs/how-to-capture-traffic-on-a-socket),并确定主要 vSocket 发送的保持活动是否被次要 vSocket 接收。 ## 解决发现的问题 #### 更新 Azure 令牌 - 如果使用 Azure Cloud Shell 部署 HA 脚本,请打开新会话并重新认证。这将更新用于查询 API 的令牌。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/17227011391005(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=L9Ki6qnBgta6ePqbVq6Y69P7Wvtinmsfnsbd2Ai%2BLYM%3D) #### 修复 DNS 配置问题 - 要修复 Azure DNS 配置并将其设置为默认值,请转到 **虚拟网络** > **DNS 服务器** 和 **网络接口 > DNS 服务器**,确保您正在使用 **默认** 选项或 **公共 DNS 服务器**。请关闭 VM 以进行任何与 DNS 相关的更改,然后重新启动它。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/17227011434525(1).png?sv=2026-02-06&spr=https&st=2026-11-19T04%3A34%3A20Z&se=2026-11-19T05%3A34%3A20Z&sr=b&sp=r&sig=6KiRAG9HAlHAR2ImzbyX7E3bzGRQcZVmeuIy34WalCg%3D) #### 注销并重新部署 Azure vSocket - 如果在执行上述所有故障排除步骤后,HA 脚本或 HA 故障转移继续失败,可以注销并重新部署一个或两个 vSocket。请参阅 [重新部署高可用性 vSocket 站点](https://support.catonetworks.com/hc/zh-cn/articles/14201956436509-Unregistering-and-Redeploying-Azure-vSockets#h_01HCWD62AAWMF2907J0EDY7535) - 在重新部署 vSocket 之前,请务必遵循指南并移除虚拟机、网络接口、相关的公共 IP 和已管理身份。 - 如果只重新部署主要的 vSocket 实例,您必须运行专用的 HA 脚本(create_ha_settings)以将两个 vSocket 实例绑定为 HA。 ## 向卡托支持提交案例 提交[支持工单](/v1/docs/submitting-a-support-ticket),附上上述故障排除步骤的结果。请在票据中包含以下信息: - 问题的明确描述,包括任何错误信息。 - **management.azure.com** 的 DNS 测试结果 - API 测试结果。 - 分配的浮动IP、已配置的身份角色、有效路由和有效安全规则的截图。 - Azure活动日志截图,包括发现的任何错误。