配置 SSH 公钥

文章内容

功能介绍
生成公钥
添加公钥

功能介绍

SSH 的全称为 Secure Shell 即安全外壳协议，是一种加密的网络传输协议。它能够在公开的网络环境中提供安全的数据传输环境，通常用于登录远程主机与推拉代码。

同样一个 SSH 公钥文件，如果添加至某一个代码仓库，则称为部署公钥，配置后默认拥有该项目的只读权限，支持新增读写权限；如果添加至团队设置中心，则称为团队部署公钥，仅拥有只读权限；如果添加至个人账户，称为账户 SSH 公钥，配置后拥有账户内所有代码仓库的读写权限。同一个 SSH 公钥无法既作为部署公钥，又作为个人账户 SSH 公钥。

若 SSH 公钥未用作账户 SSH 公钥，但添加为部署公钥时依然提示错误，那么有可能是此公钥已被其他人用作账户 SSH 公钥。若您的名下有多个团队，也可能是在其他团队中的个人账户设置中添加了此 SSH 公钥。

生成公钥

本文使用 ssh-keygen 工具生成 SSH 公钥，执行命令：

ssh-keygen -m PEM -t ed25519 -C "your.email@example.com"  // 创建新的 SSH 私钥与公钥密钥对，输入你的邮箱作为标签
Enter file in which to save the key (/Users/you/.ssh/id_rsa): [Press enter]  // 推荐使用默认地址
Enter passphrase (empty for no passphrase):  // 此处直接回车即可；若设置密码，则每次使用 SSH 方式推送代码时都会要求输入密码
Enter same passphrase again:  // 同前，此处直接回车即可

若你需要使用多个 SSH 密钥对，在 Enter file in which to save the key 步骤时，输入一个新的文件名称就可以避免覆盖已有的密钥对。有关 SSH 更多信息可参考维基百科。
若您的系统不支持 Ed25519 算法，请使用命令 ssh-keygen -m PEM -t rsa -b 4096 -C "your.email@example.com"。

成功之后显示如下信息：

Your identification has been saved in /Users/you/.ssh/id_ed25519.
# Your public key has been saved in /Users/you/.ssh/id_ed25519.pub.
# The key fingerprint is:
# 01:0f:f4:3b:ca:85:d6:17:a1:7d:f0:68:9d:f0:a2:db your.email@example.com