常用命令
// 用ssh-keygen命令生成一组新的id_rsa_new和id_rsa_new.pub
ssh-keygen -t rsa -C "[email protected]"
// 进入ssh 目录
cd ~/.ssh/
// 查看生成的公钥
cat id_rsa.pub
//通过指定-K把SSH key导入到密钥链中。
ssh-add -K ~/.ssh/id_rsa
// 查看添加结果
ssh-add -l
从github(或者其他git)上克隆项目
有两种方式分别是Https 和 SSH
Https方式:
- 实现方式:git clone + 目标地址即可
git clonehttps://github.com/AFNetworking/AFNetworking.git
SSH方式:
- 需要在克隆之前先配置和添加好 SSH key
- 然后你还必须是这个项目的拥有者,或者有添加 SSH key 的权限。
- 实现方式:同上
git clone [email protected]:AFNetworking/AFNetworking.git
Https 和 SSH 的区别:
前者可以随意克隆github上的项目,而不管是谁的;而后者则是你必须是你要克隆的项目的拥有者或管理员,且需要先添加 SSH key ,否则无法克隆。
https url 在push的时候是需要验证用户名和密码的;而 SSH 在push的时候,是不需要输入用户名的,如果配置SSH key的时候设置了密码,则需要输入密码的,否则直接是不需要输入密码的。
SSH使用大发:
github上单个仓库设置SSH Key
-
github用户设置中的SSH Key (就是你的整个github上的所有仓库都可以克隆了,只要你把本机生成的SSH Key 添加到个人账户上)
- 设置一个SSH Key
- 设置多个SSH Key
设置多个SSH Key的目的,为什么这么做,应对那些情况的
先来说一下SSH Key是咋回事。公钥认证,是使用一对加密字符串,一个称为公钥(public key),任何人都可以看到其内容,用于加密;另一个称为密钥(private key),只有拥有者才能看到,用于解密。通过公钥认证可实现SSH免密码登陆,git的SSH方式就是通过公钥进行认证的。
应对的情况
自己github上项目,即要在自己的Mac上能提交代码,也要在公司的Mac上能提交代码。
公司的Mac上,要能往公司自己的git服务器上对应项目提交代码,也要能往自己github上的项目提交代码。
别人github上项目,在自己的Mac上能往上面提交代码。
-
解决办法
需要在自己的Mac上生成一对SSH Key,配置到自己的github项目上,在公司的Mac上也要生成一对SSH Key配置到自己的github项目上。
公司的Mac上,生成一对SSH key配置在公司自己的git服务器对应的项目上,再生成一个对SSH key配置在自己的github项目上。
在自己的Mac上生成一对SSH Key,配置在对方的github项目上。
SSH Key 生成过程
- 生成1个SSH Key:
- ssh key命名的第一种方式:
$ ssh-keygen -t rsa -C "[email protected]” -f ~/.ssh/id_rsa_github
代码参数含义:
-t 指定密钥类型,默认是 rsa ,可以省略。
-C 设置注释文字,比如邮箱。
-f 指定密钥文件存储文件名。
- ssh key命名的第二种方式:
// "[email protected]" 是你自己的邮箱
ssh-keygen -t rsa -C "[email protected]"
以上代码省略了 -f 参数,因此,运行上面那条命令后会让你输入一个文件名,用于保存刚才生成的 SSH key 代码
- 按回车后:
Generating public/private rsa key pair.
Enter file in which to save the key (/Users/Shinancao/.ssh/id_rsa): id_rsa_TestSSH_github(取个名字)
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in
id_rsa_TestSSH_github.
Your public key has been saved in
id_rsa_TestSSH_github.pub.
最好每次生成时都给SSH Key取个名字,这样后面在管理时自己也一目了然。我这里的格式是id_rsa_项目名_git提供方
,我生成的所有key都遵循这个规则命名。建议你也有你自己的一种命名方式,并且保持统一。如果不取名字,默认的是id_rsa,如果后面生成时不命名,会把这个覆盖掉。密码可以不设置,免得每次提交时还要输入一次,安全性自己衡量吧。第一次生成key时,会在~目录下创建一个.ssh目录。
- 查看你的公钥然后, 把id_rsa_TestSSH_github.pub添加到github对应的项目的Deploy keys中。
cat id_id_rsa_TestSSH_github.pub
- ssh服务器默认是去找id_rsa,现在需要把这个key添加到ssh-agent中,这样ssh服务器才能认识id_rsa_TestSSH_github。
ssh-add -K ~/.ssh/id_rsa_TestSSH_github
这里为什么加上了一个-K参数呢?因为在Mac上,当系统重启后会“忘记”这个密钥,所以通过指定-K把SSH key导入到密钥链中。
查看添加结果:
ssh-add -l
- 创建本地的配置文件 ~/.ssh/config,编辑如下:
Host TestSSH.github.com
HostName github.com
User git
PreferredAuthentications publickey
IdentityFile ~/.ssh/id_rsa_TestSSH_github
Host YourProjectName.gitlab.com
HostName gitlab.com
User git
PreferredAuthentications publickey
IdentityFile ~/.ssh/id_rsa_YourProjectName_gitlab
Host的名字可以随意取,我这边按照的规则是项目名.git服务器来源,接下来会用到这个名字。测试是否配置正确:
ssh -T [email protected] (就是刚刚你给Host取的名字)
敲一下回车,如下出现下面的提示就连接成功了:
Hi shinancao/TestSSH! You've successfully authenticated, but GitHub does not provide shell access.
总结一下即是:使用ssh-keygen -t rsa -C "[email protected]"命令,为其取一个名字将生成的keyValue存起来(也可以不取,默认是id_rsa和id_rsa.pub;让输入的密码也是可取可不取);然后将id_rsa.pub中的内容复制到各个平台(同github设置方法一直,其他如Gitcafe/Git@OSC等等也是如此)addSSHKey处即可。文章还有未详之处。详情可看[意林的小站]
参考文章
着重参考意林的小站
如何设置添加SSH
MAC下配置多个SSH-KEY
友情链接
Git教程
Git