Win10 + VSCode 远程连接Ubuntu 20.04 超简配置指南

前言

日常开发中，我们常需要在Win10本地操作Ubuntu远程工作机，用VSCode远程开发能兼顾本地编辑器的便捷性与远程服务器的算力。本文基于Ubuntu 20.04 + Win10，手把手教你配置VSCode远程SSH连接，全程简洁无冗余，直接复制命令即可完成。

前置准备

Ubuntu端：已开启SSH服务、防火墙放行22端口（基础环境）
Win10端：安装VSCode、OpenSSH客户端（系统自带/手动安装）
网络环境：Win10与Ubuntu处于同一内网（你的Ubuntu IP为10.15.48.132/21，用户名astro）

一、Ubuntu端配置（必做）

1. 安装并启动SSH服务

# 1. 安装openssh-server
sudo apt update && sudo apt install -y openssh-server

# 2. 启动并设置开机自启
sudo systemctl enable --now ssh

# 3. 验证服务状态（显示active (running)即成功）
sudo systemctl status ssh

2. 放行防火墙（关键！）

Ubuntu 20.04默认启用UFW防火墙，需放行SSH端口：

# 放行SSH端口
sudo ufw allow ssh
# 若防火墙未开启，执行以下命令启用
sudo ufw enable

3. 验证SSH连接（本地测试）

# 测试本机SSH连通性
ssh localhost
# 输入Ubuntu密码后登录，退出用 exit

# 记录本机ip
ip a
# 记录enp5s0或类似端口的IP地址，如果有斜杠，忽略斜杠及后面的内容

二、Win10端准备（必做）

1. 安装OpenSSH客户端

Win10默认自带，若未安装则按以下步骤操作：

打开「设置」→「应用」→「可选功能」
搜索「OpenSSH客户端」，未安装则点击「添加功能」安装

2. 安装VSCode远程插件

打开VSCode，点击左侧扩展（快捷键Ctrl+Shift+X）
搜索插件 Remote - SSH（微软官方插件），点击安装

三、VSCode远程连接配置（核心步骤）

方式1：快速连接（推荐，无需手动写配置）

打开VSCode，点击左下角远程连接图标（<>形状）
选择 Connect to Host → Add New SSH Host
在输入框中填写SSH连接命令：
```
ssh usrname@xx.xx.xx.xx
```
选择SSH配置文件路径：默认选C:\Users\你的Win10用户名\.ssh\config
弹出提示后，点击Connect，输入Ubuntu登录密码，即可连接远程Ubuntu

方式2：配置SSH免密登录（便捷，无需重复输密码）

1. Win10生成SSH密钥

打开Win10的PowerShell/命令提示符，执行以下命令（一路回车，无需设置密码）：

# 生成ed25519类型密钥（更安全）
ssh-keygen -t ed25519

密钥默认保存路径：C:\Users\你的Win10用户名\.ssh\

2. 将公钥发送到Ubuntu

# 把Win10公钥推送到Ubuntu远程服务器
ssh-copy-id usrname@xx.xx.xx.xx
# 输入Ubuntu密码后，公钥自动写入Ubuntu的~/.ssh/authorized_keys

3. 简化连接配置（可选，VSCode自动识别）

Win10的C:\Users\你的Win10用户名\.ssh\config文件会自动生成以下内容，无需手动修改：

Host 方便记忆的名子
  HostName xx.xx.xx.xx
  User usrname
  Port 22

方式3：自定义别名配置（方便记忆）

若想给远程Ubuntu起别名（如ubuntu_astro），直接编辑Win10的config文件，添加以下内容：

# 自定义别名
Host 方便记忆的名子
  HostName xx.xx.xx.xx
  User usrname
  Port 22
  # 免密登录（可选，已配置密钥则保留）
  IdentityFile C:\Users\你的Win10用户名\.ssh\id_ed25519

后续在VSCode中直接选择ubuntu_astro即可连接。

四、常见问题排查

连接超时/被拒绝
- 检查Ubuntu SSH服务是否运行：sudo systemctl status ssh
- 检查防火墙是否放行22端口：sudo ufw status
- 确认Win10与Ubuntu在同一内网（ping测试：ping 10.15.48.132）
密码输入后仍连接失败
- 检查Ubuntu的~/.ssh/authorized_keys权限：chmod 600 ~/.ssh/authorized_keys
- 检查SSH配置文件权限：Win10的config文件仅当前用户可读写
VSCode远程插件安装失败
- 重启VSCode，重新点击远程连接图标触发插件安装
- 切换网络（如手机热点）重试（国内网络有时会卡顿）

总结

Ubuntu端：装SSH、开防火墙，基础环境一步到位
Win10端：装OpenSSH、VSCode Remote插件，无需额外配置
核心操作：VSCode一键添加SSH主机，配置免密后可零密码远程开发

至此，你已完成VSCode远程连接Ubuntu的全部配置，后续直接打开VSCode，左下角选择远程主机，即可像操作本地文件一样编辑远程代码，还能直接运行远程终端命令，高效便捷！

posted @ 2026-02-05 14:11 adgk07 阅读(502) 评论(0) 收藏举报

刷新页面返回顶部

adgk07