vscode用remote ssh连接服务器的流程

以下是一套完整、可落地的 VS Code Remote-SSH 离线部署 连接服务器流程整合了之前的所有要点适配新版 VS Code高版本需 CLIServer 双包覆盖从环境准备到验证连接的全环节一、前置准备本地环境安装 VS Code并安装Remote - SSH插件扩展市场搜索即可远程服务器确保服务器开启 SSH 服务systemctl status sshd验证且你有服务器的账号密码 / 密钥核心信息确认本地 VS Code 版本 Commit ID按CtrlShiftP→ 输入About: Version记录版本如 1.94.1和 Commit ID你的是7d842fb85a0275a4a8e4d7e040d2625abbf7f084服务器架构执行uname -mx86_64 对应x64aarch64 对应arm64。二、离线下载 VS Code Server 相关包本地 / 有网机器操作1. 下载新版 CLI 包必需bash运行# 替换为你的 Commit IDx64 适配服务器架构arm64 替换成 linux_arm64 wget https://vscode.download.prss.microsoft.com/dbazure/download/stable/7d842fb85a0275a4a8e4d7e040d2625abbf7f084/vscode_cli_linux_x64_cli.tar.gz -O vscode_cli.tar.gz2. 下载新版 Server 核心包必需bash运行# 同样替换 Commit IDx64 适配架构 wget https://vscode.download.prss.microsoft.com/dbazure/download/stable/7d842fb85a0275a4a8e4d7e040d2625abbf7f084/vscode-server-linux-x64.tar.gz -O vscode-server.tar.gz3. 上传包到远程服务器用 SCP/FileZilla 等工具将下载好的vscode_cli.tar.gz和vscode-server.tar.gz上传到服务器的~目录用户主目录。三、远程服务器部署核心步骤登录远程服务器执行以下命令已替换你的 Commit ID直接复制bash运行# 1. 创建新版目录结构新版必需 mkdir -p ~/.vscode-server/cli/servers/Stable-7d842fb85a0275a4a8e4d7e040d2625abbf7f084 mkdir -p ~/.vscode-server/bin # 2. 解压 Server 核心包到指定目录 tar -zxvf vscode-server.tar.gz -C ~/.vscode-server/cli/servers/Stable-7d842fb85a0275a4a8e4d7e040d2625abbf7f084 --strip-components1 # 3. 解压 CLI 包并重命名通信桥梁 tar -zxvf vscode_cli.tar.gz -C ~/.vscode-server/bin mv ~/.vscode-server/bin/code ~/.vscode-server/bin/code-server # 4. 赋予执行权限避免权限不足 chmod x ~/.vscode-server/bin/code-server chmod -R x ~/.vscode-server/cli/servers/Stable-7d842fb85a0275a4a8e4d7e040d2625abbf7f084 # 5. 创建标记文件告诉 VS Code 无需在线下载 touch ~/.vscode-server/cli/servers/Stable-7d842fb85a0275a4a8e4d7e040d2625abbf7f084/0四、本地 VS Code 连接远程服务器1. 配置 SSH 连接打开 VS Code点击左侧「远程资源管理器」远程 SSH 图标点击「」号 → 输入ssh 用户名服务器IP -p 端口默认端口 22如ssh root192.168.1.100选择 SSH 配置文件默认选第一个即可配置会自动保存。配置文件示例SSH 配置文件基础说明VS Code 会将 SSH 配置保存在本地的~/.ssh/configLinux/macOS或C:\Users\你的用户名\.ssh\configWindows文件中这个文件支持多服务器配置语法简洁且易维护。完整配置文件示例config# 配置文件说明 # 1. Host自定义服务器别名连接时显示的名称 # 2. HostName服务器IP/域名 # 3. User登录服务器的用户名 # 4. PortSSH端口默认22非默认需手动指定 # 5. IdentityFile私钥文件路径免密登录用 # 6. ForwardAgent开启代理转发可选 # 7. ServerAliveInterval保持连接避免超时 # 示例1基础连接密码登录默认端口22 Host my-server-1 HostName 192.168.1.100 User root Port 22 ServerAliveInterval 60 # 示例2自定义端口 密钥免密登录推荐 Host my-server-2 HostName 10.0.0.5 User ubuntu Port 2222 # 非默认SSH端口需修改为实际端口 IdentityFile ~/.ssh/my_private_key # 本地私钥文件路径Windows写绝对路径C:\Users\XXX\.ssh\id_rsa ForwardAgent yes ServerAliveInterval 60 # 示例3适配你的场景替换为你的服务器信息 Host my-remote-server HostName 你的服务器公网IP/内网IP User 你的服务器用户名如root/ubuntu Port 22 # 若服务器改了端口替换成实际端口 ServerAliveInterval 60配置文件使用说明修改关键参数Host可以自定义名称如my-serverVS Code 远程资源管理器中会显示这个别名HostName替换为服务器的实际 IP 或域名如47.98.XX.XXUser替换为登录服务器的用户名如root、ubuntu、centosPort默认 22若服务器修改了 SSH 端口如 2222需对应修改IdentityFile如果用密钥免密登录填写本地私钥文件的绝对路径Windows 注意路径分隔符用\或/如C:/Users/张三/.ssh/id_rsa。保存配置文件Linux/macOS修改后保存~/.ssh/config并赋予权限chmod 600 ~/.ssh/config避免权限过高报错Windows保存到C:\Users\你的用户名\.ssh\config即可无需额外权限配置。VS Code 中使用配置完成后VS Code 远程资源管理器会直接显示Host定义的别名如my-remote-server点击即可连接无需重复输入ssh 用户名IP。2. 建立连接在远程资源管理器中找到刚配置的服务器右键 → 「在新窗口中连接」选择服务器系统如 Linux输入服务器密码或用密钥免密等待连接建立底部状态栏显示「SSH: 服务器 IP」即表示连接成功。具体操作方法详见https://blog.csdn.net/qq_42417071/article/details/138501026?ops_request_miscelastic_search_miscrequest_id807d2afa574f483b464c5877c9c64478biz_id0utm_mediumdistribute.pc_search_result.none-task-blog-2~all~top_positive~default-1-138501026-null-null.142^v102^pc_search_result_base6utm_termvscode%E8%BF%9E%E6%8E%A5ssh%E8%BF%9C%E7%A8%8B%E6%9C%8D%E5%8A%A1%E5%99%A8spm1018.2226.3001.4187五、常见问题排查版本不匹配连接时提示版本错误 → 重新核对本地 Commit ID确保下载的包和本地版本一致404 下载失败CLI/Server 包下载 404 → 替换架构如 x64 换 arm64或确认 Commit ID 正确权限错误部署时提示 Permission denied → 命令前加sudo如sudo tar -zxvf ...连接超时检查服务器 SSH 端口是否开放本地能否 ping 通服务器。总结新版 VS Code Remote-SSH 必须同时下载 CLI 包和 Server 包且目录结构为cli/servers/Stable-[Commit ID]部署核心解压双包到指定目录 赋予执行权限 创建标记文件避免在线下载连接关键本地配置 SSH 信息后选择对应服务器系统验证连接状态底部状态栏。