实战 Win 7下安装 Gitosis (Windows下的 git 服务器)

Gitosis 是一个使用SSH管理Git仓库的服务端工具，有意思的是，该软件用来添加用户和设定权限的界面不是网页，而是一个特殊的 Git 仓库。你只需要设定好某个项目，然后推送，Gitosis 就会随之改变服务器设定，酷！

        在Linux下的安装方法已经非常成熟，上网Google一下就有很多，而在Windows下的安装则花了我不少功夫，只要是有时候碰到问题无从入手，以下将整个安装过程详细记录下来。

总体分为如下几大步骤：

• 下载安装Cygwin
• 修改安装后相关目录的访问权限
• 安装 ssh 守护进程服务
• 在Windows防火墙内开放上述 ssh 服务需要的22端口
• 安装配置python-setuptools
• 安装配置Gitosis
• 使用Gitosis

一）下载安装Cygwin

1）到http://www.cygwin.com/官方网站下载 Cygwin 的在线安装程序 setup.exe。

2）以管理员身份运行setup.exe开始安装Cygwin

3）Cygwin安装过程截图

点击下一步继续

选择“Install from Internet”

设置Cygwin的安装路径Root Directory，选择“All Users(RECOMMENDED)”

设置Cygwin在线下载的数据包的保存路径Local Package Directory

选择“Direct Connection”

选择下载文件的镜像地址后点击下一步（选择不同的地址会影响下载速度）

开始下载相关数据包

如果是首次安装Cygwin，将会弹出如下界面，点击确定继续即可

选择默认并没有包含的相应包，包括：

• devel 分类下的 git
• net 分类下的 openssh
• Python 分类下的 python（这里顺便记录一下python的版本号，后面会用到，如2.6）

点击下一步继续 

到了漫长的下载等待界面了 

点击完成后Cygwin就安装完毕了 

二）修改安装后相关目录的访问权限

进入“开始/所有程序/Cygwin/Cygwin Bash Shell”，右键以管理员身份运行“Cygwin Bash Shell”，在命令行中分别运行如下命令：

$ chmod +r /etc/passwd 
$ chmod u+w /etc/passwd 
$ chmod +r /etc/group 
$ chmod u+w /etc/group

运行的截图如下：

三）安装 ssh 守护进程服务

继续执行如下命令：

$ ssh-host-config

根据命令的提示分别回答：yes、yes、yes、ntsec tty、no、yes、[密码]、[重复密码]，参考如下截图：

（注意图中圈住部分的回答）

至此ssh服务安装完毕！

打开Windows的命令行，运行“> net start sshd”启动ssh服务（也可以到Windows服务中启动）。

四）在Windows防火墙内开放上述 ssh 服务需要的22端口

进入“控制面板/系统与安全/Windows防火墙/高级设置(在左边栏)”，添加新的入站规则：

名称可以根据自己的喜好相应修改。

五）安装python setuptools

先设置python路径的访问权限，保证所有用户都可以访问：

$ chmod +r /lib/python2.6/ -R

2.6是所安装python的版本号，要对上你安装的版本号才行，我装的时候是2.6，如果忘记了，可以在Cygwin的命令终端输入“$ python -v”查看一下。

到 Python Package Index 主页下载对应版本的python setuptools，如2.6版对应要下载 setuptools-0.6c11-py2.6.egg。

将setuptools-0.6c11-py2.6.egg复制到/home/your_user_name目录下（也可以按自己的需要复制到其它地方，注意下面的运行路径正确即可），然后在该目录的Cygwin终端下运行如下命令安装：

$ ./setuptools-0.6c11-py2.6.egg 

看到输出类似如下的信息就表示安装成功了：

Processing setuptools-0.6c11-py2.6.egg 
Copying setuptools-0.6c11-py2.6.egg to /usr/lib/python2.6/site-packages 
Adding setuptools 0.6c11 to easy-install.pth file 
Installing easy_install script to /usr/bin 
Installing easy_install-2.6 script to /usr/bin 

Installed /usr/lib/python2.6/site-packages/setuptools-0.6c11-py2.6.egg 
Processing dependencies for setuptools==0.6c11 
Finished processing dependencies for setuptools==0.6c11 

