专栏首页xiaoxi666的专栏配置多个git账号的ssh密钥

配置多个git账号的ssh密钥

背景

我们在工作中会以 ssh 的方式配置公司的 git 账号,但是平时也会使用 github 管理自己的项目。出于各种原因,自己的 github 项目无法使用公司的 git 账号,于是我们可以为自己的 github 创建一个新的 git 账号,这就需要生成新的 ssh 密钥。 下面总结了创建多个互相独立的 ssh 密钥的步骤(以公司的和自己 github 的为例)。

步骤(以mac为例)

  1. 在文件夹 ~/.ssh/ 下创建两个文件夹,分别为 company/github/,前者存放公司的 ssh密钥,后者存自己github 的 ssh 密钥。下面的步骤以创建 github 密钥为例:
  2. 在终端执行命令:ssh-keygen -t rsa -C "your_github_email@example.com"
  3. 然后会提示 Enter file in which to save the key,输入文件路径 ~/.ssh/github/id_rsa_github,最后就会在该路径下生成 id_rsa_githubid_rsa_github.pub 两个文件(若直接回车的话,会保存在~/.ssh/文件夹中)。
  4. 然后出现 Enter passphrase (empty for no passphrase),直接回车即可。
  5. 最后会出现创建成功的提示: Your identification has been saved in .ssh_github/id_rsa_github. Your public key has been saved in .ssh_github/id_rsa_github.pub.
  6. 文件id_rsa_github.pub中保存的就是 ssh 公钥。可以利用命令 pbcopy 将其复制到剪贴板,比如我的命令就是 pbcopy < ~/.ssh/github/id_rsa_github.pub。当然你也可以找到该文件手动复制。
  7. 在 github 网站中添加该 ssh 公钥。
  8. 创建公司 ssh 密钥 的过程类似,不再赘述。
  9. 两个 ssh 密钥创建完毕后,在~/.ssh/文件夹中创建文件config,添加如下内容: # The git info for company Host git.XXX.com # git别名,写公司的git名字即可 HostName git.XXX.com # git名字,同样写公司的git名字 User git # 写 git 即可 IdentityFile ~/.ssh/company/id_rsa #私钥路径,若写错会连接失败 # The git info for github Host github.com # git别名,写github的git名字即可 HostName github.com # git名字,同样写github的git名字 User git # 写 git 即可 IdentityFile ~/.ssh/github/id_rsa_github #私钥路径,若写错会连接失败 注:配置文件中各参数含义请参见扩展部分
  10. 网上很多文章说要执行命令 ssh-add 将 IdentityFile 添加到 ssh-agent中,具体到本文中就是执行 ssh-add ~/.ssh/company/id_rsassh-add ~/.ssh/github/id_rsa_github其实这个操作只是把专用密钥添加到 ssh-agent 的高速缓存中,因此略过该步骤也不会有影响。
  11. 这一步用于验证是否配置成功,以 github 为例,输入 ssh -T git@github.com,若出现 Hi xiaoxi666! You've successfully authenticated, but GitHub does not provide shell access. 这样的字段,即说明配置成功。公司的同理。

总结

本文描述了单机配置两个 git 平台ssh密钥的方法,多个账号同理。推荐在 ~/.ssh/ 文件夹下为不同的平台建立不同的文件夹,方便管理。根据上述配置,我的 ~/.ssh/ 文件夹下是这样子的:

├── company
│   ├── id_rsa
│   └── id_rsa.pub
├── config
├── github
│   ├── id_rsa_github
│   └── id_rsa_github.pub

扩展

