对很多开发者,尤其是手握几台甚至几十台机器的同学而言,登录到远程机器处理事务应该是家常便饭。如果你也是其中一员,悄悄问一句,你平时是如何记住一堆帐号、机器地址以及一些附加登录选项的呢?或许你也是这么干的:

倘若你有一个远程服务器,地址为 test.server.com, 防止人为攻击,你将 ssh 的端口号从 22 改成了 8892,当你需要登录到这台机器时,需要这么做:

➜ ~ ssh YOURNAME@test.server.com -p 8892
password: *******

尚好。如果你先前已经将已经注册了一个公钥/私钥对,并且正确的部署到了远程机器,你可以省却输入密码这个环节(推荐学习 ssh-copy-id 命令)。

为了可以再懒一点,索性将这一串代码添加一个 alias:

➜ ~ alias test='ssh YOURNAME@test.server.com -p 8892'
➜ ~ test

一条 test 命令即可让你登录到服务器,对于只有一两台远程机器的你,应该算是特别便捷了。

多 SSH Key 的管理

SSH 连接建立之前,会在系统中寻找它的配置,一般有两个位置。

  • /etc/ssh/ssh_config 这里是对所有用户适用的全局配置
  • ~/.ssh/config 或者 $HOME/.ssh/config 这是用户的个人配置,这些配置会覆盖全局配置

注意:一般来说,我们给 ~/.ssh 文件夹赋予的权限为 0700

配置格式比较简单,以下配置等同于上面我们的登录命令设置:

Host test
HostName test.server.com
User YOURNAME
Port 8892

可以是 param value 也可以为 param=value,其中 param 对大小写不敏感,value 对大小写敏感。

使用 ssh test 即可完成登录,当我们有稍微麻烦点配置的时候,如数据库的 3306 端口对外不开放,可以开放另一个接口,然后内部跳转到 3306,使用命令行的写法是:

ssh -f -N -L 8999:127.0.0.1:3306 test@database.server.com

大串的命令行,过多的参数,实在是有点不好记。而在 config 文件中的配置就一目了然:

Host test
HostName test.server.com
User YOURNAME
LocalForward 8999 127.0.0.1:3306

当你有多台远程终端的时候,config 文件的优势就更加明显了:

# serverlist
Host list
HostName *.serverlist.com
User YOURNAME
IdentityFile ~/.ssh/serverlist.com.key
# personal server
Host personal
HostName proxy1.barretlee.com proxy2.barretlee.com
User barretlee
IdentityFile ~/.ssh/proxy.barretlee.com.key
# school
HostName 222.20.74.89
User school
LocalForward 8999 127.0.0.1:3306
IdentityFile ~/.ssh/school.key
# and so on.

这里常用的的 param 也不是很多:

  • Host,SSH 连接名
  • HostName,如上所示,可以是通配符,可以是 IP,也可以是域名等
  • User,登录的用户名
  • IdentifyFile,version 1 协议下默认是 ~/.ssh/identify,version 2 协议下,默认是依次匹配:~/.ssh/id_dsa~/.ssh/id_ecdsa~/.ssh/id_rsa,还有 version 2 兼容模式。
  • LocalForward 端口的内部跳转
  • Port,端口设置,默认 SSH 的端口是 22
  • Protocal,协议版本号,1 或者 2

Git 多账户登录问题

向仓库 push 代码之前,我们都会做一番设置,简单归纳为如下几步:

  • 注册获取用户名 barretlee
  • 创建仓库 barretlee/test.git
  • 创建密钥,ssh-keygen -t rsa -C "barret.china@gmail.com"
  • 将公钥 id_rsa.pub 填到 Git Server 上(如果没有可视化界面,还需要登录到 Server 命令行操作推送)
  • 本地通过 ssh-agent 将密钥添加到 session 中,ssh-add id_rsa,部分终端中还需要手动开启 ssh-agent
  • 然后测试连接,如 github 中, ssh -T git@git.github.com
  • 看到了 ‘welcome barretlee…’ 的提示,开始 push 你的代码

