> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/zh/zoom-workplace/zoom-phone/zoom-phone-local-survivability-field-guide/troubleshooting.md).

# 故障排除

解决使用 ZPLS 模块时可能出现的常见问题。

本页提供分步说明，用于测试 ZPLS 模块的特定部分，包括互联网连接、测试模式以及如何模拟故障切换。执行这些测试不是必需的，但为了确认可生存性功能，可能会很有必要。

### 测试并验证连接性

完成设置过程后，客户可以测试并验证 Zoom Phone 云与其他常用服务之间的 ZPLS 模块连接性。这些测试可确认云正在正常运行，并且运行 ZPLS 模块所需的所有必要代理和服务都在正确工作。

#### <mark style="color:蓝色;">从 Web 验证 ZPLS 代理运行情况</mark>

要验证 ZPLS 代理状态，请执行以下步骤：

1. 登录 Zoom Web门户。
2. 在 **高级** 在子菜单中，选择 **Zoom Node**.
3. 在屏幕左上角，确认 **Zoom Node - Phone 本地可生存性** 已在下拉菜单中选中。

   <div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/b92TqZFkMRwYSIRBXJgq/Unknown%20image" alt=""><figcaption></figcaption></figure></div>
4. 选择 **Nodes** 下拉菜单右侧的选项卡，并找到相应的服务器。
5. 单击服务器名称，并验证以下两项都 **监控代理** 以及 **节点代理** 进程正在运行。

   <div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/0QvMVi8oe31ALDN6F3FA/Unknown%20image" alt=""><figcaption></figcaption></figure></div>

#### <mark style="color:蓝色;">从 ZPLS 模块验证云连接性</mark>

要从 ZPLS 模块验证网络连接性，请执行以下步骤：

1. 打开虚拟机中的控制台窗口，并使用 **zoom-setup** 创建的用户名和密码 [在安装期间](#_xqxflbqfdqgv).
2. 输入数字 2 进入网络测试工具。

   <div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/ybUkekJU5CIIx5r1VGg7/Unknown%20image" alt="" width="563"><figcaption></figcaption></figure></div>
3. 从测试列表中选择。

   <div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/dv8DJlMtR3ZCffIwqVUf/Unknown%20image" alt="" width="563"><figcaption></figcaption></figure></div>

   1. **通用连接性** 测试 ZPLS 模块与 Zoom 云服务通信的能力。

      <div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/EZfRewkmbV79igrPDFVU/Unknown%20image" alt="" width="563"><figcaption></figcaption></figure></div>
   2. **Phone 连接性** 测试 ZPLS 模块与 Zoom Phone 数据中心通信的能力。

      <div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/xdmZVcgMIMLfiOgeTs0d/Unknown%20image" alt="" width="563"><figcaption></figcaption></figure></div>
   3. **诊断网络** 包含用于测试网络连接性的工具列表。

      <div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/htSxQQzgftlNmW8996mP/Unknown%20image" alt="" width="563"><figcaption></figcaption></figure></div>

### 测试模式

管理员可以在 ZPLS 模块上启用测试模式，以便轻松模拟故障切换事件 & 活动 &直播。在测试模式下，所有 *新的* 客户端注册将路由到 ZPLS 模块，而不是 Zoom Phone 云，之前的注册将不受影响。如果配置了 SBC，则所有呼叫都将通过 SBC 路由，就像可生存性 事件 & 活动 &直播 正在进行一样。要启用测试模式，请执行以下步骤：

1. 登录 Zoom Web门户。
2. 在 [**管理员中心**](https://zoom.com/account) 导航菜单中，单击 **产品配置**，然后 **电话系统**，然后 [**公司信息**](https://zoom.com/pbx/page/telephone/settings#/settings).
3. 单击 **账户设置** 在左上角。

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/5xkRAkCW6DbvqEeC3KnY/Unknown%20image" alt="" width="563"></div>

4. 在下一个屏幕上，找到 **Zoom Node** 子部分，以及 **本地容灾**。单击 **管理** 以加载新页面。

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/brfdE5trFmfNXhzKnQid/Unknown%20image" alt=""><figcaption></figcaption></figure></div>

5. 在新页面上，切换 **测试模式** 开关以启用。

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/DBPMGOly06LJ1L7OELDp/Unknown%20image" alt="" width="563"><figcaption></figcaption></figure></div>

6. 一旦启用测试模式，必须重新启动 ZPLS 模块。要测试与该模块的连接性，用户应注销并重新登录其客户端，以注册到 ZPLS 模块。（重新登录仅适用于测试模式，不适用于可生存性 事件 & 活动 &直播。）

{% hint style="info" %}
测试模式仅限桌面客户端，不会影响诸如 IP 电话之类的物理设备。
{% endhint %}

### 模拟故障切换

除了测试模式之外，客户还可以通过防火墙和网络操控来模拟故障切换。由于测试模式的存在，这不是必需的，但对于希望在模拟场景中测试可生存性解决方案健壮性的客户来说，这是可用的。

要模拟故障切换，必须限制到 Zoom Phone 网络的互联网访问。客户可以通过阻止本文档中列出的所有连接和端口来强制实施此限制。 [网络端口和数据流](#_pswiusfsww6t) 本文件中的该部分。

当连接开始失败后，桌面客户端和物理 IP 电话将检测到网络丢失，并开始故障切换到 ZPLS 模块。桌面客户端将显示以下消息，确认连接不可用：

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/iBKBV5KVuU1xKsH2Br2r/Unknown%20image" alt=""><figcaption></figcaption></figure></div>

要确认客户端已连接到 ZPLS 模块，请执行以下步骤：

1. 单击客户端右上角的头像或图标。
2. 单击 **设置**.
3. 在设置菜单中，选择 **统计信息**.
4. 选择 **电话** 选项卡。
5. 确认 **注册服务器** IP 地址和端口与站点的 ZPLS 模块的 IP 地址和端口相匹配。
6. 如果连接成功，客户端正在可生存性模式下运行。

{% hint style="info" %}
除非它与云之间的 OPTIONS 保活 ping 已失败，否则 ZPLS 模块不会接受 SIP 注册。除了阻止 Zoom Phone 与云之间的流量外，管理员还必须确保阻止 ZPLS 模块与 Zoom Phone 云之间的流量。
{% endhint %}

测试成功后，网络管理员应恢复所有设备和装置之间的完整网络功能，如下文所述。 [网络端口和数据流](#_pswiusfsww6t) 本文件中的该部分。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/zh/zoom-workplace/zoom-phone/zoom-phone-local-survivability-field-guide/troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.