CentOS 上 Postman 网络连接问题排查与修复
一 快速判断与定位
- 明确方向：是 Postman 无法访问外网（如 GET https://postman-echo.com/get 超时），还是访问内网/本机服务（如 http://localhost:5000 报错）。前者多与代理/防火墙/证书相关，后者多与监听地址/端口/防火墙相关。
- 外网连通性：在终端执行以下任一命令，确认基础网络与 DNS 正常。
- curl 检测：curl -I https://postman-echo.com/get
- 端口连通：telnet postman-echo.com 443 或 nc -vz postman-echo.com 443
- 本机/内网连通性：
- 监听端口：ss -lntp | grep :端口 或（若未安装 net-tools）netstat -lnpt | grep :端口
- 连通测试：curl -I http://127.0.0.1:端口 与 curl -I http://服务器IP:端口
- 防火墙状态：firewall-cmd --state（返回 running 表示开启）。必要时仅做临时测试可 systemctl stop firewalld，验证后再恢复并改为放行端口。
二 常见原因与对应修复
- 代理配置不当
- 现象：外网请求卡住或报 Could not get response。
- 处理：在 Postman 右上角齿轮进入 Settings → Proxy，按需选择“Use System Proxy”或配置“Custom Proxy”。若两者同时开启，自定义代理优先。公司网络下，确保代理地址、端口、认证信息正确；如访问内网地址需将 localhost/127.0.0.1/内网网段加入代理的 Bypass 列表，避免被代理拦截。
- 系统未配置代理环境变量
- 现象：终端能 curl，但 Postman 走不了外网（或相反）。
- 处理：在 CentOS 设置环境变量（对当前会话或全局生效），例如：
- 查看：env | grep -i proxy
- 设置：export http_proxy=http://代理地址:端口 与 export https_proxy=http://代理地址:端口
- 取消：unset http_proxy https_proxy
如需持久化，写入 /etc/profile 或 ~/.bashrc 后执行 source 使其生效。
- 服务器端口未开放或仅本地监听
- 现象：访问 服务器IP:端口 超时/拒绝，但本机 curl 正常。
- 处理：
- 开放端口（示例为 5000/tcp）：firewall-cmd --zone=public --add-port=5000/tcp --permanent && firewall-cmd --reload
- 检查监听是否对外：ss -lntp | grep :5000，若显示为 127.0.0.1:5000 则仅本机可访问，需改为 0.0.0.0:5000。
- 证书/SSL 验证问题
- 现象：访问 HTTPS 报证书不受信任或验证失败。
- 处理：短期可在 Postman 的 Settings → General 关闭“SSL certificate verification”用于排查；生产环境应导入受信任 CA 证书或修复服务端证书链。
- 服务不可用或网关转发失败
- 现象：返回 503 Service Unavailable / Forwarding failure。
- 处理：核查上游服务是否健康、端口是否真正监听、负载/网关策略是否拒绝请求，并结合服务器日志定位。
三 一键排查命令清单
- 查看网络与 DNS：ping -c 4 8.8.8.8；nslookup postman-echo.com
- 外网连通：curl -Iv https://postman-echo.com/get；telnet postman-echo.com 443
- 本机监听：ss -lntp | grep :端口（或 netstat -lnpt | grep :端口）
- 防火墙：firewall-cmd --state；firewall-cmd --list-ports；firewall-cmd --zone=public --add-port=端口/tcp --permanent && firewall-cmd --reload
- 代理变量：env | grep -i proxy；如需持久化，编辑 /etc/profile 或 ~/.bashrc 并执行 source
四 Postman 内关键设置
- 代理设置路径：Settings → Proxy
- 使用“System Proxy”将沿用操作系统代理配置；
- 使用“Custom Proxy”可手动指定 HTTP/HTTPS 代理主机与端口；
- 两者同时开启时，自定义优先；访问内网/本地服务时，将 localhost/127.0.0.1/内网网段加入 Bypass 列表以避免被代理。
- SSL 验证：Settings → General → SSL certificate verification，排查阶段可临时关闭，上线前务必开启并正确配置证书。
五 仍无法解决时建议准备的信息
- 具体报错截图或文本（如 Could not get response / 503 / timeout）。
- 复现步骤与请求信息（URL、方法、头、体）。
- 系统与网络信息：cat /etc/centos-release；ip a；firewall-cmd --state；ss -lntp | grep :端口。
- 代理与环境变量：env | grep -i proxy；Postman 中 Proxy 与 SSL 设置页面截图。
- 相关日志：Postman 日志（如 ~/.config/Postman/logs/postman.log）与服务器端错误日志。
