如何设置和使用HTTP Proxy代理

HTTP Proxy 设置与使用指南

一 基础概念与准备

• HTTP 代理是在客户端与目标服务器之间的中介，常用于访问受限资源、隐藏真实 IP、缓存与加速。常见代理端口为 80、8080、3128。使用前需准备：代理服务器的 IP/域名、端口、以及是否需要用户名/密码；若用户名或密码包含特殊字符（如 @、#、$、% 等），需进行 URL 百分号编码（例如将 @ 编码为 %40）。同时，很多工具遵循小写的环境变量 http_proxy/https_proxy，也支持大写 HTTP_PROXY/HTTPS_PROXY；对不走代理的地址可设置 NO_PROXY（如 localhost,127.0.0.1）。

二 操作系统与命令行设置

• Windows 命令行（临时生效）
  • 设置：set http_proxy=http://127.0.0.1:8118 与 set https_proxy=http://127.0.0.1:8118
  • 查看：echo %http_proxy%
  • 取消：set http_proxy= 与 set https_proxy=
• Linux 或 macOS 终端（临时生效）
  • 设置：export http_proxy=http://127.0.0.1:8118 与 export https_proxy=http://127.0.0.1:8118
  • 如需让 wget/curl 等也走 SOCKS5，可额外设置：export ALL_PROXY=socks5://127.0.0.1:1080
  • 取消：unset http_proxy、unset https_proxy、unset ALL_PROXY
• Git 全局代理（适用于 git:///http(s)://）
  • 设置：git config --global http.proxy http://127.0.0.1:8118 与 git config --global https.proxy http://127.0.0.1:8118
  • 取消：git config --global --unset http.proxy 与 git config --global --unset https.proxy
• 说明：上述为当前会话/用户级设置；若需系统范围或持久化，可将 export 写入 ~/.bashrc、~/.zshrc、~/.profile 或系统环境变量配置中。

三 浏览器与桌面应用设置

• Chrome（Windows/macOS）
  • 路径：设置 → 高级 → 系统 → 打开代理设置 → 在系统的 Internet 属性中选择“使用代理服务器”，填写 地址 与 端口；如需认证，填入 用户名/密码 并保存。
• Firefox
  • 路径：选项 → 高级 → 网络 → 设置 → 选择“手动代理配置”，填写 HTTP 代理与端口；如需认证，填写凭据并确认。
• Windows 系统级（控制面板）
  • 路径：控制面板 → 网络和 Internet → Internet 选项 → 连接 → 局域网设置 → 勾选“使用代理服务器”，填写 地址/端口 并保存。
• macOS 系统级
  • 路径：系统设置 → 网络 → 选中当前网络 → 高级/详细信息 → 代理 → 勾选“Web 代理(HTTP)”或“安全 Web 代理(HTTPS)”，填写 服务器与端口并应用。

四 开发语言与工具中的使用

• Python（requests）
  • 通过环境变量：
    • os.environ['http_proxy'] = 'http://proxy.example.com:8080'
    • os.environ['https_proxy'] = 'https://proxy.example.com:8443'
  • 通过请求参数：
    • proxies = {'http': 'http://proxy.example.com:8080', 'https': 'https://proxy.example.com:8443'}
    • requests.get('http://example.com', proxies=proxies)
  • 代理认证：在 URL 中嵌入凭据 http://user:pass@host:port，或使用 HTTPProxyAuth；如使用 SOCKS，安装 requests[socks] 后配置 socks5://。
• Python（urllib 标准库）
  • 使用 ProxyHandler 与 build_opener 全局设置代理，后续 urlopen 自动走代理。
• Docker 守护进程
  • 创建目录：mkdir -p /etc/systemd/system/docker.service.d
  • 新建文件：/etc/systemd/system/docker.service.d/http-proxy.conf，内容示例：
    • [Service]
    • Environment="HTTP_PROXY=http://proxy.example.com:8080" "HTTPS_PROXY=https://proxy.example.com:8080" "NO_PROXY=localhost,127.0.0.1"
  • 使配置生效：systemctl daemon-reload && systemctl restart docker
• 常用命令行工具
  • curl：直接指定 -x/--proxy，如 curl -x http://proxy.example.com:8080 https://example.com
  • yum：在 /etc/yum.conf 中添加 proxy=http://proxy.example.com:8080（如需认证可用 proxy=http://user:pass@host:port）
  • wget：在 /etc/wgetrc 中设置 http_proxy=... 与 https_proxy=...。

五 验证与排错

• 验证是否走代理
  • 访问 http://httpbin.org/ip 或 https://httpbin.org/ip，查看返回的 origin 是否为代理 IP。
  • 命令行快速检查：curl -I https://httpbin.org/ip（配合 -x 指定代理测试）。
• 常见问题与处理
  • 认证失败或密码含特殊字符：确保使用 user:password@host:port 格式，并对 @、#、$、% 等进行 URL 编码（如 @ → %40）。
  • 某些工具不生效：注意工具是否遵循 http_proxy/https_proxy/HTTP_PROXY/HTTPS_PROXY；必要时在工具内单独配置或使用其支持的代理方式（如 curl -x）。
  • 内网地址不应走代理：为 Docker、yum、wget 等配置 NO_PROXY=localhost,127.0.0.1 等例外，避免访问本机/内网服务异常。
  • 配置未生效：检查是否写入了正确的配置文件、是否执行了重载（如 source ~/.bashrc 或 systemctl daemon-reload && systemctl restart docker），以及是否重启了相关应用/终端会话。