🚀 VSCode 远程连接服务器并启用开发辅助插件的完整指南

——端口映射 + 本地授权同步 + VSCode 插件联动

注意：部分命令Windows版本和Linux版本不一致，如反向代理隧道创建，请注意修改

📌 一、背景与常见问题

在使用 VSCode Remote-SSH 进行服务器端开发时，许多人会遇到以下情况：

• 服务器所在环境无法直接访问某些依赖源
• VSCode 某些插件需要联网才能激活，但服务器端缺少浏览器
• CLI 工具在服务器无法进行交互式登录
• VSCode 插件安装后提示授权失败
• 远程环境和本地环境的登录状态无法同步
• -VSCode中Codex插件登录报错：Token exchange failed: token endpoint returned status 403 Forbidden

为了让远程开发更加顺畅，本文给出一套可复现的完整流程：

目标：

1. 通过端口映射方式让服务器具备访问依赖的能力
2. 在本地完成某些插件的授权登录，然后同步到服务器
3. VSCode Remote 插件可以正常运行

---

🎯 二、总体方案结构

部分	内容
Part 1	使用 SSH 端口映射构建访问链路
Part 2	在本地登录 CLI 工具，并将授权同步到服务器
Part 3	VSCode 中安装与验证开发辅助插件

---

🟦 Part 1：通过 SSH 建立本地与服务器之间的端口映射

由于服务器环境可能无法直接获取某些依赖，可以通过 SSH 提供的端口映射功能，将本地访问能力映射到服务器使用。

📌 1. 端口映射命令示例

在本地终端执行：

ssh -NT -R 7890:localhost:7890 -p 3366 youruser@<服务器地址>

说明：

• -R A:B:C 表示将服务器的某个端口映射到本地端口上
• 过程是安全的，不会暴露任何额外服务
• 整个窗口需要保持开启，以便持续提供访问链路

---

📌 2. 在服务器配置访问环境

方式1（简洁）
编辑服务器用户的环境变量文件：

nano ~/.bashrc

添加：

export http_proxy="http://127.0.0.1:7890"
export https_proxy="http://127.0.0.1:7890"

应用：

source ~/.bashrc

方式2（推荐，加入了自动检测功能）
打开：

nano ~/.bashrc

在最后粘贴以下内容：

# 自动检测代理是否可用
PROXY_SERVER="127.0.0.1"
PROXY_PORT="7890"

# 5 秒超时，避免 SSH 终端卡死
if curl -x http://$PROXY_SERVER:$PROXY_PORT \
        -s --max-time 5 --head https://www.google.com \
        | grep "HTTP/1.1 200" > /dev/null; then
    echo "[INFO] 本地代理可用，自动启用代理"
    export http_proxy="http://$PROXY_SERVER:$PROXY_PORT"
    export https_proxy="http://$PROXY_SERVER:$PROXY_PORT"
else
    echo "[WARN] 本地代理不可用，使用直连"
    unset http_proxy
    unset https_proxy
fi

应用：

source ~/.bashrc

---

🟩 Part 2：在本地登录工具并同步授权到服务器

部分开发类工具在服务器端缺少浏览器时无法登录，可通过以下方式解决：

• 本地登录
• 将生成的授权文件同步到服务器

📌 1. 在本地安装 CLI 工具

npm install -g @openai/codex codex

📌 2. 本地完成授权登录

codex login

📌 3. 授权文件路径

C:\Users\<你的用户名>\.codex\auth.json

📌 4. 同步到服务器

mkdir -p ~/.codex
cp /mnt/c/Users/<你的用户名>/.codex/auth.json ~/.codex/auth.json
chmod 600 ~/.codex/auth.json

📌 5. 服务器验证

codex status

---

🟧 Part 3：在 VSCode 中使用插件

📌 1. Remote SSH 登录服务器

📌 2. 安装 Codex 插件

📌 3. 插件将自动读取授权信息

📌 4. 测试插件功能

---

🎉 最终效果（完整验证）

功能	状态
服务器可顺利安装开发依赖	✔
CLI 工具在远程环境可正常调用	✔
本地授权成功同步到服务器	✔
VSCode 插件自动登录并正常使用	✔
整套系统可长期稳定运行	✔

---

📚 ZGCA AI4GEO 2025 Fall term

欢迎收藏与分享，希望对你的开发环境配置有所帮助！