VS Code 教学工作区 · 课程 0002 · 约 15 分钟 · 前置:无 · 2026-10-04

远程开发:编辑界面在本机,文件与终端在服务器

这节课的胜利:你现在有两台服务器可以一键连上 —— <原有服务器IP>(原有)与 <服务器IP>(本课新配)。 在 VS Code 里选主机、点连接,直接编辑服务器上的 /home/ubuntu,全程不输一次密码; 更重要的是,你能拿这三步给任何一台新服务器照做,并用一条命令验证免密真的生效。

0 | 这节课解决了什么麻烦

使命里写着「配置顺手的工作区」—— 而你的代码有一半不在本机:服务器上跑着服务,笔记和项目在本机。 在配好之前,碰服务器只有两条路:要么在服务器上用 vim 改文件,要么每次 scp 来回搬。这一课把这条路剪掉。

具体要解的麻烦有三个,各自对应本课的一个概念:

1 | 三条最小知识

① 公钥认证(public key authentication)

痛点:密码是「双方共知的一个字符串」——能猜、能偷看、能重放,而且每次登录都要再传一次。

定义:把「共知的密码」换成「一对配对成立的钥匙」:私钥只留本机,公钥放到服务器的 ~/.ssh/authorized_keys,登录时由本机拿私钥签名、服务器用公钥验签。

大白话:你家门锁配了一把只能开一次却每次都不一样的钥匙 —— 门上装的锁芯(公钥)人人可看,能开门的钥匙(私钥)从不离身;锁芯挡的是猜门的人,不是看你锁芯的人。

② ~/.ssh/config

痛点:同一台机器,ssh -i ~/.ssh/id_ed25519 -p 22 ubuntu@<服务器IP> 这一串每周要打十几次。

定义:OpenSSH 的客户端配置文件,一个 Host 块 = 一台主机的别名 + 它的默认参数;命令行 ssh 别名 与 VS Code 的 Remote-SSH 读的是同一份。

大白话:手机通讯录。存过一次「妈妈的号码」,之后按名字拨号就行 —— 号码变了改一处,所有地方都跟着变。

③ Remote-SSH 的工作方式

痛点:失焦地在两端各干一半 —— 本机有编辑器没文件,服务器有文件没编辑器。

定义:VS Code 的 Remote-SSH 扩展把界面留在本机,把扩展宿主、文件读写、集成终端、调试器都放到服务器上跑;首次连接时它会往服务器的 ~/.vscode-server/ 装一份自己的服务端。

大白话:你在家按遥控器,机器人在机房干活 —— 屏幕上看到的目录树、终端、报错,全是机器人那边的真实情况,不是本机缓存的副本。

串起来就是一条链:

本机 VS Code→SSH 公钥认证→服务器 ~/.vscode-server→编辑 /home/ubuntu

所以有两件容易踩的事:插件装在服务器上(远端那套和本机那套是分开的),首次连接会慢(要下载服务端),之后才快。

2 | 已经配好的状态(本课实测)

本课不只是讲解:下面这些改动是本次会话里真做完并验证过的,你现在就可以直接用。

位置改了什么为什么
本机 C:\Users\23652\.ssh\id_ed25519(+.pub)沿用已有的 ed25519 密钥对,未新建私钥不出本机;公钥是可公开的那一半
服务器 <服务器IP>:~/.ssh/authorized_keys追加本机公钥 1 行;~/.ssh 权限 700、文件 600公钥在这里才能被服务器用来验签
本机 C:\Users\23652\.ssh\config新增 Host <服务器IP> 块(User ubuntu、ServerAliveInterval 30、ServerAliveCountMax 3)与 <原有服务器IP> 同一套写法;ServerAlive* 让静默掉线在约 90 秒后才算断
VS Code 用户设置 settings.jsonremote.SSH.remotePlatform 增加 "<服务器IP>": "linux"跳过「远端是什么系统」的提问框
VS Code 用户设置 settings.jsonremote.SSH.path 固定为 C:\Program Files\Git\usr\bin\ssh.exe本机有两套 ssh:不固定时扩展会挑 PATH 里第一个找到的,实测挑到 Windows 自带那个会 17 秒超时(见第 3 节最后一行)
VS Code 用户设置(原有)remote.SSH.remoteServerListenOnSocket: true数据走 socket 转发而不是监听端口,云主机上更不容易被安全组/防火墙拦住
服务器 /etc/ssh/sshd_config 与 sshd_config.d/50-cloud-init.confPasswordAuthentication no(两处都改,各自备份为 *.bak-20261004)免密确认可用后关掉密码登录;注意 drop-in 排在主文件之前生效,只改一处等于没改
服务器 sshd_config.d/00-hardening.conf 与 cloud.cfg.d/99-ssh-pwauth.cfg前者再写一遍 PasswordAuthentication no(文件名排序最前);后者写 ssh_pwauth: false腾讯云 vendor-data 里是 ssh_pwauth: true,每次开机 cloud-init 会把 50- 那份改回 yes —— 这两份是防它回写的兜底
服务器 ~/.vscode-server/extensions/装了 ms-azuretools.vscode-containers 2.5.2(只这一个,与中文语言包)远端扩展装在服务器上,与本机那套是两份;装法见下面小节

