ServerBox 中文文档 下载 App

如何在 ServerBox 里配置 SSH 私钥认证

为什么用 SSH 密钥

SSH 密钥认证比密码安全得多——服务器上禁用密码登录、只允许密钥登录是业界标准做法。ServerBox 完整支持 SSH 密钥认证,包括:

导入已存在的密钥

如果你已经在服务器上配置好了密钥登录(比如之前用电脑 SSH 连得上),可以直接导入现有的私钥:

移动端导入

  1. 确认私钥文件已传输到手机(AirDrop、微信传文件、云盘下载都可以)
  2. 在 ServerBox 添加或编辑服务器时,认证方式选「SSH 私钥」
  3. iOS:点「选择密钥」→ 从「文件」App 里找到你的私钥
  4. Android:点「选择文件」→ 从系统文件管理器里选私钥

桌面端导入

桌面端更方便——如果你的私钥已经在 ~/.ssh/ 目录下:

  1. ServerBox 会自动扫描并列出所有可识别的私钥
  2. 直接在下拉菜单里选一个就行,不用手动找文件
  3. 也可以手动选择其他位置的密钥文件

让 ServerBox 生成新密钥

如果还没有密钥对,可以让 ServerBox 帮你生成:

  1. 添加服务器 → 认证方式选「SSH 私钥」
  2. 点「生成新密钥」
  3. 选择密钥类型(推荐 ED25519,比 RSA 更短更快更安全)
  4. 设置 passphrase(可选但强烈建议,相当于给私钥加一层密码保护)
  5. ServerBox 会生成密钥对,并显示公钥(ssh-rsa AAAA... 或 ssh-ed25519 AAAA...)
  6. 复制公钥,登录服务器后执行:
echo "ssh-ed25519 AAAA...你的公钥..." >> ~/.ssh/authorized_keys

完成后回到 ServerBox 测试连接即可。

常见问题

Q:私钥文件选择后报错「无效的私钥格式」? A:确认你的私钥是 OpenSSH 格式(以 -----BEGIN OPENSSH PRIVATE KEY----- 或 -----BEGIN RSA PRIVATE KEY----- 开头)。PuTTY 格式的密钥(以 -----BEGIN PuTTY-User-Key-File----- 开头)需要先转换:puttygen key.ppk -O private-openssh -o key.pem

Q:私钥加了 passphrase,每次都要输入? A:在服务器编辑页面勾选「记住 passphrase」,ServerBox 会把它加密存储在本地。iOS 的 Keychain 和 Android 的 Keystore 是系统级安全存储。

Q:同一把密钥能连多台服务器吗? A:可以,在每台服务器的配置里都选这把密钥就行。