VS Code Remote-SSH 学校远程服务器使用 Codex 指南
该指南适用于已在本地完成 VS Code 与 Codex 配置,需要在校园网服务器或其他受限网络环境下使用 Codex 的场景。核心思路是通过 SSH 端口转发,将远程服务器的网络请求通过本地代理转发,解决无法访问外网的问题,并同步本地登录态以实现远程使用。
01SSH 配置详解
首先需要编辑本地的 SSH 配置文件,建立远程服务器与本地代理的连接通道。这一步骤是确保远程服务器能够通过本地网络环境访问外网的基础。
- 编辑本地 SSH 配置文件
在 ~/.ssh/config 文件中添加以下配置,其中 17897 为本地转发端口,7897 为本地代理端口,可根据实际情况修改未被占用的端口。 - 配置 RemoteForward
RemoteForward 17897 127.0.0.1:7897
此配置将远程服务器的 17897 端口映射到本地的 7897 代理端口。若不配置此项,可能会导致端口争用,影响本地网络连接。 - 连接并建立隧道
执行 SSH 连接命令登录远程服务器。登录成功后,如果看到类似 "Warning: remote port forwarding failed for listen port 17897" 以外的提示,或无报错,说明远程代理入口建立成功。
02环境变量设置
登录远程服务器后,需要配置环境变量使终端流量走代理。建议将配置写入 ~/.bashrc 文件以便自动生效,但在多用户共用服务器环境下,手动启用更为保险。
- 编辑配置文件
在远程 ~/.bashrc 末尾添加:export http_proxy="http://127.0.0.1:17897"
export https_proxy="http://127.0.0.1:17897" - 使配置生效
执行 source ~/.bashrc 命令。 - 验证代理状态
分别执行 curl -I http://www.google.com 和 curl -I https://www.google.com 测试 HTTP 和 HTTPS 连接。也可以执行 curl ip.sb 查看公网出口 IP,若返回结果则说明远程服务器已通过本地代理出网。
03登录缓存同步
当远程服务器无法直接登录 Codex 时,可以将本地的登录缓存上传至远程复用。此步骤利用本地已完成的认证信息,解决远程环境的网络认证障碍。
- 确认本地缓存存在
在本地执行 test-path ~/.openai(PowerShell)或 ls ~/.openai(Linux/macOS)。若返回 True 或文件列表,说明本地已有缓存。 - 上传缓存至远程
执行 scp -r ~/.openai user@remote_host:~,将本地缓存目录复制到远程用户主目录。
04VS Code 设置配置
仅设置 Shell 代理不足以支持 VS Code 远程扩展的通信,需分别在本地和远程的 VS Code 设置中配置代理地址,确保扩展进程也能正常联网。
- 配置本地 Settings
在本地 VS Code 的 settings.json 中添加:"http.proxy": "http://127.0.0.1:7897"。 - 配置远程 Settings
连接服务器后,在 Remote Settings (JSON) 中添加:"http.proxy": "http://127.0.0.1:17897"。注意区分本地端口与远程转发端口。
05故障排查
完成上述配置后,若 Codex 仍无法响应,通常是由于端口冲突或进程残留导致。需重点检查本地端口占用情况及远程登录缓存状态。
| 故障现象 | 可能原因 | 排查命令与解决方法 |
|---|---|---|
| Codex 对话无响应 | VS Code 或其他程序占用了本地代理端口 | 本地检查:netstat -ano | findstr :7897(Windows) 确保端口仅由代理程序占用,关闭占用进程。 |
| 远程无法登录 Codex | 未同步本地登录缓存或缓存失效 | 远程检查:ls ~/.openai 若不存在,重新从本地上传缓存目录。 |
| 本地网络异常 | SSH RemoteForward 配置错误导致端口争用 | 检查 SSH 配置中 RemoteForward 的端口映射是否正确,删除多余转发配置。 |
常见问题排查表
当前文章无评论,是时候发表评论了