在远程服务器开发代码时，很多开发者会使用VS Code Remote-SSH来进行远程开发。
同时，一些 AI Coding 插件（如 Codex、Copilot 等）需要访问在线服务，因此在远程开发环境中经常会遇到以下问题：
插件登录后一直卡住
插件请求失败
Remote-SSH 多窗口冲突
关闭某个窗口后插件失效
本文记录了一套稳定的远程开发网络配置方案，并总结常见问题的解决方法。
一、VS Code Remote-SSH 工作原理
当我们使用 VS Code Remote-SSH 时，实际架构如下：
VS Code (本地电脑)
│
│ SSH
▼
Remote Server
│
▼
VS Code Server + Extensions
需要注意的一点：
VS Code 插件实际上运行在远程服务器，而不是本地电脑。
因此：
如果某些插件需要访问在线 API，请求实际上是从服务器发出。
如果服务器网络环境有限制，就可能导致插件无法正常工作。
二、解决思路
一个常见解决方案是：
通过 SSH 网络转发，让服务器访问本地网络环境。
结构如下：
本地电脑
│
│ 本地网络环境
│
└──── SSH 隧道 ────► 远程服务器
│
│ VS Code Server
▼
插件服务
这样远程服务器可以通过 SSH 通道访问本地网络。
三、配置 Remote-SSH
首先配置 SSH：
编辑：
~/.ssh/config
示例：
Host dev-server
HostName xxx.xxx.xxx.xxx
User username
ServerAliveInterval 20
ServerAliveCountMax 6
TCPKeepAlive yes
ConnectTimeout 20
参数说明：
| 参数 | 作用 |
|---|---|
| ServerAliveInterval | SSH 心跳 |
| ServerAliveCountMax | 丢包容忍 |
| TCPKeepAlive | 防止 NAT 断线 |
| ConnectTimeout | 防止连接卡住 |
四、VS Code 远程连接
VS Code 打开命令面板：
Remote-SSH: Connect to Host
选择：
dev-server
首次连接会自动安装：
VS Code Server
五、建立 SSH 网络转发
在本地终端运行：
ssh -NR 127.0.0.1:7898:127.0.0.1:7897 dev-server
该命令的作用是：
远程服务器端口
│
│ SSH 网络转发
▼
本地端口
这样服务器访问该端口时，会通过 SSH 通道转发到本地。
六、配置 VS Code Remote 网络设置
在远程 VS Code 中打开：
Preferences: Open Remote Settings (JSON)
添加：
{
"http.proxy": "http://127.0.0.1:7898",
"http.proxySupport": "override"
}
说明：
http.proxy指定网络转发地址proxySupport允许插件使用该配置
七、环境变量配置
为了让命令行工具也使用同样的网络配置，可以在服务器添加：
~/.bashrc
添加：
export HTTP_PROXY=http://127.0.0.1:7898
export HTTPS_PROXY=http://127.0.0.1:7898
export NO_PROXY=localhost,127.0.0.1
重新加载：
source ~/.bashrc
八、验证网络配置
可以在服务器运行：
curl https://example.com
如果返回正常响应，说明网络转发配置成功。
九、稳定使用方式
经过测试发现：
最稳定方式是：
单独终端建立 SSH 网络转发
VS Code 仅负责远程开发
结构如下：
Terminal
│
└─ SSH tunnel
VS Code
│
└─ 使用网络配置
这样可以避免：
多窗口端口冲突
隧道被关闭
Remote-SSH 异常
十、日常使用流程
推荐流程：
1 启动本地网络环境
2 打开终端建立 SSH 转发
3 打开 VS Code
4 Remote-SSH 连接服务器
之后：
可以打开多个 VS Code 窗口
插件正常工作
十一、常见问题
1 插件登录后卡住
通常是网络配置未生效。
检查：
http.proxy
HTTP_PROXY
2 Remote-SSH 经常断开
建议增加 SSH 保活参数：
ServerAliveInterval 20
ServerAliveCountMax 6
3 多窗口冲突
如果每个窗口都建立网络转发，可能导致端口冲突。
建议：
只建立一次 SSH 转发
十二、总结
远程开发环境中，插件网络问题的关键在于：
远程服务器的网络环境与本地环境不同。
通过SSH 网络转发 + VS Code Remote 设置，可以构建一个稳定的远程开发环境。
这种方式具有以下优点：
多窗口稳定
配置简单
调试方便
也是远程开发中非常常见的一种网络配置方式。
