SSH 在本机与服务器之间建立加密通道,支持远程登录、执行命令、传输文件和端口转发。连接参数与认证配置确定后,命令行、MobaXterm 和 VS Code 可以围绕同一台服务器协同工作。

本文以 Windows 本机 + Linux 服务器 为例。标为“本机 CMD”的命令在 Windows 命令提示符执行;标为“服务器终端”的命令在登录后的 Linux Shell 执行。完整开发流程见 AI Coding指南。

1 连接前需要哪些信息

  • 服务器地址:例如 server.example.edu,也可以是管理员提供的 IP。
  • SSH 端口:默认通常为 22,以实际配置为准。
  • 用户名:本文示例为 alice。
  • 认证方式:账号密码,或已登记到该账号的公钥。
  • 网络入口:服务器是否要求 VPN、指定网络或跳板机。

密码与密钥认证都发生在 SSH 加密通道中。服务器是否接受密码、公钥或额外验证码,由其认证策略决定,客户端无法自行解除限制。

1.1 检查本机客户端

在本机 CMD 执行:

1
ssh -V

能够显示 OpenSSH 版本即可继续。若命令不存在,在 Windows“可选功能”中检查 OpenSSH 客户端;连接 Linux 不需要在 PC 上安装 OpenSSH 服务器。系统组件安装可能受本机管理策略限制,入口见 Microsoft OpenSSH 安装说明。

2 使用密码建立第一次连接

在本机 CMD 执行:

1
ssh -p 22 alice@server.example.edu

首次连接会显示服务器的主机密钥指纹。这用于确认连接对象的身份,与个人登录密钥不同。通过管理员提供的可信渠道核对指纹一致后,再输入 yes,客户端将其记入本机 known_hosts。

随后输入服务器账号密码。密码输入通常不回显字符或星号。登录成功后,命令执行位置已切换到服务器,可检查:

1
2
3
4
hostname
whoami
pwd
echo "$HOME"

输入 exit 结束远程 Shell,回到本机。若账号只允许密钥认证,应先请管理员登记公钥;反复输入密码无法替代这一步。

3 配置 Ed25519 密钥认证

3.1 在 PC 生成密钥

密钥对包含私钥与公钥:私钥留在 PC,服务器保存公钥并验证客户端签名。私钥不需要上传到服务器。 私钥口令(passphrase)保护磁盘上的私钥文件,与服务器账号密码互不替代。

在本机 CMD 执行:

1
ssh-keygen -t ed25519 -C "alice-laptop"

按提示选择保存位置并设置口令。采用默认文件名时,将得到:

1
2
C:\Users\你的用户名\.ssh\id_ed25519       私钥
C:\Users\你的用户名\.ssh\id_ed25519.pub 公钥

如果提示文件已存在,不要覆盖仍在使用的密钥。可保留已有密钥,或指定其他文件名,例如 id_ed25519_lab,并在后面的连接配置中使用对应路径。Microsoft 密钥认证说明

3.2 将公钥追加到服务器

先在本机 CMD 显示公钥:

1
type "%USERPROFILE%\.ssh\id_ed25519.pub"

完整公钥通常是一行,以 ssh-ed25519 开头。通过密码登录服务器,在服务器终端准备授权文件:

1
2
3
4
5
6
mkdir -p ~/.ssh
chmod 700 ~/.ssh
touch ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys
printf '\n' >> ~/.ssh/authorized_keys
cat >> ~/.ssh/authorized_keys

粘贴完整公钥,按回车,再按 Ctrl+D 结束输入。>> 保留已有授权项;先补一个换行,避免原文件末尾没有换行时把两把公钥拼在一起。每把公钥占一行,不粘贴私钥或额外引号。

.ssh 的 700 与 authorized_keys 的 600 分别限制目录与文件的访问。授权文件及其目录应归当前账号所有,家目录也不应允许其他用户写入,否则 OpenSSH 的权限检查可能拒绝使用它们。OpenSSH 授权文件与权限说明

3.3 单独验证公钥认证

