版本: v1.0 修改日期: 2026-05-29

本手册用于验证目标 IP 是否可达、目标 TCP 端口是否可访问。按本手册从 viSCADA 侧、节点侧、容器侧逐层测试后,读者可以定位网络不通发生在哪一层,并据此联系相应责任方处理。

1 测试前准备

1.1 需要提前确认的信息

1.2 需要具备的访问权限

• 能够登录服务器或 K8s 节点
• 能够进入业务容器(Pod)

ℹ️ 如无相关权限或连接资料,请联系实施人员获取对应的 IP、账号和密码。

1.3 测试结果判断口径

本手册所有测试步骤均按以下三类结果进行判断,后续章节不再重复说明。

2 整体测试流程

按”从业务入口到底层容器”的顺序逐层收敛,出现异常即在对应层级定位。

图 1 网络连通性测试四步流程

3 viSCADA 侧测试

3.1 Ping 测试

• 进入路径: 「后台管理」 → 「调试工具」 → 「网络诊断工具」 → 「Ping 工具」
• 输入: 目标 IP 或域名

💡 Ping 不通不代表端口不通 —— 部分现场环境禁用了 ICMP,建议继续执行端口测试。

3.2 Telnet 测试

• 进入路径: 「后台管理」 → 「调试工具」 → 「网络诊断工具」 → 「Telnet 工具」
• 输入: 目标 IP 与端口
• 结果判断: 参见 1.3 测试结果判断口径

图 2 viSCADA Telnet 测试界面

4 节点侧测试

在服务器或 K8s 节点上执行,用于确认是否存在 “viSCADA 侧可以访问,但业务运行节点无法访问” 的情况。

4.1 Ping 测试(可选)

ping 172.16.2.121

图 3 节点 Ping 测试示例

4.2 TCP 端口测试

推荐使用 telnet,无该命令时使用 curl 备用。

方式一:telnet(推荐)

telnet 172.16.2.121 22

图 4 节点 telnet 端口测试

方式二:curl(备用)

curl -v telnet://172.16.2.121:22

图 5 节点 curl 端口测试

结果判断参见 1.3 测试结果判断口径。

5 容器与多节点测试

5.1 进入 Pod 并测试

用于确认是否存在 “节点可访问,但业务容器无法访问” 的情况。

1. 查看 Pod 并进入:

   kubectl get pods -A -o wide
   kubectl exec -it -n <namespace> <pod-name> -- sh

2. 在容器内重复执行 4.2 TCP 端口测试 的命令,结果判断参见 1.3 测试结果判断口径。

5.2 多节点对比测试

当出现”某些位置可访问、某些位置不可访问”时执行本步。

1. 查看业务 Pod 所在节点:

   kubectl get pod -n <namespace> <pod-name> -o wide

2. 选择至少 2 台节点(建议包含业务 Pod 所在节点),分别执行 4 节点侧测试 与 5.1 进入 Pod 并测试 的命令。

3. 对比不同节点、不同 Pod 的测试结果,定位问题范围。

6 常用端口参考表

7 常见问题

7.1 viSCADA 侧测试正常,但 connector 日志仍提示连接失败

现象:

• viSCADA 侧 Ping / Telnet 测试结果正常
• connector 日志中仍提示”连接失败""超时""拒绝连接”等错误

图 6 connector 日志报错示例 1

图 7 connector 日志报错示例 2

常见原因与处理建议:

⚠️ 若多层测试均正常但日志仍报错,请将各层测试结果截图与 connector 报错日志一并反馈给实施人员。