Coder 开发环境的代理配置指南（MacOS）

[hongziqi]

⚠️ 如果你已经可以稳定访问 Coder 开发环境，可跳过本文档。
Coder 使用方法详见：Coder 使用指南

背景说明

由于东莞地区连接部署在香港的 Coder 服务时，经常出现网络不稳定、高延迟等问题，建议通过搭建 SOCKS5 代理 并配合 HTTP 代理 使用，以提升连接的稳定性和可用性。

该方案同时适用于远程办公场景，如在家连接开发环境排查问题。

环境准备

环境	描述
代理服务器 A	110.110.110.110（具备科学上网能力，已配置白名单）
本地设备 B	Mac 电脑
工具依赖	SSH、VSCode、Privoxy（可选，用于 SOCKS5 转 HTTP）

以下所有操作均在本地设备 B 上进行。

快速方案（已有 HTTP 代理）

如果你已有 HTTP 代理且配置了白名单（例如 http://120.120.120.120:2222），可直接配置 VSCode 和终端代理：

1. 打开 VSCode，在设置中搜索 proxy，设置如下内容：

"http.proxySupport": "on",
"http.proxy": "http://120.120.120.120:2222",
"https.proxy": "http://120.120.120.120:2222"

2. 终端代理设置（推荐写入 ~/.zprofile）：

export HTTP_PROXY=http://120.120.120.120:2222
export HTTPS_PROXY=http://120.120.120.120:2222

标准方案：搭建本地 SOCKS5 + HTTP 代理

步骤一：搭建本地 SOCKS5 代理隧道

在终端执行以下命令，建立本地 SOCKS5 代理：

 ssh -D 1080 -N -f -o ServerAliveInterval=60 -o ServerAliveCountMax=3 ubuntu@110.110.110.110

参数说明：

• -D 1080: 本地监听 1080 端口，创建 SOCKS5 代理
• -N: 不执行远程命令，仅建立通道
• -f: 后台运行 SSH
• ServerAlive*: 保活设置，避免 SSH 连接断开

建议写入 SSH 配置文件：~/.ssh/config，便于后续快速连接：

Host candy-proxy
  HostName 110.110.110.110
  User ubuntu
  DynamicForward 1080
  ServerAliveInterval 60
  ServerAliveCountMax 3
  ExitOnForwardFailure yes

后续启动代理只需执行：

ssh -N -f candy-proxy

步骤二：配置浏览器代理

使用 SmartProxy 或其他浏览器代理插件，配置 SOCKS5：

步骤三：配置 VSCode 和终端代理

方法1： 直接使用 SOCKS5 代理（推荐尝试）

1. 打开 VSCode，进入设置界面，搜索 Proxy
2. 设置Http: Proxy为socks5://127.0.0.1:1080

或直接修改settings.json文件，添加以下内容：

"http.proxySupport": "on",
"http.proxy": "socks5://127.0.0.1:1080",
"https.proxy": "socks5://127.0.0.1:1080",

⚠️ 注意：VS Code 本身可支持 SOCKS5，但某些插件（如 Coder）不会继承该配置，仍需配置环境变量。

3. 配置终端代理（以支持 Coder 插件、git、curl 等）
   在 ~/.zprofile 添加以下内容：

export HTTP_PROXY=socks5://127.0.0.1:1080
export HTTPS_PROXY=socks5://127.0.0.1:1080

方法2： 使用 Privoxy 将 SOCKS5 转为 HTTP 代理 （实测兼容性更好）

若 Coder 不支持 SOCKS5 代理，可通过 Privoxy 将其转换为 HTTP 代理

1. 安装 Privoxy:

brew install privoxy

2. 编辑配置文件/opt/homebrew/etc/privoxy/config，添加以下内容：

# 将所有请求转发至本地 SOCKS5 代理
forward-socks5t / 127.0.0.1:1080 .
# 监听本地 8118 端口作为 HTTP 代理
listen-address 127.0.0.1:8118

3. 启动 Privoxy 服务:

brew services start privoxy

4. 配置 VSCode 使用 HTTP 代理（编辑 settings.json）：

"http.proxySupport": "on",
"http.proxy": "http://127.0.0.1:8118",
"https.proxy": "http://127.0.0.1:8118",

5. 配置终端代理：
   在 ~/.zprofile 添加以下内容：

export HTTP_PROXY=http://127.0.0.1:8118
export HTTPS_PROXY=http://127.0.0.1:8118

6. （可选）配置系统全局代理前往【系统设置】>【Wi-Fi】>【代理】页，设置 HTTP 与 HTTPS 代理地址为：

• 服务器：127.0.0.1
• 端口：8118