ZCenter 部署或访问因端口未放通失败，如何排查？

问题说明

本文用于排查ZCenter部署后无法访问、接口返回502/503、服务启动失败或服务之间无法发现等端口和依赖连通性问题。本文区分外部代理端口与Gateway内部端口，避免将8100和8200混用。

现象

• 客户端访问 http://<host>:8100 时连接超时、Connection refused或无法建立连接。
• 8100可以连接但返回502/503，或页面能打开但API请求失败。
• 服务启动日志出现连接 3306、6379、5672、8848 被拒绝、超时或认证失败。
• Gateway可访问，但访问 /api/portal/...、/api/vm/... 等接口返回503或无路由。

适用环境

• 产品：ZCenter
• 版本：5.1.0
• 组件：Caddy/反向代理、Gateway、Nacos、Base及各业务服务
• 部署形态：单节点或多节点；实际端口可能被部署参数、容器映射、负载均衡或防火墙策略覆盖

可能原因

• 外部防火墙、负载均衡或安全组未放通8100，或者Caddy没有监听该端口。
• Caddy监听8100但无法连接本机Gateway 8200。
• Gateway未启动，或启动后无法连接Nacos 8848，导致服务发现/路由失败。
• Base、Portal或业务服务使用的内部端口与实际部署映射不一致。