如何设置 SSH 密钥,免密码登录服务器

生成 ed25519 密钥,复制到服务器,然后免密码登录。macOS、Linux 和 Windows 分步教程,另附安全加固和 git 设置。

Flat illustration of a key and a terminal window linking two computers with a secure connection line

每次连接服务器都要输入密码,很快就会让人厌烦,而且密码可能被猜中。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。请换成你自己的信息。

视频:Hussein Nasser 的 “How SSH password-less key based authentication work in 4 minutes”(4 分钟看懂 SSH 免密码密钥认证)。

第 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 日。

作者:Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

关于 Mindloop Experience

评论

写评论

更多来自 Mindloop Experience

查看 Mindloop Experience 的全部文章

最多可以鼓掌 50 次。