关于配置文件 config

  1. 配置文件的位置:上面我们在 ~/.ssh/ 文件夹下创建配置文件,其实也可以指定位置,具体可查阅 ssh帮助手册(man 1 ssh)。 -F configfile Specifies an alternative per-user configuration file. If a configuration file is given on the command line, the system-wide configuration file (/etc/ssh/ssh_config) will be ignored. The default for the per-user configuration file is ~/.ssh/config.
  2. Host 别名:可以随意指定,比如你把 github 的 Host 别名设置为 banana,那你在测试的时候也可以输入ssh -T banana,以后 clone 项目时也可以用 banana 代替 github.com 。
  3. User: 注意它和 git 中的 user.name 不是一个概念。
    • 配置文件中的 User 是登录提供 git 服务的平台(如这里的 github)的服务器主机时指定的用户名,比如 github 中 clone 项目时选择 ssh,链接均以 git@github.com开头,@ 前面的 git 就是 github 对应服务器主机中的一个用户名,即上面设置的 User,@ 后面的 github.com 就是 HostName);
    • git 中的 user.name 是用来追踪代码的,提交代码时显示的作者名字就是它,比如在 github 中,我的 user.name 就是 xiaoxi666。这里引出了另外一个问题:我在本机中配置了多个 git 账号,如何在不同的项目中自动切换不同的作者名字?比如我在公司的代码库里提交代码时,用的就是另外一个名字而非 xiaoxi666。这部分内容涉及到了 git 的配置(可以在终端输入 git config --help 查看官方说明),你一定有过下面这种配置的经历: git config --global user.name "user_name" git config --global user.email "user_name@example.com" 实际上,git 有三种配置选项,分别对应于 --system 、--global、--local,上面就是 --global选项。三种配置选项分别对应于三个配置文件: --system -> /usr/local/git/etc/gitconfig --global -> ~/.gitconfig --local -> 你的项目仓库路径/.git/config 这三种配置文件的优先级由低到高为:--system、--global、--local,优先级高的配置会覆盖优先级低的配置。一般情况下,我们不会去设置 --system 选项,主要用的是 --global 和 --local。正如网上满天飞的教程中,我们一般会设置 --global,这样就不用在每个项目中设置一遍了;但是如果配置了多个 git 账号,需要在一些项目中使用不同的作者名字,就需要单独为该项目设置 --local。需要注意的是, --local 选项只能 cd 到当前项目路径下中执行,否则会报错 fatal: --local can only be used inside a git repository。 注一:如果 --system、--global、--local 都没有设置 user.email,将无法提交代码,因为无法识别代码作者。在设置了 user.email 的前提下,如果 --system、--global、--local 都没有设置 user.name,则会使用计算机登录用户名作为代码提交的作者名字。 注二:设置 --local 时记得同时设置 user.name 和 user.email,如果只设置 user.name,提交名字虽然正确了,但 user.email 还是用的 --global 中的 user.email,这会导致 github 仓库中显示的提交者却不会链接到你的账号:头像是灰色的八爪鱼,名字也没有链接。
  4. 配置文件可指定的参数还有很多,如端口等,这里我们直接使用默认端口 22,因此没有再去指定。

其他

  1. pbcopypbpaste 是两个非常好用的命令,可查阅相关资料了解。
  2. 文章 http://man.linuxde.net/ssh-add 描述了 linux 的 ssh-add 命令,讲得不错。
  3. mac 分别有用户名、主机名(HostName),以及计算机名。其中计算机名可以在 "System Preference" -> "sharing" 中设置,是分享时展示的名字;我们打开终端时,会以用户名@主机名 当前路径 $主机名:当前路径 用户名$ 的格式显示,其中主机名可以用命令 scutil –-set HostName new_hostname 设置。

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • Callable和Supplier的区别

    A Callable is "A task that returns a result, while a Supplier is "a supplier of ...

    xiaoxi666
  • 二分查找变种

    该算法有很多版本,这里给出java中实现比较好的一种方式。其中,>>>为无符号右移。

    xiaoxi666
  • Git中的"pull request"真正比较的是什么?

    利用git版本控制工具时,我们通常会从主分支拉出新分支进行开发,开发完成后创建pr(也就是pull request),让其他小伙伴帮忙review,确定代码没有...

    xiaoxi666
  • 手把手教你一台电脑配置两个Git账户

    将id_rsa_gitlab.pub中的内容添加到gitlab帐号下的SSH Key中

    迹_Jason
  • git ssh 配置多个账户

    版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/gdutxiaoxu/article/details...

    用户2965908
  • 免费创建个人静态网站最佳实践:hugo+github+netlify

    关于搭建一个博客或个人网站的好处不用我多说,但创建网站的难度可能会让人望而却步。本人从网络上获得过很多帮助,学到很多。很早就萌发了自己建网站并分享知识的想法,但...

    风不止
  • github设置webhook完成自动化部署

    这个功能工作中其实一直都在使用,但是自己的一些个人服务因为更新不是很频繁(主要是自己懒)所以就这个需求就不是很大,最近在要做一点小东西,push比较频繁,每次都...

    pooky
  • Linux下Sublime Text 2的安装

    安装方法1: 通过apt-get install来安装,可以如下来做: sudo add-apt-repository ppa:webupd8team/subl...

    joshua317
  • WebStorm中使用Git同步代码到Github

    项目开发时使用GitHub作为公共代码仓库托管代码,可以极大的提高团队合作效率,同时也可以实现代码云端存储等,方便自己也方便大家!下面记录一下自己配置webst...

    宋天伦
  • Hutool,一个贼好用的 Java 工具类库,用过都说好~

    来源:ryanc.cc/archives/hutool-java-tools-lib

    芋道源码

扫码关注云+社区

领取腾讯云代金券