突然有一天,你又注册了一个帐号 xiaohuzige,也走了一遍上面的流程,发现死活也连接不上,服务器总是提示:You have no permission to access this repo,这是怎么回事呢?

这个时候,你可以输入这个命令,看看是哪个环节出了问题:

➜ ~ ssh -vT git@github.com
OpenSSH_6.9p1, LibreSSL 2.1.7
debug1: Reading configuration data /Users/barretlee/.ssh/config
debug1: /Users/barretlee/.ssh/config line 2: Applying options for *
debug1: Reading configuration data /etc/ssh/ssh_config
debug1: /etc/ssh/ssh_config line 20: Applying options for *
debug1: /etc/ssh/ssh_config line 102: Applying options for *
debug1: Connecting to github.com [192.30.252.128] port 22.
debug1: Connection established.
debug1: key_load_public: No such file or directory
debug1: identity file /Users/barretlee/.ssh/id_rsa type -1
debug1: key_load_public: No such file or directory
debug1: identity file /Users/barretlee/.ssh/id_rsa-cert type -1
debug1: key_load_public: No such file or directory
debug1: identity file /Users/barretlee/.ssh/id_dsa type -1
debug1: key_load_public: No such file or directory
debug1: identity file /Users/barretlee/.ssh/id_dsa-cert type -1
debug1: key_load_public: No such file or directory
debug1: identity file /Users/barretlee/.ssh/id_ecdsa type -1
debug1: key_load_public: No such file or directory
debug1: identity file /Users/barretlee/.ssh/id_ecdsa-cert type -1
debug1: key_load_public: No such file or directory
debug1: identity file /Users/barretlee/.ssh/id_ed25519 type -1
debug1: key_load_public: No such file or directory
debug1: identity file /Users/barretlee/.ssh/id_ed25519-cert type -1
debug1: Enabling compatibility mode for protocol 2.0
debug1: Local version string SSH-2.0-OpenSSH_6.9
debug1: Remote protocol version 2.0, remote software version libssh-0.7.0
debug1: no match: libssh-0.7.0
debug1: Authenticating to github.com:22 as 'git'
debug1: SSH2_MSG_KEXINIT sent
debug1: SSH2_MSG_KEXINIT received
debug1: kex: server->client chacha20-poly1305@openssh.com <implicit> none
debug1: kex: client->server chacha20-poly1305@openssh.com <implicit> none
debug1: expecting SSH2_MSG_KEX_ECDH_REPLY
debug1: Server host key: ssh-rsa SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCARLviKw6E5SY8
debug1: Host 'github.com' is known and matches the RSA host key.
debug1: Found key in /Users/barretlee/.ssh/known_hosts:4
Warning: Permanently added the RSA host key for IP address '192.30.252.128' to the list of known hosts.
debug1: SSH2_MSG_NEWKEYS sent
debug1: expecting SSH2_MSG_NEWKEYS
debug1: SSH2_MSG_NEWKEYS received
debug1: Roaming not allowed by server
debug1: SSH2_MSG_SERVICE_REQUEST sent
debug1: SSH2_MSG_SERVICE_ACCEPT received
debug1: Authentications that can continue: publickey
debug1: Next authentication method: publickey
debug1: Trying private key: /Users/barretlee/.ssh/id_rsa
debug1: Trying private key: /Users/barretlee/.ssh/id_dsa
debug1: Trying private key: /Users/barretlee/.ssh/id_ecdsa
debug1: Trying private key: /Users/barretlee/.ssh/id_ed25519
debug1: No more authentication methods to try.
Permission denied (publickey).

不加 v 参数,输出的内容很简洁:

➜ ~ ssh -T git@github.com
Warning: Permanently added the RSA host key for IP address '192.30.252.129' to the list of known hosts.
Permission denied (publickey).

好吧,我知道你看不懂上面一长串的内容,也没心情看下去,但是你可以把焦点落到重复的那几段:

debug1: ...
debug1: xxx, No such file or directory
debug1: ...
debug1: Trying private key: /Users/barretlee/.ssh/xxx
debug1: ...