服务器侧的环境(实测):Ubuntu 26.04 LTS,主机名 VM-0-6-ubuntu,内存 3.7 GB,根盘 59 GB(已用 10%),腾讯云 ap-beijing。本机 VS Code 1.140.0。

验证结果:免密登录已通 —— ssh -o BatchMode=yes <服务器IP> 'echo OK' 直接返回,没有任何密码提示;从 VS Code 连上去后,服务器上实际跑起了 vscode-server 进程(首次连接约 20~30 秒,之后是秒级)。

要用的时候怎么打开

远端扩展怎么装(本次实测)

远端扩展装在服务器的 ~/.vscode-server/extensions/,和本机那份是两套。三条路:

  1. 窗口里装(最直观):已连上远端时,扩展面板里的按钮会变成「Install in SSH: <服务器IP>」,点它。
  2. 服务器自带 CLI(命令行最稳):~/.vscode-server/cli/servers/Stable-*/server/bin/code-server --install-extension 扩展ID。本次就是这样装上的。
  3. 本机 CLI code --remote ...:本次实测误报「Extension ... is already installed」—— 本机恰好也装了同一个扩展,它就当装过了,远端其实没装。要核对必须回读服务器的 extensions.json,别只看本机输出。

这台机器上只装了 ms-azuretools.vscode-containers(2.5.2)。注意:服务器上还没有 docker CLI(docker --version 无输出),所以这个扩展现在只能显示「找不到 Docker」—— 要真用它管容器,得先在服务器上装 Docker 引擎。

3 | 下次给新服务器配:三步 + 一步自检

整套动作只有三件事,只有第二步需要输一次密码(那也是最后一次):

# ① 本机:还没有密钥才做(已有就跳过)
ssh-keygen -t ed25519 -C "23652@ELEVEN237038"

# ② 本机:把公钥送上服务器(要输一次登录密码)
ssh-copy-id -i ~/.ssh/id_ed25519.pub ubuntu@新服务器IP

# ③ 本机:写进 C:\Users\23652\.ssh\config
# Host 新服务器IP
#   HostName 新服务器IP
#   User ubuntu
#   ServerAliveInterval 30
#   ServerAliveCountMax 3

# ④ 自检:这一条能返回 OK,就说明以后永远不用再输密码
ssh -o BatchMode=yes 新服务器IP 'echo OK'
步骤做错的典型症状纠正
②ssh-copy-id: command not found(少见的精简系统)改用一行手动追加:ssh ubuntu@IP "mkdir -p ~/.ssh && echo '$(cat ~/.ssh/id_ed25519.pub)' >> ~/.ssh/authorized_keys"
③连上了但每次仍问密码用 ssh -v 别名 看它试了哪把钥匙;确认 User 与公钥所在账号一致
④Permission denied (publickey)多半是权限:服务器上 chmod 700 ~/.ssh && chmod 600 ~/.ssh/authorized_keys
④一直转圈、最后超时首次连接在下载服务端,等 20~30 秒;服务器上 ls ~/.vscode-server 能看到目录就说明在装;再不通查云安全组是否放行 22 端口
用命令行打开时弹出「工作区不存在 / 请选择另一个工作区」从 Git Bash 调用 code 时,MSYS 会把 /home/ubuntu 改写成 C:\Program Files\Git\home\ubuntu(本课实测踩到);用完整 URI 并关掉改写:MSYS2_ARG_CONV_EXCL='*' code --folder-uri "vscode-remote://ssh-remote+<服务器IP>/home/ubuntu",或者改用上面的方式 ①
报 Connecting with SSH timed out扩展挑到了另一套 ssh(C:\WINDOWS\System32\OpenSSH\ssh.exe):同一个命令在 Git Bash 里 0.5 秒、在扩展里 17 秒无任何输出后超时把 remote.SSH.path 固定到 Git 自带的 ssh.exe(本课已设);定位看「输出 → Remote - SSH」面板里那行 remote.SSH.path = ... 与 Running script with connection command: "...ssh.exe"
连不上的窗口反复重试服务器上短时间堆积大量已认证会话(本课实测 25 分钟 34 次)先把那个窗口关掉(「关闭远程」),再从命令面板重新连 —— 留着它只会不断重试,还把日志搞乱

