@Jul 28, 2014

GitHub是一个基于Git的代码托管平台，用户可以免费在上面放自己的代码，不过代码是公开的，属于公共仓库，要放私人代码则需要付费来创建个人仓库。使用其他基于Git的代码托管网站，客户端的安装和使用也是类似的，可以将下面的客户端配置成连接其他其他代码托管网站。

要使用GitHub，首先在Git 上创建一个账户，然后在自己的电脑上安装一个Git的客户端来进行各种操作。

Note: 基于Git的代码托管网站，国外的主要有：

github：https://github.com/

gitorious：https://gitorious.org/

国内的是京东: code.jd.com和CSDN: code.csdn.com (可以免费创建自己的私有代码仓库)

1 安装Git客户端

GitHub的客户端有很多，一般都是一个GUI程序加一个命令行程序，配置都是类似的。

下载A或B

msysgit: http://git-scm.com/book/en/Getting-Started-Installing-Git

GitHub for Windows: https://help.github.com/articles/set-up-git，GitHub专用的客户端，这个界面更简洁，有些配置自动完成了，安装后是两个分开的程序：GUI和命令行程序。

安装msysgit时选择带Unixstyle的命令行的选项，这样除了Git GUI外，还可以使用命令行工具GUI Bash。下面是安装完成后的程序

Git GUI, 一个运行Git的图形界面工具。

Repository >Git Bash，一个BASH模拟器，使用命令行来运行Git，就像在Linux下运行git命令。

右键打开文件时，可以选择使用BASH或GUI进行操作。

下面要配置客户端，follow git guide. (https://help.github.com/articles/set-up-git)

配置非常简单，在命令行程序中分别输入下面的命令配置username 和 email: (这些配置在安装B时已经完成了。)

$git config --global user.name "YOUR NAME"
$git config --global user.email "YOUR EMAIL ADDRESS"

然后就可以访问GitHub，访问GitHub可以使用不同的Url地址：SSH和Https。（参考：https://help.github.com/articles/which-remote-url-should-i-use#cloning-with-ssh）。只有使用SSH连接才需要配置SSH Key。

1.1 SSH连接

通过SSH协议连接更安全，这种方式需要创建一个SSH key，相当于GitHub的用户名和密码，使用的URL地址类似于[email protected]:user_name/***.git (在GitHub上进入一个repository后可以在页面查看访问该仓库的url地址)。

SSH连接的端口有可能会被防火墙的阻止，提示” ssh: connect to host github.com port 22: Bad file number”，可以使用Https的端口443，但是使用代理服务器可能不行。（https://help.github.com/articles/using-ssh-over-the-https-port）。

如果还不成功，提示PermissionDenied，参考https://help.github.com/articles/error-permission-denied-publickey。

提示” ssh: connectto host github.com port 443: Bad file number”，有可能重启网络连接就OK了，参考http://stackoverflow.com/questions/7144811/git-ssh-error-connect-to-host-bad-file-number。

Note: 安装B客户端会后会自动创建SSHKey并添加到服务器的GitHub中。