如何在WINDOWS下使用copSSH配置GIT服务器+TortiseGIT客户端

基本原理：使用copSSH在WINDOWS（XP）上建立SSH服务器；使用生成的“公钥-私钥”对作为身份标识；在服务器上配置SHELL脚本环境；配置客户端，加载私钥。详细过程如下：

　　安装前准备：

Download copSSH [SourceForge Link] （注：SSH服务器软件）

Download msysgit （注：WINDOWS下的git安装包）

Download TortiseGIT （注：WINDOWS下的git图形化软件，与TortiseSVN是同门）

Download PuTTY Installer （注：生成公钥-私钥对的软件，并可用于SSH客户端的登陆）

　　Step1 －安装copSSH

1将copSSH（basic edition 200）安装到路径 c:\SSH

2安装过程中写下SvcCOPSSH的密码，你可能永远不会用到，但写下也无伤大雅。

3启动copSSH，选择 开始->所有程序->copSSH->control panel；然后激活一个用户（假定为Administrator，选择Users->Add，下一步，选择一个用户，不要勾选Allow password authenticatin选项，点击forward，OK。

4其他关于public keys的事情无需操作，后面还会讲到。

　　Step2－配置copSSH

1选择路径－C:\SSH\etc ，在记事本中打开ssh_config 和sshd_config(注意：两个文件有一个字母“d”的区别）

2ssh_config －删除Port前的#号，设置端口号，这里采用默认端口22

3sshd_config －保证端口号一致

4确定系统防火墙中该端口未关闭。（这一点很重要）

5重启系统

　　Step3－安装Putty

1重启之后，继续回来，现在可以安装Putty Installer了。

2导航至你的安装路径，通常为c:\program files\Putty

3打开PuttyGenexe

4选择生成密钥的长度4096

5在空白面板处不停地晃动鼠标（用于生成随机种子），直到生成结束。（不要关闭PuttyGen）

6来到路径c:\SSH\Home\Administrator\ssh\ （这个路径在你使用copSSH激活用户时会产生，根据你激活的用户名，选择相应的路径），创建文件authorized_keys （注意没有后缀名）

7打开PuttyGen，复制Public Key（公钥）到文件authorized_keys ，并保存

8在PuttyGen中，将Private Key（私钥）保存为private_keyppk，保存在同一目录下。－比如，我的保存目录为c:\SSH\Home\Administrator\ssh\private_keyppk

9现在目录下应该有两个文件了，authorized_keys 和 private_keyppk

10为了测试连接，运行puttyexe

11在打开的界面中输入IP 地址（本机可以为localhost）和端口号

12打开左侧的菜单，选择Connection-SSH-Auth，选择你的私钥文件，c:\SSH\Home\<user>\ssh\private_keyppk

13点击Open，就会打开终端，让你输入Login Name，输入Administrator（注意大小写）

14你会看到显示接受你的公钥（Accept Public Key），客户端登陆成功，登陆信息也会缓存起来。

　　Step 4－安装 msysgit和TortiseGIT

1安装msysgit的过程中一路下一步即可，假定你的路径为C:\msysgit

2安装TortiseGIT，完成之后

　1）在任意路径点右键，选择TortiseGIT-Settings，设置gitexe的路径为c:\msysgit\msysgit\bin，即为msysgit的安装路径

　2）在左侧菜单中选择Network，选择SSH Client为putty中的plinkexe（如我的路径为C:\Program Files\PuTTY\plinkexe）

3将几个GIT运行中需要的文件复制到SSH服务器目录，当客户端远程登陆上来以后需要执行这些文件，文件源路径为c:\msysgit\msysgit\Git\libexec\git-core ，要复制的文件包括gitexe, git-receive-packexe, git-upload-archiveexe and git-upload-packexe，将以上文件复制到C:\SSH\Bin

　　Step5－配置用户环境

1对于copSSH来说，其默认的$HOME环境为c:\Documents and Settings\<user>，GIT也将会在该目录下寻找authorized_keys 文件。当然，这是咱要避免的事儿，我们要将GIT的路径重定向到C:\SSH\Home\<user>\ssh 。

2选择路径C:\SSH\Home\Administrator\，打开bashrc文件，在# User dependent bashrc file下面加上这样一段：export HOME=/c/SSH/home/Administrator Shell Options,（注意不要有其他空格出现），然后选择保存。

3把该文件复制到用户目录下，如： c:\Documents and Settings\Administrator\

　　Step7－使用GIT和Plink

1打开路径C:\SSH\home\Administrator，创建文件夹myappgit

2 在该文件夹上点右键，选择git create repository here,勾选make it bare，服务器文件仓库创建成功。

3导航至路径c:\Program Files\PuTTY ，打开pageantexe，选择add key，将你的私钥（private_keyppk）加载上。

4然后右键选择 git clone，url设为ssh://administrator@127001:22/SSH/Home/administrator/myappgit ，如果clone成功，恭喜你，大功告成！

关于git的操作详见git的使用说明，这里推荐Pro Git 简体中文版，翻译的很不错。

　　注：在执行git clone时可能会报错（该错误在所参考的E文中未提及，把俺害得不轻），如果是关于某个dll文件的错（具体是哪个文件记不清了，遇到的朋友可以根据文件名，在msysigt目录下搜索即可找到），可以将该文件同样复制到C:\SSH\Bin下，然后就可以正常运行了。

Git没有客户端服务器端的概念，但是要共享Git仓库，就需要用到SSH协议（FTP , HTTPS , SFTP等协议也能实现Git共享，此文档不讨论），但是SSH有客户端服务器端，所以在windows下的开发要把自己的Git仓库共享出去的话，就必 须做SSH服务器。

一、安装GIT

Windows下使用msysgit，

本文使用Git-178-preview20111206exe 安装要点步骤

安装完成后，可以使用Git bash在命令行模式下操作git

二、安装CopSSH

安装CopSSH之前先确保防火墙开启了SSH端口，这个虽然不影响CopSSH的安装，但是影响SSH访问，所以写在前面。

CopSSH是windows下的SSH服务器软件，下载地址baidu之，本文使用的是Copssh_410_Installerexe，

安装完成后，到控制面板中新建一个管理员账户root，用这个账户来共享SSH。然后你在账户管理中会看到之前的SvcCOPSSH账户。

将root用户添加到CopSSH用户中，为简单操作，允许使用密码认证方式

若是不允许密码认证，则需要使用公钥密钥方式认证，

三、CopSSH中使用GIT

现在已经安装GIT和CopSSH，接下来需要做的就是让CopSSH可以使用GIT的命令，这样不仅能够远程SSH管理GIT服务器，而且可以将GIT仓库通过SSH共享。具体的操作方法是将GIT的某些命令程序和动态链接库复制到CopSSH安装目录下即可。

l 将$ Git\libexec\git-core目录下的gitexe , git-receive-packexe , git-upload-archiveexe , git-upload-packexe复制到$ICW\bin目录下

l 将$Git\bin目录下的libiconv-2dll复制到$ICW\bin目录下

重启CopSSH即可

众所周知，版本系统在开发环境中是必不可少的，但是我们可以把代码免费的托管到GitHub上，如果我们不原意公开项目的源代码，公司又不想付费使用，那么我们可以自己搭建一台Git服务器，可以用Gitosis来管理公钥，还是比较方便的。

搭建环境：

服务器 CentOS66 + git（version 1831）

客户端 Windows10 + git（version 2111windows1）

1 安装Git相关软件

Linux是服务器端系统，Windows作为客户端系统，分别安装Git

安装客户端：

下载 Git for Windows，地址：https://git-for-windowsgithubio/

安装完之后，可以使用Git Bash作为命令行客户端。

安装Gitosis

出现下面的信息表示安装成功了

2 服务器端创建git用户来管理Git服务

3 配置公钥

在Windows上配置管理者，git服务器需要一些管理者，通过上传开发者机器的公钥到服务器，添加成为git服务器的管理者,打开git命令行

4 配置gitosis

使用git用户并初始化gitosis

在Windows上机器上clone gitosis-admin到管理者主机

gitosisconf: git服务器配置文件

keydir: 存放客户端公钥

配置 gitosisconf 文件

在Windows管理者机器上创建本地test仓库，并上传到git服务端

提交到远程服务器

服务端会自动创建test仓库

5添加其他git用户开发者

由于公司开发团队人数不断增多，手动添加开发者私钥到/home/git/ssh/authorized_keys比较麻烦，通过上面的Windows机器的管理者统一收集其他开发者的私钥id_rsapub文件，然后传到服务器上，配置好后，用户即获得项目权限，可以从远程仓库拉取和推送项目，达到共同开发项目。

推送完成后，新加进来的开发者就可以进行项目的开发了，后续增加人员可以这样添加进来，开发者直接把仓库clone下来就可以了。

方案一 基于SSH直接搭建

Git支持的协议主要是四种：

本地： 需要文件共享系统，权限不好控制

HTTP：速度慢

SSH：同时支持读写操作，不支持匿名的读取（Git默认协议）

GIT：最快

从搭建的难易程度和特点综合筛选，最合适的还是ssh，并且大部分服务器上基本都有ssh服务，所以省去了不少麻烦。一个最基本的思路是给每一个人一个ssh帐号，这样大家就可以通过用户名和口令来访问了，但是显然这不是一个好的选择，这个做法有些多余，并且对于repo的权限很难管理。

在使用Github的时候，会利用rsapub公钥/私钥的方式，这样在服务端拥有用户的公钥（pub）之后就可以，跨过繁琐的口令，直接认证提交了，而服务端也会根据不同的用户身份，对其权限有着更加灵活的管理。因此也采用这种方式。

服务端

为了使远程库访问更加直观，先在服务器上创建一个名为git的账户，这样以后clone的时候就如下面的格式了：

git clone git@server:somegit

创建新的用户，创建repo等目录

$sudo adduser git

$su git

$cd ~

$mkdir repos

在HOME下的。ssh目录，如果没有则创建，创建一个authorized_keys文件，这个文件就是用来管理所有git用户的公钥的，也就是这里面的用户对于项目有着R+W的权限。

客户端

对于每一个客户端，需要生成一对密钥和公钥，如果是Github用户，那么。ssh目录下，一定有id_rsapub和id_rsa两个文件，其中第一个是系统生成的公钥，另一个是自己要保存好的密钥。如果没有的话，可以在终端执行：ssh-keygen来生成，完成后，将自己的公钥提交给管理员，这就是一个注册的行为。

完成

最后一步，管理员将团队成员的公钥添加到authorized_keys中，比如将同学susie加入：

$ cat susiepub 》 authorized_keys

至此，大家可以通过git@server:repos/somegit来访问公共的版本库了。

问题

安全问题，成员可以登录git用户的shell,细节权限如分支等不好控制

管理麻烦，新建repo,或者增加成员比较麻烦，尤其是修改的时候

方案二 使用Gitolite服务

Gitolite 也是基于SSH协议构建的方便管理git repo的应用，可以通过其源码安装。

安装

安装按照官方给定的文档就可以轻易的实现：

$ git clone git://githubcom/sitaramc/gitolite

$ mkdir -p $HOME/bin

$ gitolite/install -to $HOME/bin

$ gitolite setup -pk YourNamepub

如果执行最后一条命令的时候，gitolite不识别，则可以通过下面两种方式解决：

将gitolite添加到PATH里面

通过$HOME/bin/gitolite setup -pk YourNamepub 执行

至此，gitolite在服务端，搭建完毕，会发现此时HOME目录下增加了一个文件projectslist和一个目录repositories,后者就是我们的版本仓库了，每当新建repo的时候，就会在其中创建。

使用

是时候说一下gitolite的管理模式了，他会创建一个gitolite-admin的repo，管理员就是通过像这个repo提交配置文件而实现对git服务器的控制的。

首先，将这个repo导入到我们的workspace：在此之前，需要配置本地的ssh,gitolite要求管理员的本地密钥和其注册公钥的名字一致，比如安装的时候指定 -pk后面为 adminpub 则管理员本地需要由admin对应的私钥。我们可以通过~/ssh/config来进行配置（注：有些系统可以用conf，Mac OSX 下无效，只能用config）。

host gitolite

user git

hostname yourhostnamecom

port 22

identityfile ~/ssh/admin

这样，当访问gitolite的时候就会自动根据配置文件执行，配置完成后可以根据下面的命令，将gitolite-admin转移到本地。

git clone gitolite:gitolite-admingit

克隆完成后，可以发现，gitolite-admin下面有两个目录，其中conf保存配置文件，可以通过编辑里面的gitoliteconf文件，管理git服务器，keydir目录保存用户的公钥pub文件。

当讲修改后的repo 提交的时候，gitolite就会自动的应用这些配置，管理过程就方便了很多。

配置规则

打开gitoliteconf文件可以看到其中的示例：

To add new users alice, bob, and carol, obtain their public keys and add them to 'keydir' as alicepub, bobpub, and carolpub respectively

To add a new repo 'foo' and give different levels of access to these users, edit the file 'conf/gitoliteconf' and add lines like this:

repo foo

RW+ = alice

RW = bob

R = carol

上面的配置文件就是新建了一个repo foo，并且添加了三位项目成员，每一个人的权限不同。提交push后，管理便生效了。

可视化

可能会需要一个web界面来管理这些项目，目前知道的有三种方式：

git源码中自带的组件，cgi脚本实现，使用gitolite服务

gitlab开源框架，基于ROR，新版本不再使用gitolite服务

FB开源PHP框架 phabricator，功能高端上档次