向 UniFi 设备添加 SSH 密钥
UniFi 让管理员能够轻松地向 UniFi 设备添加 SSH 密钥。如果你只需要启用 SSH 或与 UniFi 设备建立 SSH 连接,请参阅我们的相关文章。
操作说明
开始之前:通过 UniFi Network 应用程序向 UniFi 设备添加 SSH 密钥,只应由熟悉 SSH 的 高级系统管理员 进行。
各操作系统的具体步骤如下:
Windows
Linux
macOS
在 Windows 10 上,也可以使用 WSL 生成 SSH 密钥。在这种情况下,命令与 macOS/Linux 完全相同。
- 下载并安装完整的 PuTTY 安装包或独立的 PuTTYgen 可执行文件。
- 打开 Putty 密钥生成器(PuTTYgen)以生成新的 SSH 密钥。
- 选择 RSA,密钥长度为 2048,然后点击 Generate。
-
密钥生成后,将公钥和私钥妥善保存到安全位置。
- 注意:切勿分享私钥文件或其内容。
- 复制 “Public key for pasting into OpenSSH authorized_keys file” 框中的全部 SSH 密钥内容。该 SSH 密钥以 ssh-rsa 开头,以 == rsa-key-<日期> 结尾,例如:
ssh-rsa AbCdEfGh1234AbCdEfGh== rsa-key-20200911
- 在 UniFi Network 中,依次进入 Settings > Devices > Device Updates and Settings > Device SSH Settings 添加密钥。
- 打开 Linux 终端。
-
使用 ssh-keygen 命令生成新的 SSH 密钥:
ssh-keygen -t rsa
-
可以使用默认文件名,也可以自定义文件名,并可选择添加密码保护。
- 注意:切勿分享私钥文件或其内容。
-
查看公钥文件内容。如果文件名未修改:
cat .ssh/id_rsa.pub
-
从终端窗口复制整段 SSH 公钥内容到你的剪贴板。该 SSH 密钥以 ssh-rsa 开头,以 username@machine 结尾,例如:
ssh-rsa AbCdEfGh1234AbCdEfGh admin@computer
- 在 UniFi Network 中,依次进入 Settings > System > Advanced > Device Authentication > SSH Keys 添加密钥。
- 打开 macOS 终端,可在 Finder > Applications > Utilities 内找到。
-
使用
ssh-keygen命令生成新的 SSH 密钥:
ssh-keygen -t rsa
-
可以使用默认文件名,也可以自定义文件名,并可选择添加密码保护。
- 注意:切勿分享私钥文件或其内容。
-
查看公钥文件内容。如果文件名未修改:
cat .ssh/id_rsa.pub
-
从终端窗口复制整段 SSH 公钥内容到你的剪贴板。该 SSH 密钥以
ssh-rsa开头,以 username@machine 结尾,例如:
ssh-rsa AbCdEfGh1234AbCdEfGh admin@computer
- 在 UniFi Network 中,依次进入 Settings > System > Advanced > Device Authentication > SSH Keys 添加密钥。