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)与服务器端错误日志。