中文

Linux 与网络

使用 Ed25519 密钥进行 SSH 连接

创建 Ed25519 SSH 密钥,将其安装到 Linux 服务器并完成测试,然后在不丢失访问权限的前提下禁用密码登录。

阅读约 7 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

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 后面的文字只是注释,便于您识别密钥。

  1. 按 Enter 键接受建议的保存位置。
  2. 设置密码短语。它用于加密私钥:即使有人复制了该文件,没有密码短语也无法使用。

您账户的 .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 中运行:

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 上运行:

PowerShell
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 中运行:

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)

服务器拒绝了您的密钥。请依次检查:

  1. 用户名:密钥必须安装在该账户下。
  2. 电脑提供的密钥:
终端
ssh -v 您的用户名@您的服务器IP

查找 Offering public key 和 Server accepts key 这两行。

  1. 服务器上的权限(请在相应账户的会话中操作):
终端
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
chown -R "$(id -un):$(id -gn)" ~/.ssh
chmod go-w ~
  1. 在 AlmaLinux、Rocky Linux、CentOS 和 Fedora 上,检查 SELinux 上下文:
终端
restorecon -Rv ~/.ssh
  1. 服务器日志(根据系统将 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 上:

PowerShell
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 您的用户名@您的服务器IP

Could not open a connection to your authentication agent

SSH 代理未启动。请重新执行避免重复输入密码短语一节中的命令。

sshd: command not found

/usr/sbin 目录不在您的路径中。请使用 sudo -i 切换到 root,或使用完整路径 /usr/sbin/sshd。

无法再访问服务器

打开 NoVNC 控制台,并按照恢复原状操作。如果无法登录控制台,请从客户中心提交工单。切勿发送您的私钥或密码。