使用 Ed25519 密钥进行 SSH 连接
创建 Ed25519 SSH 密钥,将其安装到 Linux 服务器并完成测试,然后在不丢失访问权限的前提下禁用密码登录。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
SSH 密钥用一对文件取代密码:私钥保留在您的电脑上,公钥放到服务器上。禁用密码后,那些在 SSH 端口上不断尝试组合的机器人就无从猜起了。
本指南按严格的顺序操作,以免您失去访问权限:创建密钥、安装密钥、测试密钥,最后才禁用密码。
先决条件
- 一台可以通过 SSH 和密码访问的 Linux 服务器。如果尚未做到,请参阅通过 SSH 连接 Linux 服务器
- 账户密码,紧急控制台仍需使用
- 备用访问方式:VPS 可使用客户中心的 NoVNC 控制台。如果您的套餐不提供此功能,请在禁用密码之前向技术支持询问被锁定时如何访问服务器
- 电脑上的终端:Windows 使用 PowerShell,macOS 或 Linux 使用终端
在命令中,请将 您的用户名 替换为您的用户名,将 您的服务器IP 替换为服务器的 IP 地址。如果 SSH 端口不是 22,请在 ssh 和 ssh-copy-id 命令中添加 -p 和端口号。
第 1 步:在电脑上创建密钥
请在您的电脑上运行此命令,而不是在服务器上。Windows、macOS 和 Linux 上的命令相同:
ssh-keygen -t ed25519 -C "my-computer"-C 后面的文字只是注释,便于您识别密钥。
- 按 Enter 键接受建议的保存位置。
- 设置密码短语。它用于加密私钥:即使有人复制了该文件,没有密码短语也无法使用。
您账户的 .ssh 文件夹中会生成两个文件。macOS 和 Linux 上为 ~/.ssh,Windows 上为 C:\Users\用户名\.ssh:
| 文件 | 作用 | 可以分享吗? |
|---|---|---|
id_ed25519 |
私钥 | 绝对不可以,邮件和工单中都不行 |
id_ed25519.pub |
公钥 | 可以,它就是要放到服务器上的文件 |
第 2 步:将公钥安装到服务器
请使用您今后要用的账户连接:密钥只对该账户有效。
从 macOS 或 Linux
ssh-copy-id -i ~/.ssh/id_ed25519.pub 您的用户名@您的服务器IP输入密码。显示 Number of key(s) added: 1 即表示添加成功。
从 Windows
Windows 不附带 ssh-copy-id。请在 PowerShell 中运行:
Get-Content "$env:USERPROFILE\.ssh\id_ed25519.pub" | ssh 您的用户名@您的服务器IP "umask 077; mkdir -p ~/.ssh; tr -d '\r' >> ~/.ssh/authorized_keys; chmod 700 ~/.ssh; chmod 600 ~/.ssh/authorized_keys"该命令会把密钥追加到 authorized_keys 文件末尾,去除 Windows 换行符,并设置正确的权限。
检查安装结果
将您的密钥指纹与服务器上的指纹进行比对。在电脑上运行:
ssh-keygen -lf ~/.ssh/id_ed25519.pub在 Windows 上运行:
ssh-keygen -lf "$env:USERPROFILE\.ssh\id_ed25519.pub"然后在服务器会话中运行:
ssh-keygen -lf ~/.ssh/authorized_keys两边应显示相同的 SHA256:... 指纹。
第 3 步:测试密钥登录
在新窗口中,以禁止密码的方式连接:
ssh -o PreferredAuthentications=publickey -o PasswordAuthentication=no 您的用户名@您的服务器IP- 出现
Enter passphrase for key属于正常现象,请输入密钥的密码短语。 - 如果成功进入服务器,说明密钥可用。
- 如果出现
Permission denied (publickey),请到此为止,并查看故障排除。不要禁用密码。
避免重复输入密码短语
SSH 代理会在会话期间保持密钥处于解锁状态。
在 macOS 上,密码短语会保存到钥匙串:
ssh-add --apple-use-keychain ~/.ssh/id_ed25519在 Linux 上:
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519在 Windows 上,请在以管理员身份打开的 PowerShell 中运行:
Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent
ssh-add "$env:USERPROFILE\.ssh\id_ed25519"第 4 步:禁用密码登录
继续之前,请确认以下三点:
- 密钥登录已在新窗口中成功
- 您的第一个 SSH 会话仍处于打开状态
- 您拥有备用访问方式和账户密码
以下命令以 root 身份在服务器上运行。如果使用其他账户,请先切换到 root:
sudo -i检查配置目录
grep -i '^Include' /etc/ssh/sshd_config预期结果为 Include /etc/ssh/sshd_config.d/*.conf。如果没有任何输出,请转到没有配置目录时的做法。
创建配置文件
cat > /etc/ssh/sshd_config.d/00-key-only.conf <<'EOF'
PasswordAuthentication no
KbdInteractiveAuthentication no
EOF
chmod 644 /etc/ssh/sshd_config.d/00-key-only.conf应用前检查
先检查语法。该命令不应有任何输出:
sshd -t然后显示实际生效的配置:
sshd -T | grep -Ei '^(passwordauthentication|kbdinteractiveauthentication|pubkeyauthentication|permitrootlogin)'结果应为 passwordauthentication no、kbdinteractiveauthentication no 和 pubkeyauthentication yes。如果您以 root 登录,permitrootlogin 不能为 no。
应用更改
在 Debian 和 Ubuntu 上:
systemctl restart ssh在 AlmaLinux、Rocky Linux、CentOS 和 Fedora 上:
systemctl restart sshd已打开的会话通常不会中断。
没有配置目录时的做法
如果 sshd_config 中没有 Include 行,请打开该文件:
nano /etc/ssh/sshd_config将以下内容添加到文件最开头并保存。然后按上文所述运行 sshd -t、sshd -T 并重启服务。
PasswordAuthentication no
KbdInteractiveAuthentication no第 5 步:检查结果
请保持第一个会话打开,并在新窗口中进行以下两项测试。
密钥登录应当成功:
ssh 您的用户名@您的服务器IP密码登录应当失败:
ssh -o PubkeyAuthentication=no -o PreferredAuthentications=password 您的用户名@您的服务器IP预期结果为:
您的用户名@您的服务器IP: Permission denied (publickey).如果两项测试都符合预期,就可以关闭第一个会话了。如需进一步加固,请参阅保护您的服务器。
恢复原状
在仍然打开的会话或 NoVNC 控制台中,删除创建的文件并重启服务。请根据系统将 ssh 替换为 sshd。
rm /etc/ssh/sshd_config.d/00-key-only.conf
sshd -t
systemctl restart ssh打开控制台的方法:在客户中心打开服务页面,点击右上角的终端形状图标,选择 NoVNC Console graphique(NoVNC 图形控制台),点击 Ok 确认,然后点击 Connecter(连接)。使用账户密码登录。控制台的键盘布局可能与您的不同。
如果您是直接修改的 sshd_config,请删除添加的两行。
管理密钥
- 多台电脑:为每台设备创建一个密钥,并将各自的公钥添加到服务器。这样可以单独移除其中一个,而不影响其他密钥。
- 撤销访问:删除
~/.ssh/authorized_keys中对应的行,例如在电脑丢失之后。 - 备份:将私钥副本保存在安全的地方,例如密码管理器。忘记的密码短语无法找回,只能创建新密钥。
故障排除
Permission denied (publickey)
服务器拒绝了您的密钥。请依次检查:
- 用户名:密钥必须安装在该账户下。
- 电脑提供的密钥:
ssh -v 您的用户名@您的服务器IP查找 Offering public key 和 Server accepts key 这两行。
- 服务器上的权限(请在相应账户的会话中操作):
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
chown -R "$(id -un):$(id -gn)" ~/.ssh
chmod go-w ~- 在 AlmaLinux、Rocky Linux、CentOS 和 Fedora 上,检查 SELinux 上下文:
restorecon -Rv ~/.ssh- 服务器日志(根据系统将
ssh换成sshd):
journalctl -u ssh -n 50 --no-pager出现 Authentication refused: bad ownership or modes 表示存在权限问题。
服务器仍然要求输入密码
如果提示为 您的用户名@您的服务器IP's password:,说明密钥未被接受,且密码登录仍处于启用状态。请按上文检查密钥,然后重新运行第 4 步中的 sshd -T 命令。如果仍显示 passwordauthentication yes,请确认文件名以 .conf 结尾、服务已重启,并且没有其他文件的前缀排在 00- 之前。
请勿与 Enter passphrase for key 混淆,后者要求输入的是本地密钥的密码短语。
UNPROTECTED PRIVATE KEY FILE!
您的私钥可被其他账户读取,因此客户端拒绝使用。在 macOS 和 Linux 上:
chmod 600 ~/.ssh/id_ed25519在 Windows 上:
icacls "$env:USERPROFILE\.ssh\id_ed25519" /inheritance:r /grant:r "${env:USERNAME}:F"Too many authentication failures
代理提供了过多密钥。请指定要使用的密钥:
ssh -o IdentitiesOnly=yes -i ~/.ssh/id_ed25519 您的用户名@您的服务器IPCould not open a connection to your authentication agent
SSH 代理未启动。请重新执行避免重复输入密码短语一节中的命令。
sshd: command not found
/usr/sbin 目录不在您的路径中。请使用 sudo -i 切换到 root,或使用完整路径 /usr/sbin/sshd。