macOS 使用 Privoxy 将 SOCKS5 代理转换为 HTTP 代理
很多代理工具（如 Clash、V2Ray、Shadowsocks）提供的是 SOCKS5 代理。
但有些开发工具（例如某些 CLI、构建工具、老软件）只支持 HTTP/HTTPS 代理。
这时可以使用 Privoxy 作为中间层，将 SOCKS5 代理转换为 HTTP 代理。
一、整体架构
代理请求流程如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
| 应用程序（只支持 HTTP Proxy）
|
v
HTTP Proxy
Privoxy (127.0.0.1:7890)
|
v
SOCKS5 Proxy
127.0.0.1:13659
|
v
代理客户端（Clash / V2Ray / Shadowsocks）
|
v
互联网
|
简单理解：HTTP Proxy -> Privoxy -> SOCKS5 Proxy。
二、安装 Privoxy
macOS 推荐使用 Homebrew：
安装后配置文件通常位于：
1
| /opt/homebrew/etc/privoxy/config
|
三、修改 Privoxy 配置
打开配置文件：
1
| vim /opt/homebrew/etc/privoxy/config
|
在文件末尾添加：
1
2
| listen-address 127.0.0.1:7890
forward-socks5 / 127.0.0.1:13659 .
|
配置说明
listen-address 127.0.0.1:7890
- Privoxy 在本地
7890 端口提供 HTTP 代理服务。
forward-socks5 / 127.0.0.1:13659 .
/：匹配所有请求。127.0.0.1:13659：上游 SOCKS5 代理地址。.：不指定额外 DNS 服务器。
四、启动 Privoxy
1
| brew services start privoxy
|
常用管理命令：
1
2
3
| brew services stop privoxy
brew services restart privoxy
brew services list | grep privoxy
|
五、配置终端代理（可选）
临时生效：
1
2
| export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
|
长期生效（写入 ~/.zshrc）：
1
2
3
| echo 'export HTTP_PROXY="http://127.0.0.1:7890"' >> ~/.zshrc
echo 'export HTTPS_PROXY="http://127.0.0.1:7890"' >> ~/.zshrc
source ~/.zshrc
|
六、测试代理是否生效
1
| curl -x http://127.0.0.1:7890 ipinfo.io
|
如果返回的 IP 为代理出口 IP，说明配置成功。
七、常见使用场景
Git 代理：
1
2
| git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890
|
Docker 代理（~/.docker/config.json）：
1
2
3
4
5
6
7
8
| {
"proxies": {
"default": {
"httpProxy": "http://127.0.0.1:7890",
"httpsProxy": "http://127.0.0.1:7890"
}
}
}
|
pip 代理：
1
| pip install -i https://pypi.org/simple package_name --proxy http://127.0.0.1:7890
|
八、常见问题
- 端口冲突
如果 7890 被占用，可改为其他端口，例如：
1
| listen-address 127.0.0.1:8888
|
并同步更新环境变量与工具配置。
- 查看端口占用
九、总结
通过 Privoxy 可以把 SOCKS5 代理转换为 HTTP 代理，解决“工具只支持 HTTP 代理”的兼容问题。
落地步骤很简单：
- 安装 Privoxy。
- 修改
config 增加 listen-address 与 forward-socks5。 - 启动服务并验证。
- 按需配置系统或工具级 HTTP 代理。