之前我们提到了 Protocal Version 1 和 Version 2,不同的版本号,默认的私钥地址不一样,所以程序会不断去尝试寻找默认的地址,如果没找到,最后会提示,授权失败,禁止访问。

我们可以在 push 代码之前,使用 ssh-agent 来管理私钥的 session,如:

➜ ~ ssh-add .ssh/coding_barretlee
Identity added: ~/.ssh/coding_barretlee (coding_barretlee)
➜ ~ ssh-add .ssh/github_barretlee
Identity added: ~/.ssh/github_barretlee (github_barretlee)

那么当程序寻找私钥的时候,就会优先到 ssh-agent 添加的 session 中寻找。session 的生命周期不是很长,当你重启电脑之后它就没了。如果你有遇到了 Permission Denied 的提示,请重新执行 ssh-add 命令。

当你在某个 Git 服务器上有多个帐号的时候,可能某个帐号总是提示:Permission Denied。拿 coding.net 上来说,我有两个账户,一个是 barretlee,另一个是 taobaofed,由于先前我一直用的 barretlee 账户,后来者 taobaofed 的代码死活推不上去。反反复复地检查配置,反反复复地检查上传的公钥,反反复复地使用 ssh -T git@git.coding.net 测试,没看到哪里不对,然而 taobaofed 的代码就是推不上去,这是怎么回事呢?

当然,上面 SSH 介绍了那么多,其简明易懂的配置在这里也是可以用上的:

### default for all ##
Host *
ForwardAgent no
ForwardX11 no
ForwardX11Trusted yes
User nixcraft
Port 22
Protocol 2
ServerAliveInterval 60
ServerAliveCountMax 30
## barretlee coding ##
Host coding-barretlee
HostName git.coding.net
User barretlee
IdentityFile ~/.ssh/coding_barretlee
## taobaofed coding ##
Host coding-taobaofed
HostName git.coding.net
User taobaofed
IdentityFile ~/.ssh/coding_taobaofed

使用这种配置,我们可以避免使用 ssh-agent 添加 session 操作。可是,我就是按照上面的方式配置的呀,依然不行!

这里的问题在于,我们的 User 项不正确,每次推送代码的时候,git 会读取上次的的 User 配置,而我的配置是 barretlee,那么下次提交代码的时候虽然 IdentityFile 用对了,但是 User 不是 taobaofed,所以死活也推不动代码。

解决的方案很简单,如果在下载代码之前就已经设置好了两个帐号,你可以通过如下命令克隆代码:

➜ ~ git clone git@coding-taobaofed:taobaofed/blog.git

如果是在已有的仓库中,其默认 origin 配置会是://git.coding.net/taobaofed/blog.git 或者 git@git.coding.net:taobaofed/blog.git,你可以将仓库下的 .git/config 文件修改下:

[remote "origin"]
url = git@coding-taobaofed:taobaofed/blog.git
fetch = +refs/heads/*:refs/remotes/origin/*

防止克隆其他仓库代码也出现问题,我们可以将 ~/.ssh/config 稍加修改:

## barretlee coding ##
Host git.coding.net coding-barretlee
HostName git.coding.net
User barretlee
IdentityFile ~/.ssh/coding_barretlee
## taobaofed coding ##
Host coding-taobaofed
HostName git.coding.net
User taobaofed
IdentityFile ~/.ssh/coding_taobaofed

那么,通过正常的 clone(如git clone git@git.coding.net:barretlee/blog.git)就不会出现 Permission Denied 的提示了。

需要引起注意的一点:在寻找配置的时候,ssh 会优先查看 ssh-agent session 中的配置,然后才是 config 文件,如果你 ssh-add 添加过 key,建议执行如下操作:

➜ ~ ssh-add -D # 删除所有的 session

最后

撰写本文之前,我已经踩坑三小时,花了三个小时,摸索出来这么些东西,感觉以后妈妈再也不用担心我的 Git/SSH 的配置问题了。

最主要的手段依然是通过 ssh -vT 查看 SSH 交互过程中出现了什么障碍,debug 信息还是很有考究价值的!