Linux服务器SSH连接指南:密码、密钥与文件传输
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 | hostname |
输入 exit 结束远程 Shell,回到本机。若账号只允许密钥认证,应先请管理员登记公钥;反复输入密码无法替代这一步。
3 配置 Ed25519 密钥认证
3.1 在 PC 生成密钥
密钥对包含私钥与公钥:私钥留在 PC,服务器保存公钥并验证客户端签名。私钥不需要上传到服务器。 私钥口令(passphrase)保护磁盘上的私钥文件,与服务器账号密码互不替代。
在本机 CMD 执行:
1 | ssh-keygen -t ed25519 -C "alice-laptop" |
按提示选择保存位置并设置口令。采用默认文件名时,将得到:
1 | C:\Users\你的用户名\.ssh\id_ed25519 私钥 |
如果提示文件已存在,不要覆盖仍在使用的密钥。可保留已有密钥,或指定其他文件名,例如 id_ed25519_lab,并在后面的连接配置中使用对应路径。Microsoft 密钥认证说明
3.2 将公钥追加到服务器
先在本机 CMD 显示公钥:
1 | type "%USERPROFILE%\.ssh\id_ed25519.pub" |
完整公钥通常是一行,以 ssh-ed25519 开头。通过密码登录服务器,在服务器终端准备授权文件:
1 | mkdir -p ~/.ssh |
粘贴完整公钥,按回车,再按 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 | Host lab |
Host lab 是本机使用的别名,HostName 才是实际地址。IdentityFile 由本机 OpenSSH 读取,其中 ~ 指 Windows 用户目录。密码模式可省略 IdentityFile 与 IdentitiesOnly。
此后在本机 CMD 执行:
1 | ssh lab |
每台服务器可有自己的 Host 段。若还有 Host * 通用配置,通常放在具体主机配置之后,因为多数选项采用首先获得的值。
ServerAliveInterval 在连接空闲时发送探测,有助于发现失效连接,也可能减少中间网络设备回收空闲连接的情况。它不能保证断网后任务继续运行;长任务应使用 tmux 或服务器作业系统。配置语义见 OpenSSH 客户端配置手册。
5 使用 MobaXterm 与可选的 ssh-agent
5.1 MobaXterm 会话
- 打开 Session → SSH,填写服务器地址、用户名与端口。
- 密码模式直接连接,按提示输入账号密码。
- 密钥模式在 Advanced SSH settings → Use private key 中选择 PC 上的私钥文件,不选择
.pub。 - 有私钥口令时,按提示解锁;服务器仍需事先登记对应公钥。
- 保存会话,后续从会话列表连接。
左侧 SFTP 面板显示服务器目录,可直接上传和下载文件。MobaXterm 的会话配置与 Windows OpenSSH 的 config 并不等同,修改一处后,应确认另一客户端仍使用正确参数。MobaXterm 官方文档
5.2 用已有 agent 减少口令输入
ssh-agent 可以让客户端使用已解锁的密钥,而不必每次重新输入私钥口令。它是可选功能;直接使用带口令的私钥也能完成连接。
在本机 CMD 检查:
1 | ssh-add -l |
如果提示没有身份,说明 agent 可连接但尚未添加密钥;如果提示无法连接 agent,则先继续使用交互式口令。Windows 的 agent 服务若未启用,启用或调整服务可能需要管理员权限,不是使用 SSH 的必经步骤。
已有可用 agent 时,在本机 CMD 添加这把密钥并查看结果:
1 | ssh-add "%USERPROFILE%\.ssh\id_ed25519" |
不再需要缓存时,可执行 ssh-add -d "%USERPROFILE%\.ssh\id_ed25519" 移除这一身份。添加后使用当前 Windows 账号连接即可,无需把整个 SSH 会话改为管理员运行。不同客户端不一定共享同一 agent;也无需为了减少口令输入而开启 ForwardAgent。
6 通过跳板机访问计算服务器
当 PC 只能访问入口机,而计算服务器仅对入口机开放时,可使用 ProxyJump。它通过跳板机转发目标 SSH 连接,目标服务器仍独立完成认证。
在本机 config 中加入两个独立主机段:
1 | Host gateway |
随后在本机 CMD 执行 ssh gpu。示例使用同一把本地密钥时,入口机和目标机的对应账号都需要授权该公钥;也可为两台主机配置不同私钥或密码。无需把私钥复制到跳板机。
目标主机的 User、端口和密钥设置不会自动成为跳板机的设置,因此分别定义更清晰。转发还需符合跳板机策略。ProxyJump 官方说明
7 上传与下载文件
7.1 scp:一次完成一项传输
先在服务器终端创建接收目录:
1 | mkdir -p ~/projects/demo |
以下命令均在本机 CMD 执行。示例远端家目录为 /home/alice,应按服务器上的 echo "$HOME" 结果调整。
1 | scp -P 22 "D:\work\demo\train.py" alice@server.example.edu:/home/alice/projects/demo/ |
三条命令依次是上传单文件、下载单文件、递归上传目录。源路径在前,目标路径在后;目录目标需已存在且当前用户可写,同名文件可能被覆盖。scp 是复制工具,不会自动同步删除另一端多余的文件。
ssh 指定端口用小写 -p,scp 使用大写 -P;采用 lab 别名后会读取其端口配置。Windows 目标路径可像示例一样写到文件名或目录名,避免在双引号前留下末尾反斜杠。当前 OpenSSH 的 scp 默认通过 SFTP 传输。scp 官方手册
7.2 SFTP:交互式查看与传输
在本机 CMD 进入 SFTP:
1 | sftp lab |
出现 sftp> 后,下面的命令由 SFTP 客户端解释,不是远端 Bash:
1 | lpwd |
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。





