每次连接服务器都要输入密码,很快就会让人厌烦,而且密码可能被猜中。SSH 密钥可以同时解决这两个问题。读完本教程,你将拥有一把受口令保护的 ed25519 密钥、一台接受该密钥的服务器、一个简短的别名(只需输入 ssh myserver),并且同样的设置也能用于你的 git 托管平台。
准备工作
- 一台运行 macOS、Linux 或 Windows 10/11 的电脑,自带 OpenSSH 客户端。
- 一台你已经能用用户名和密码访问的服务器或另一台电脑。
- 一个终端(macOS 上的 Terminal、Linux 上的任意 shell、Windows 上的 PowerShell)。
- 大约 15 分钟。
示例中用户名为 alice,服务器为 server.example.com,地址为 203.0.113.10。请换成你自己的信息。
第 1 步:生成 ed25519 密钥
在你发起连接的电脑上运行以下命令。-C 参数用于添加注释,通常是你的邮箱,方便以后区分不同的密钥。
ssh-keygen -t ed25519 -C "alice@example.com"
较新的 OpenSSH 版本默认就使用 ed25519,但写明类型能让命令在任何地方都适用。按 Enter 接受默认位置。你会看到类似下面的输出:
Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/alice/.ssh/id_ed25519):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/alice/.ssh/id_ed25519
Your public key has been saved in /home/alice/.ssh/id_ed25519.pub
现在你有两个文件。id_ed25519 是私钥,要像密码一样保管,绝不要分享给别人。id_ed25519.pub 是公钥,可以放心复制到任何地方。
第 2 步:设置口令并将密钥加载到 ssh-agent
提示输入口令(passphrase)时,请设置一个。即使有人复制了你的私钥,口令依然能挡住他。如果当时跳过了,之后可以用 ssh-keygen -p -f ~/.ssh/id_ed25519 添加。
ssh-agent 会记住已解锁的密钥,这样每次会话只需输入一次口令。
macOS
启动 agent 并把密钥添加到 macOS 钥匙串:
eval "$(ssh-agent -s)"
ssh-add --apple-use-keychain ~/.ssh/id_ed25519
然后把以下几行加入 ~/.ssh/config(文件不存在就新建),让密钥自动加载:
Host *
AddKeysToAgent yes
UseKeychain yes
IdentityFile ~/.ssh/id_ed25519
UseKeychain 是 Apple 新增的选项,因此只在 macOS 上有效。
Linux
很多桌面会话已经运行了 agent。如果你的没有,就启动一个并添加密钥:
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
Windows
ssh-agent 服务默认是禁用的。以管理员身份打开 PowerShell 并运行:
Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent
然后在普通的 PowerShell 窗口中运行:
ssh-add $env:USERPROFILE\.ssh\id_ed25519
第 3 步:把公钥复制到服务器
服务器把受信任的公钥列表保存在 ~/.ssh/authorized_keys 中。添加公钥最简单的方法是使用 ssh-copy-id,macOS 和大多数 Linux 系统都自带:
ssh-copy-id -i ~/.ssh/id_ed25519.pub alice@server.example.com
它会最后一次询问服务器密码,必要时创建该文件,并跳过已经安装的密钥。
如果没有 ssh-copy-id(例如在 Windows PowerShell 中),可以先用 scp 把密钥文件复制过去,再在服务器上把它加入列表:
scp $env:USERPROFILE\.ssh\id_ed25519.pub alice@server.example.com:key.pub
ssh alice@server.example.com "mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat ~/key.pub >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys && rm ~/key.pub"
这些命令适用于 Linux 或 macOS 服务器,每条命令都会询问服务器密码。Windows 服务器把密钥存放在别的位置,管理员账户使用 C:\ProgramData\ssh\administrators_authorized_keys。这种情况请参照下方链接的 Microsoft 指南。
第 4 步:登录并核对主机指纹
现在开始连接:
ssh alice@server.example.com
第一次连接新服务器时,SSH 会显示它的指纹并要求你确认:
The authenticity of host 'server.example.com (203.0.113.10)' can't be established.
ED25519 key fingerprint is SHA256:4fXk2...Q9wE.
Are you sure you want to continue connecting (yes/no/[fingerprint])?
不要条件反射地输入 yes。如果可以,请在服务器本机上通过控制台或已有会话核对指纹:
ssh-keygen -l -f /etc/ssh/ssh_host_ed25519_key.pub
如果两者一致,输入 yes。SSH 会把该密钥保存到 ~/.ssh/known_hosts,以后一旦发生变化就会警告你。现在你应该能直接进入 shell,不再被要求输入服务器密码。如果 agent 还没有持有密钥,可能会要求你输入一次密钥口令。
第 5 步:在 ~/.ssh/config 中创建 Host 别名
在你自己的电脑上,向 ~/.ssh/config 添加一条配置:
Host myserver
HostName server.example.com
User alice
Port 22
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes
现在只需要这样:
ssh myserver
IdentitiesOnly yes 让 SSH 只提供你指定的那把密钥。
第 6 步:在家里的两台设备之间使用 SSH
同样的步骤也适用于家庭网络中的两台电脑。被连接的那台机器只需运行 SSH 服务器即可。
在 Mac 上,打开“系统设置”,进入“通用”,再进入“共享”,然后开启 Remote Login(远程登录)。点击旁边的信息按钮,可以看到连接这台 Mac 的确切 ssh 命令。
在 Ubuntu 上,安装服务器软件包:
sudo apt install openssh-server
在目标机器的网络设置中找到它的局域网地址。然后在另一台电脑上复制密钥,并像之前一样用这个地址连接。本例中的地址只是占位符:
ssh-copy-id alice@192.168.1.50
ssh alice@192.168.1.50
第 7 步(可选):关闭密码登录
密钥登录正常后,你可以让服务器彻底不再接受密码。这样一来,猜密码的机器人就无从下手了。
操作期间请保持当前 SSH 会话不要关闭。万一出错,这个打开的会话就是你修复问题的途径。关闭任何东西之前,先在第二个终端里测试。
在 Ubuntu 上,/etc/ssh/sshd_config.d/ 中的设置会覆盖主配置文件,而且最先读到的值生效。文件按名称顺序加载,所以以 00- 开头的文件会最先被读取:
sudo nano /etc/ssh/sshd_config.d/00-no-passwords.conf
添加以下两行:
PasswordAuthentication no
KbdInteractiveAuthentication no
检查配置是否有错误,然后重启服务:
sudo sshd -t
sudo systemctl restart ssh.service
在一个新的终端中运行 ssh myserver,确认你仍然可以登录。然后试试 ssh -o PubkeyAuthentication=no myserver,它应该被拒绝。及时更新服务器软件同样重要。
第 8 步:连接 git 托管平台
GitHub 等 git 托管平台接受同一把密钥。输出你的公钥并复制:
cat ~/.ssh/id_ed25519.pub
按照你所用 git 托管平台的指南(下方附有 GitHub 的指南),把它粘贴到账户设置的 SSH 密钥部分。然后测试:
ssh -T git@github.com
测试成功时会显示如下内容:
Hi alice! You've successfully authenticated, but GitHub does not provide shell access.
你的 git 账户是网络身份的重要组成部分,所以也值得检查一下你的其他账户。
常见错误及解决方法
Permission denied (publickey)(权限被拒绝)
服务器没有接受你提供的任何密钥。请检查公钥是否在服务器的 ~/.ssh/authorized_keys 中、用户名是否正确,以及 agent 是否持有你的密钥。运行 ssh -v myserver 可以查看尝试了哪些密钥。
~/.ssh 权限错误
默认情况下,如果你的文件权限过于宽松,SSH 服务器会忽略你的密钥。在服务器上用以下命令修复:
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
WARNING: UNPROTECTED PRIVATE KEY FILE!(警告:私钥文件未受保护)
你的私钥可被其他用户读取,所以 SSH 拒绝使用它。在你自己的电脑上运行:
chmod 600 ~/.ssh/id_ed25519
WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!(警告:远程主机标识已更改)
服务器的密钥与 known_hosts 中保存的不再一致。服务器重装后会出现这种情况,但也可能是遭受攻击的信号。确认这个变化在预期之内后,删除旧条目并重新连接:
ssh-keygen -R server.example.com
The agent has no identities(agent 中没有密钥)
当 agent 正在运行但没有持有任何密钥时,ssh-add -l 会显示这条信息。用 ssh-add ~/.ssh/id_ed25519 重新添加你的密钥。如果看到 “Could not open a connection to your authentication agent”,请先按第 2 步启动 agent。
总结
现在你用密钥代替密码登录,密钥受口令保护,别名让命令更简短。每台电脑使用一把单独的密钥,不要把私钥到处复制。如果设备丢失,从 authorized_keys 和 git 托管平台中删除它对应的公钥行即可。
等你习惯了密钥登录,同样的终端操作习惯也能用在更新的开发环境中。我们的 Chrome DevTools MCP 指南介绍了如何为编程 agent 提供一个真实的浏览器。
资料来源与官方文档
链接最后检查于 2026 年 11 月 15 日。
- OpenSSH ssh-keygen manual
- OpenSSH ssh manual
- OpenSSH ssh_config manual
- OpenSSH sshd_config manual
- ssh-copy-id manual page
- GitHub Docs: Generating a new SSH key and adding it to the ssh-agent
- GitHub Docs: Testing your SSH connection
- Microsoft Learn: Key-based authentication in OpenSSH for Windows
- Ubuntu Server docs: OpenSSH server
- Apple Support: Allow a remote computer to access your Mac





写评论