保留原来的登录窗口,另开本机 CMD 执行:

1
ssh -o PreferredAuthentications=publickey -o IdentitiesOnly=yes -i "%USERPROFILE%\.ssh\id_ed25519" -p 22 alice@server.example.edu

该命令只尝试公钥认证,避免密码回退掩盖配置问题。出现 Enter passphrase for key 时输入私钥口令。能够进入远程 Shell 后,说明这把公钥对目标账号有效;之后可保留服务器已有的其他登录方式。

如果失败,检查是否登录了正确用户、授权文件是否位于该用户家目录,以及公钥是否完整。仅在 PC 生成密钥不会自动授权服务器账号。

4 用 config 保存别名

Windows OpenSSH 的用户配置文件是 %USERPROFILE%\.ssh\config,没有 .txt 后缀。在该文件中添加:

1
2
3
4
5
6
7
8
Host lab
HostName server.example.edu
User alice
Port 22
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes
ServerAliveInterval 30
ServerAliveCountMax 3

Host lab 是本机使用的别名,HostName 才是实际地址。IdentityFile 由本机 OpenSSH 读取,其中 ~ 指 Windows 用户目录。密码模式可省略 IdentityFile 与 IdentitiesOnly。

此后在本机 CMD 执行:

1
ssh lab

每台服务器可有自己的 Host 段。若还有 Host * 通用配置,通常放在具体主机配置之后,因为多数选项采用首先获得的值。

ServerAliveInterval 在连接空闲时发送探测,有助于发现失效连接,也可能减少中间网络设备回收空闲连接的情况。它不能保证断网后任务继续运行;长任务应使用 tmux 或服务器作业系统。配置语义见 OpenSSH 客户端配置手册。

5 使用 MobaXterm 与可选的 ssh-agent

5.1 MobaXterm 会话

  1. 打开 Session → SSH,填写服务器地址、用户名与端口。
  2. 密码模式直接连接,按提示输入账号密码。
  3. 密钥模式在 Advanced SSH settings → Use private key 中选择 PC 上的私钥文件,不选择 .pub。
  4. 有私钥口令时,按提示解锁;服务器仍需事先登记对应公钥。
  5. 保存会话,后续从会话列表连接。

左侧 SFTP 面板显示服务器目录,可直接上传和下载文件。MobaXterm 的会话配置与 Windows OpenSSH 的 config 并不等同,修改一处后,应确认另一客户端仍使用正确参数。MobaXterm 官方文档

5.2 用已有 agent 减少口令输入

ssh-agent 可以让客户端使用已解锁的密钥,而不必每次重新输入私钥口令。它是可选功能;直接使用带口令的私钥也能完成连接。

在本机 CMD 检查:

1
ssh-add -l

如果提示没有身份,说明 agent 可连接但尚未添加密钥;如果提示无法连接 agent,则先继续使用交互式口令。Windows 的 agent 服务若未启用,启用或调整服务可能需要管理员权限,不是使用 SSH 的必经步骤。

已有可用 agent 时,在本机 CMD 添加这把密钥并查看结果:

1
2
ssh-add "%USERPROFILE%\.ssh\id_ed25519"
ssh-add -l

不再需要缓存时,可执行 ssh-add -d "%USERPROFILE%\.ssh\id_ed25519" 移除这一身份。添加后使用当前 Windows 账号连接即可,无需把整个 SSH 会话改为管理员运行。不同客户端不一定共享同一 agent;也无需为了减少口令输入而开启 ForwardAgent。

6 通过跳板机访问计算服务器

当 PC 只能访问入口机,而计算服务器仅对入口机开放时,可使用 ProxyJump。它通过跳板机转发目标 SSH 连接,目标服务器仍独立完成认证。

在本机 config 中加入两个独立主机段:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
Host gateway
HostName gateway.example.edu
User alice
Port 22
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes

Host gpu
HostName gpu.internal.example.edu
User alice
Port 22
ProxyJump gateway
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes

