✻ Connection refused — a firewall or proxy may be blocking it (ConnectionRefused...

🔍 报错分析

1. 🌐 错误翻译

原文：Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)
译文：连接被拒绝 — 防火墙或代理可能正在阻止连接 (连接被拒绝)

2. 🎯 原因分析

该错误表明客户端尝试建立网络连接时，目标服务器主动拒绝了连接请求，根本原因包括：

目标服务未运行：目标服务器上对应的应用程序未启动，导致端口无进程监听

防火墙拦截：本地或服务器的防火墙（如 Windows Defender、iptables、云服务商安全组）拦截了请求端口

代理配置问题：本地或网络代理（如 VPN、Nginx 反向代理）配置错误，导致连接被转发到不可达的地址

端口错误：客户端连接的端口与目标服务监听的端口不匹配

3. 💡 解决方案

根据不同原因提供对应修复步骤，无需修改代码，重点是调整环境配置：

#### 情况1：目标服务未运行
解决步骤：

登录目标服务器，确认服务状态

启动目标服务（以常见服务为例）：

# 通用服务启动示例
systemctl start [服务名]  # 如 systemctl start nginx
# 或直接运行服务程序
[服务启动命令]  # 如 python server.py、java -jar app.jar

#### 情况2：防火墙拦截端口
解决步骤：

本地防火墙（以 Windows 为例）：

1. 打开「控制面板 → 系统和安全 → Windows Defender 防火墙 → 允许应用通过防火墙」
2. 找到目标服务对应的程序，勾选「私有网络」和「公用网络」权限

服务器防火墙（以 Linux 为例）：

开放目标端口（假设端口为 8080）：

# 开放端口并重启防火墙
sudo ufw allow 8080/tcp
sudo ufw reload
# 或使用 iptables
sudo iptables -A INPUT -p tcp --dport 8080 -j ACCEPT
sudo service iptables save

云服务商安全组：登录云控制台，在安全组规则中添加入方向规则，允许指定端口的 TCP 流量

#### 情况3：代理配置错误
解决步骤：

关闭无效代理：

- 本地关闭代理（以 Windows 为例）：「设置 → 网络和 Internet → 代理 → 关闭手动设置代理」
- Linux/macOS 关闭环境变量代理：删除 http_proxy、https_proxy 配置

# 清除环境变量代理配置
unset http_proxy https_proxy

修正代理地址：若需使用代理，确保代理服务器地址、端口正确且能正常连接

4. 🛡️ 预防措施

端口与服务监控：使用工具（如 netstat、ss 命令或 Prometheus 监控）实时查看服务监听端口，确保服务异常时能及时感知

分步验证网络链路：连接前先通过 telnet [目标IP] [端口] 或 nc -zv [目标IP] [端口] 验证端口可达性，快速定位是服务问题还是网络拦截问题

防火墙规则最小化：防火墙仅开放必要端口，避免全端口开放，同时定期审计规则，避免无效或冲突规则导致连接异常