六）安装配置Gitosis

1) 运行如下命令将Gitosis管理端的git仓库下载下来：

$ mkdir sources 
$ cd sources  
$ git clone git://eagain.net/gitosis.git 

2) 下载成功后再运行如下命令进行初始化：

$ cd gitosis  
$ python setup.py install

这将会输出一大堆的信息，如果没有出现问题，最后那一行输出的信息类似于“Finished processing dependencies for gitosis==0.2”。

3) 到“控制面板/用户帐户和家庭安全”添加一个账户名称为“git”的帐号，密码自定，类型选标准用户即可。

4) 继续在Cygwin终端运行如下命令，将刚添加的git帐号添加到Cygwin的passwd文件：

$ mkpasswd -l -u git >> /etc/passwd 

再使用你喜欢的任何方式查看一下passwd文件（文件的最后那一行），确认git帐号已经添加进去。

5) 拷贝你的公钥文件到目录“/tmp/id_rsa.pub”，再在终端运行“$ chmod 755 /tmp/id_rsa.pub”修改文件的权限

    如果你还没有相应的公钥，就自己生成一个，参考GitHub Guide上的“Set Up SSH Keys”指引或参考基于互联网的Git开发环境搭建(Windows系统)中第3点“ 生成 Git 要使用的 ssh key”的相关指引。

6）以git用户打开一个新的Cygwin终端(如下图所示，位置在开始/所有程序/Cygwin）

在该终端内运行如下命令初始化公钥的配置：

$ gitosis-init < /tmp/id_rsa.pub 

如果你运气好的话，成功后你将会看到如下信息：

如果出现错误，参考下面第7步的处理

7）如果第6步出现类似如下错误信息：

0 [main] python 4268 D:/cygwin/bin/python.exe: *** fatal error - unable to remap //?/D:/cygwin/lib/python2.6/lib-dynload/select.dll to same address as parent: 0x3E0000 != 0x410000

按如下说明处理：

    关闭所有当前打开的所有Cygwin终端窗口，停止sshd服务，然后打开Windows的CMD命令行窗口，切换到cygwin/bin目录，运行ash命令，会出现$命令行，继续输入“$ /bin/rebaseall”,如果没有任何错误信息就OK了，参考如下截图：

错误处理完毕后，重新启动sshd服务，再按上面第6步重新操作一遍即可。

8）切换回以管理员身份打开的那个Cygwin终端窗口（如果因第7步已经关闭则重新打开一个），运行如下命令

$ chmod 755 /home/git/repositories/gitosis-admin.git/hooks/post-update 

至此Gitosis成功安装完毕！

七）使用Gitosis

1）将Gitosis管理端的git仓库检出来，位置随意

$ git clone git@your-server-name:gitosis-admin.git

以下尝试创建一个test仓库，并配置访问权限。

2）进入刚刚检出的目录gitosis-admin，编辑gitosis.conf文件，增加如下信息：

[group test]
writable = test
members = your_email_from_ssh_key

保存，并提交、push到gitosis-admin.git仓库。

3）在你喜欢的地方创建一个空目录test，里面放个readme.txt文件，然后打开Git Bash终端，进入到test目录内运行如下命令，test.git仓库就会在服务端自动创建了（注意经过第2步后是不能直接"$ git clone"出来的，会报错，必须自己有个非空的git仓库然后push上去才行）。

$ git add .
$ git init
$ git commit -m init
$ git remote add origin git@your-server:test.git
$ git push origin master

现在你到“cygwin/home/git/repositories”目录下看看，test.git仓库已经稳放在那里了！

test仓库只是一个原理演示，任何其他的git仓库操作是类似的。

参考资料：

Setting up Gitosis on Windows 7

python.exe: *** fatal error - unable to remap

Git 服务器软件 gitosis 的改进

Pro Git：服务器上的Git 权限管理器Gitosis

Gitosis自身的Readme

还有个git仓库管理工具叫gitolite，用perl写的，听说可以控制到分支的权限等更多功能，有兴趣的可以参考一下下面的链接：

Gitolite 构建 Git 服务器

原帖：http://rongjih.blog.163.com/blog/static/33574461201121611154627/