随后在本机 CMD 执行 ssh gpu。示例使用同一把本地密钥时,入口机和目标机的对应账号都需要授权该公钥;也可为两台主机配置不同私钥或密码。无需把私钥复制到跳板机。

目标主机的 User、端口和密钥设置不会自动成为跳板机的设置,因此分别定义更清晰。转发还需符合跳板机策略。ProxyJump 官方说明

7 上传与下载文件

7.1 scp:一次完成一项传输

先在服务器终端创建接收目录:

1
mkdir -p ~/projects/demo

以下命令均在本机 CMD 执行。示例远端家目录为 /home/alice,应按服务器上的 echo "$HOME" 结果调整。

1
2
3
scp -P 22 "D:\work\demo\train.py" alice@server.example.edu:/home/alice/projects/demo/
scp lab:/home/alice/projects/demo/metrics.csv "%USERPROFILE%\Downloads\metrics.csv"
scp -r "D:\work\demo" lab:/home/alice/projects/

三条命令依次是上传单文件、下载单文件、递归上传目录。源路径在前,目标路径在后;目录目标需已存在且当前用户可写,同名文件可能被覆盖。scp 是复制工具,不会自动同步删除另一端多余的文件。

ssh 指定端口用小写 -p,scp 使用大写 -P;采用 lab 别名后会读取其端口配置。Windows 目标路径可像示例一样写到文件名或目录名,避免在双引号前留下末尾反斜杠。当前 OpenSSH 的 scp 默认通过 SFTP 传输。scp 官方手册

7.2 SFTP:交互式查看与传输

在本机 CMD 进入 SFTP:

1
sftp lab

出现 sftp> 后,下面的命令由 SFTP 客户端解释,不是远端 Bash:

1
2
3
4
5
6
7
lpwd
pwd
lcd D:/work/demo
cd /home/alice/projects/demo
put train.py
get metrics.csv metrics-server.csv
bye

lpwd、lcd 操作本机目录,pwd、cd 操作服务器目录;put 上传,get 下载。大文件中断后可用 reget 或 reput 尝试续传,前提是已有部分文件与源文件内容一致,否则可能生成损坏文件。直接指定端口时使用 sftp -P 2222 alice@server.example.edu。SFTP 官方手册

8 按连接阶段排查问题

8.1 超时、拒绝连接与认证失败

Connection timed out 通常发生在建立连接阶段,先核对地址、端口、VPN 和跳板机要求;Connection refused 通常说明目标端口没有接受连接的服务,或连接被明确拒绝。此时修改私钥通常无效。

Permission denied 表示已经进入认证阶段。检查用户名、服务器允许的认证方式、实际加载的私钥,以及对应公钥与权限。使用 agent 时若出现 Too many authentication failures,可通过正确的 IdentityFile 和 IdentitiesOnly yes 限定尝试身份。

8.2 主机指纹发生变化

出现 REMOTE HOST IDENTIFICATION HAS CHANGED 时,先停止连接,核对地址是否正确,并向管理员确认是否重装系统、更换主机或更新主机密钥。确认新指纹可信后,再删除本机中该主机的旧记录。

在本机 CMD 中,默认端口可使用:

1
ssh-keygen -R server.example.edu

非默认端口的记录带有端口信息,例如:

1
ssh-keygen -R "[server.example.edu]:2222"

重新连接并再次核对新指纹。若日志显示匹配的是 IP 或配置了 HostKeyAlias,应处理实际命中的记录;无需删除整个 known_hosts,也不应通过关闭主机密钥检查跳过确认。ssh-keygen 记录管理

8.3 查看诊断日志

在本机 CMD 执行 ssh -v lab,可看到配置读取、连接建立和认证尝试。日志会显示主机地址、用户名、密钥路径与指纹,通常不打印私钥正文;共享日志时仍应移除内部地址和账号等信息,不要附上私钥文件。

命令行连接确认正常后,可继续配置 VS Code Remote-SSH 远程开发。服务器访问外部仓库与 API 的网络代理属于另一层配置,见 Linux服务器代理联网指南:Clash与Mihomo。