如何生成SSH key
SSH key提供了一种与GitHub通信的方式,通过这种方式,能够在不输入密码的情况下,将GitHub作为自己的remote端服务器,进行版本控制
1. 检查SSH keys是否存在
2. 生成新的ssh key
3. 将ssh key添加到GitHub中
如何生成SSH KEY
1. 检查SSH keys是否存在
输入下面的命令,如果有文件id_rsa.pub 或 id_dsa.pub,则直接进入步骤3将SSH key添加到GitHub中,否则进入第二步生成SSH key
ls -al ~/.ssh
# Lists the files in your .ssh directory, if they exist
2. 生成新的ssh key
第一步:生成public/private rsa key pair
在命令行中输入ssh-keygen -t rsa -C "your_email@example.com"
默认会在相应路径下(/your_home_path)生成id_rsa和id_rsa.pub两个文件,如下面代码所示
ssh-keygen -t rsa -C "your_email@example.com"
# Creates a new ssh key using the provided email
Generating public/private rsa key pair.
Enter file in which to save the key (/your_home_path/.ssh/id_rsa):
第二步:输入passphrase(本步骤可以跳过)
设置passphrase后,进行版本控制时,每次与GitHub通信都会要求输入passphrase,以避免某些“失误”
Enter passphrase (empty for no passphrase): [Type a passphrase]
Enter same passphrase again: [Type passphrase again]
sample result:
Your identification has been saved in /your_home_path/.ssh/id_rsa.
Your public key has been saved in /your_home_path/.ssh/id_rsa.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
第三步:将新生成的key添加到ssh-agent中:
# start the ssh-agent in the background
eval "$(ssh-agent -s)"
Agent pid 59566
ssh-add ~/.ssh/id_rsa
3. 将ssh key添加到GitHub中
用自己喜欢的文本编辑器打开id_rsa.pub文件,里面的信息即为SSH key,将这些信息复制到GitHub的Add SSH key页面即可
不同的操作系统,均有一些命令,直接将SSH key从文件拷贝到粘贴板中,如下:(注意在粘贴的时候,需要在github对应项目下的setting中选择deploy key然后粘贴完成后勾选提供写权限的操作即可,否则后面使用key提交工程的时候会报权限错误,这点一定要记住)
mac
pbcopy < ~/.ssh/id_rsa.pub
# Copies the contents of the id_rsa.pub file to your clipboard
windows
clip < ~/.ssh/id_rsa.pub
# Copies the contents of the id_rsa.pub file to your clipboard
linux
sudo apt-get install xclip
# Downloads and installs xclip. If you don't have `apt-get`, you might need to use another installer (like `yum`)
xclip -sel clip < ~/.ssh/id_rsa.pub
# Copies the contents of the id_rsa.pub file to your clipboard
本地git版本仓库的创建
cd 本地代码仓库路径
git init
git add *
git commit -m "first commit"
远程仓库的链接和代码提交
git remote add origin git@github.com:username/xxx.git (注意这里是ssh类型的git仓库地址,不是选择的https类型的)
git push -u origin master
ssh key出现错误的解决办法
常见的问题例如:
The key you are authenticating with has been marked as read only
解决办法:通常因为最初创建ssh key的时候没有勾选写权限的操作而导致的
key is already in use
解决办法: 多个仓库同时使用了ssh key,可以通过删除ssh key重新创建的方式来修改
ssh-add -D
rm -r ~/.ssh
删除你在github中的public-key
重新生成ssh密钥对
ssh-keygen -t rsa -C "xxx@xxx.com"
chmod 0700 ~/.ssh
chmod 0600 ~/.ssh/id_rsa*
接下来正常操作
在github上添加公钥public-key:
1、首先在你的终端运行 xclip -sel c ~/.ssh/id_rsa.pub将公钥内容复制到剪切板
2、在github上添加公钥时,直接复制即可
3、保存
测试:
在终端 ssh -T git@github.com
在github上除了可以使用ssh key的形式外还可以使用https的形式。因为如果使用ssh需要单独为每一个代码仓库配置重新生成ssh key,比较繁琐,因此可以使用https的形式来直接进行网页的操作就可以了。
使用https地址来提交代码仓库
具体的步骤和上面的很相近,但是具体的区别在于创建远程仓库的实现上。(替换掉username 和 仓库名称就可以了)
git remote add origin https://github.com/username/xxx.git