顺带一条安全意识:免密配好之前别急着关服务器的密码登录 —— 先确认密钥能进(上面第 ④ 步),再关。本课没有把任何密码写进本库,凭据请留在你自己的密码文件或云控制台里。怎么关、坑在哪,见下一节。

关掉密码登录(本课已做)

这台机器上真正的开关不在主文件里,而且云镜像会把你改的东西改回去。先看生效值,再改:

# ① 看现在到底生效的是什么(别猜)
sudo sshd -T | grep -iE "^(passwordauthentication|kbdinteractiveauthentication)"

# ② 备份 → 改两处 → 加一道兜底 → 语法校验 → 热加载(不踢掉现有会话)
sudo cp -a /etc/ssh/sshd_config /etc/ssh/sshd_config.bak-20261004
sudo cp -a /etc/ssh/sshd_config.d/50-cloud-init.conf /etc/ssh/sshd_config.d/50-cloud-init.conf.bak-20261004
sudo sed -i 's/^PasswordAuthentication yes$/PasswordAuthentication no/' /etc/ssh/sshd_config.d/50-cloud-init.conf
sudo sed -i 's/^#PasswordAuthentication yes$/PasswordAuthentication no/' /etc/ssh/sshd_config
printf 'PasswordAuthentication no\nKbdInteractiveAuthentication no\n' | sudo tee /etc/ssh/sshd_config.d/00-hardening.conf
sudo sshd -t && sudo systemctl reload ssh

三个坑:① sshd 的取值规则是「第一个出现的值生效」,而主文件开头就是 Include /etc/ssh/sshd_config.d/*.conf —— 云镜像里的 50-cloud-init.conf(写着 PasswordAuthentication yes)会盖掉主文件,只改主文件等于没改。② 用 reload 而不是 restart:reload 是给 sshd 发 SIGHUP 重读配置,现有会话不掉(这台机器的 ssh.service 恰好是 KillMode=process,别的发行版不一定)。③ 云镜像会回写:腾讯云的 vendor-data 里写着 ssh_pwauth: true(见 /var/lib/cloud/instances/*/vendor-data.txt),每次开机 cloud-init 都会把 50-cloud-init.conf 重新写成 yes —— 因为它排得靠前,你改的主文件救不了。所以加一个排序最前的 00-hardening.conf 兜底,另在 /etc/cloud/cloud.cfg.d/99-ssh-pwauth.cfg 里写 ssh_pwauth: false,尽量让 cloud-init 自己就别写 yes。

验证三条(本机实测):密钥登录仍返回 KEY_LOGIN_OK;强制只用密码时服务器直接回 Permission denied (publickey),连密码提示都不给;把 50- 那份手动改回 yes 模拟开机回写,sshd -T 依旧报 passwordauthentication no —— 兜底那份确实赢了。回滚路:两份 *.bak-20261004 拷回、删掉兜底文件即可;万一密钥丢了,还能从云控制台的 VNC 登录救回来。

4 | 自测(选项一样长,别从长度上猜)

1. 私钥与公钥分别该放在哪?

对。私钥是身份本身,不出本机;公钥可公开,放在服务器 authorized_keys 里。反过来放等于把钥匙挂在门上,和密码一样糟。

2. 让「以后连接都不输密码」的是什么?

对。关键在于认证方式换了 —— 服务器认的是「你能用私钥签出正确的名」,不是「你记得住那串字符」。所以密码留在服务器上、或者私钥被复制过去,都没解决问题。

3. ~/.ssh/config 里的 Host 块在做什么?

对。它只做「别名 → 参数」的映射(用户名、主机名、端口、保活)。配置文件里不该出现密码:免密靠密钥认证,不靠记密码。

4. 远程连上以后,服务器上会多出什么?

对。Remote-SSH 会在服务器的 ~/.vscode-server/ 装一套服务端(含远端的扩展),这也是首次连接慢的原因。私钥不会被送到服务器。

5. 只改主文件 sshd_config,为什么没生效?

对。sshd 取「第一个出现的值」,而主文件开头就 Include 了 sshd_config.d/*.conf —— drop-in 里的 PasswordAuthentication yes 先被读到,主文件里的 no 就不起作用了。改完用 sshd -T 看生效值,别靠猜。