debian下使用gitosis+gitweb搭建SSH认证的git服务器

搭建完成Git服务器后,需要使用两台机器进行测试,一台机器作为服务器端server,一台服务器作为客户端client。整个系统,需要三个计算机账户,这里假设server端的账户名为git,client端需要一个管理员gitadmin,一个开发者gituser。这里的环境,使用两台处于同一局域网内的两台机器作为server以及client,其中server端系统为debian 6,client端为fedora 16。
1    建立server端账户git,用于安装git相关的服务。

sudo useradd -m git #添加git账户

sudo passwd git                #添加git密码

添加完账户之后,如果/etc/default/useradd设置合理的话,系统会自动生成相应的宿主目录。如果没有的话,而且想把托管项目放在宿主目录下的话,则需要手动添加。

su git                                #切到新建的git账户

sudo mkdir /home/git    #新建宿主目录

sudo chown git:git /home/git #修改相应的uid及gid

debian下新建git账户之后,切到git下,相应的bash以及sudo均没有配置,需要重新配置,这里为了方便,直接将之前已经配置好的其他用户的配置文件拷贝过来。

su root

visudo      #配置sudo,将git ALL=(ALL)ALL添加到里面,保存后生效。

su git       #切回git账户

sudo cp /home/XXX/.bashrc  /home/git/

sudo cp /home/XXX/.profile  /home/git/    #XXX为你的其他的宿主目录

这样,server端的git账户就建立完毕。client端的管理账户admin以及user同理可以建立。

2   server端安装git及SSH相关服务

  2.1 安装git并初始化

sudo apt-get install git-core        #安装git,安装成功之后,配置git

git config --global user.name "yourname"

git config --global user.email "[email protected]"   #配置git

  2.2安装ssh服务

   sudo apt-get install openssh-server openssh-client

  2.3配置SSH

安装完成之后,修改ssh配置文件/etc/ssh/sshd_config

   Port 22 # 修改成你想要的登陆端口,如2222

   PermitRootLogin no # 禁止root用户登陆

   StrictModes yes # 检查密钥的用户和权限是否正确,默认打开的

   RSAAuthentication yes # 启用 RSA 认证

   PubkeyAuthentication yes # 启用公钥认证

   PasswordAuthentication no # 禁止密码认证,默认是打开的

   ServerKeyBits 1024 # 修改后变为此状态,将ServerKey强度改为1024比特

   PermitEmptyPasswords no # 修改后变为此状态,禁止空密码进行登录

    修改完成之后,重启SSH服务:

  sudo /etc/init.d/ssh restart

3    client端创建管理员账户并安装SSH,生成认证SSH钥匙对。

sudo useradd -m gitadmin
sudo passwd gitadmin
su gitadmin
cd ~
sudo yum install ssh     #配置完git管理员账户并安装完SSH之后,需要生成管理员gitadmin的SSH钥匙对。
ssh-keygen -t rsa #注意配置账户的权限,使其对当前目录具有读写权限。安装过程直接敲写回车即可。

默认的安装生成的SSH公钥,存在宿主目录/home/gitadmin/.ssh/下面,其中id_rsa.pub作为公钥,留做备用。开发者账户gituser同样操作。建议将相应公钥重命名,以免弄混。

sudo cp.ssh/id_rsa.pub ~/temp/
sudo mv ~/temp/id_rsa.pub gitadmin.pub

4   server 端安装gitosis

gitosis是管理git服务器的工具,相比手动管理,使用起来更加方便。

su git
cd ~
mkdir gitosis_setup
cd gitosis_setup
git clone https://github.com/res0nat0r/gitosis.git
cd gitosis
sudo python setup.py install      #安装gitosis的过程需要使用python工具包,如果安装失败,需要安装python-setuptools
sudo apt-get install python-setuptools

5   server端配置并运行gitosis

  5.1将第3步中的client端的管理员gitadmin的公钥拷贝或者上传到server端。

  5.2初始化gitosis,初始的过程中需要添加一个管理员。

假设gitadmin的公钥位于宿主目录~中。

su git
cd ~
sudo chmod 777 gitadmin.pub
sudo -H -u git gitosis-init < gitadmin.git    #初始化gitosis

此时,会在/home/git目录下生成一个空仓库repositories/gitosis-admin.git,次仓库的目的是管理员gitadmin用来管理git server的,不是托管项目的git。相应的配置文件位于repositories/gitosis-admin.git/gitosis.conf。

同时,如果想要别人能够clone gitosis-admin.git ,需要执行一下操作:

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

6     server端安装并配置gitweb(需要安装apache2)

  6.1安装gitweb

sudo apt-get install gitweb apache2
sudo a2enmod rewrite   #允许rewrite模块,需要用到。

  这里,我们由于有了一个管理员的空仓库,所以以此作为例子。将/home/git/repositories作为server端项目托管根目录。编辑配置文件

/etc/gitweb.conf
sudo vim /etc/gitweb.conf

  然后修改为如下形式:

$projectroot = "/home/git/repositories";
$git_temp = "/tmp";
#$home_link = $my_uri || "/";
$home_text = "indextext.html";
$projects_list = $projectroot;
$stylesheet = "/gitweb.css";
$logo = "/git-logo.png";
$favicon = "/git-favicon.png";
# enable human readable URLs
$feature{‘pathinfo‘}{‘default‘} = [1];

  6.2然后,配置apache2,创建一下新的虚拟host文件gitweb。

  sudo vim /etc/apache2/sites-available/gitweb

  将创建的gitweb文件内容修改为:

<VirtualHost *>
ServerName git.mydomain.com
ServerAlias git

DocumentRoot /home/git/repositories
SetEnv GITWEB_CONFIG /etc/gitweb.conf

RewriteEngine on
RewriteRule ^/$ /gitweb [PT]
RewriteRule ^/(.*\.git/(?!/?(HEAD|info|objects|refs)).*)?$ /gitweb%{REQUEST_URI} [L,PT]

# Aliases
ScriptAlias /gitweb /usr/lib/cgi-bin/gitweb.cgi
Alias /gitweb.css /usr/share/gitweb/gitweb.css
Alias /git-logo.png /usr/share/gitweb/git-logo.png
Alias /git-favicon.png /usr/share/gitweb/git-favicon.png

# Logfiles
ErrorLog /var/log/apache2/gitweb.error.log
CustomLog /var/log/apache2/gitweb.access.log combined
</VirtualHost>
  sudo a2ensite gitweb         #使其生效。

  上述配置文件中开了RewriteEngine on,需要配置一下apache2。修改/etc/apache2/httpd.conf文件。添加

  LoadModule rewrite module /usr/lib/apache2/modules/mod rewrite.so

  然后,保存后,从其apache2的服务。

  /etc/init.d/apache2 restart

7    client端管理员gitadmin管理gitosis,以上述仓库为例。

  7.1 首先,管理员从git服务器上clone下生成的目标仓库。

su gitadmin
cd ~
mkdir gitproject
cd gitproject
git clone [email protected]:gitosis-admin.git   #此处是同一局域网内的两台机器,直接输入server端的ip地址即可。主目录前面已经设为repositories/
cd gitosis-admin/
ls -al
总用量 24
drwxr-xr-x 5 sshtest sshtest 4096  3月 30 00:51 .
drwxrwxr-x 3 sshtest sshtest 4096  3月 30 00:04 ..
drwxrwxr-x 8 sshtest sshtest 4096  3月 30 00:53 .git
-rw-rw-r-- 1 sshtest sshtest  205  3月 30 00:51 gitosis.conf
drwxrwxr-x 2 sshtest sshtest 4096  3月 30 00:51 keydir

可以看到,目录实际上也是一个git项目,这正式gitosis的有意思的地方,利用git管理git服务器。除了.git以外,里面文件有一个配置文件conf,一个目录keydir。

gitosis.conf正是管理员配置git服务器的配置文件,用于配置用户和权限。keydir目录存放的是所有组成员user的公钥。打开配置文件conf

vim gitosis.conf
[gitosis]
[group gitosis-admin]
writable = gitosis-admin
members = [email protected]

  可见此时,git服务器上只有一个管理员[email protected]。其拥有读写权限。

  7.2 管理员修改配置文件

这一步,跟大多数的git的管理是一样的,管理员修改完之后,commit,然后push到服务器端。这里新建一个新项目仓库为例。

vim gitosis.conf
[gitosis]
gitweb=yes
[group gitosis-admin]
writable = gitosis-admin
members = [email protected]
[group apps]
writable=apps
[email protected] [email protected]

这里,gitweb=yes启用对gitweb的支持。group apps定义了一个新的空仓库apps,同时授予了gitadmin以及user两个用户读写权限。注意,此时user的公钥由于没有添加,所以无法连接服务器。修改完保存之后,管理员gitadmin执行:

git commit -am "created a new apps repo"
git push

push到服务端之后,立即生效。

  7.3 添加其他成员的公钥

su gitadmin
cd ~/gitproject/gitosis-admin/
sudo cp user.pub key keydir/
git add keydir/usr.pub
git commit -am "granted a new user rights to apps"
git push

  7.4 client端user连接gitserver

su user
cd ~/gitproject
git remote add origin [email protected]_SERVER:apps.git    #建立映射关系,或者直接如下,clone自动建立master的映射关系
git clone [email protected]_SERVER:apps.git  #之后就可以进行正常的git操作。最后push到服务器
git push origin master:refs/heads/master

  搞定,现在,确保基本服务都开启之后,在server端打开 http://localhost/cgi-bin/gitweb.cgi,client端打开相应的http://servername/cgi-bin/gitweb.cgi。看看效果吧:

8 参考阅读
http://wiki.ubuntu.org.cn/index.php?title=Git%E6%9C%8D%E5%8A%A1%E5%99%A8Gitosis%E5%AE%89%E8%A3%85%E8%AE%BE%E7%BD%AE&variant=zh-hans
http://serverfault.com/questions/72732/how-to-set-up-gitweb
http://blog.csdn.net/wirror800/article/details/5189564

时间: 2024-10-26 19:37:16

debian下使用gitosis+gitweb搭建SSH认证的git服务器的相关文章

搭建通过 ssh 访问的 Git 服务器

一.Git - 协议 Git 可以使用四种主要的协议来传输数据:本地传输,ssh 协议,Git 协议和 HTTP 协议. Git 使用的传输协议中最常见的就是 ssh 了.大多数环境已经支持通过 ssh 对服务器的访问 ,ssh 也是唯一一个同时支持读写操作的网络协议.另外两个网络协议(HTTP 和 Git)通常都是只读的.ssh 同时也是一个验证授权的网络协议:而因为其普遍性,一般架设和使用都很容易. 本文主要介绍如何搭建 ssh 协议的 Git 服务器. 二.在服务器上部署 Git 首先,你

Debian下自动备份文件并上传到远程FTP服务器且删除指定日期前的备份Shell脚本

说明:  1.备份目录/home/osyunwei下面所有的文件到/home/osyunweibak里面,并且保存为osyunwei20120701.tar.gz的压缩文件格式(2012_07_01是指备份执行时当天的日期),最后只保留最近7天的备份 2.上传/home/osyunweibak里面的备份文件到远程FTP服务器上,并且只保留最近7天的备份. 3.FTP服务器:192.168.21.139 端口:21 账号:osyunwei 密码:123456 osyunweibak为备份文件存放目

Linux下基于HTTP协议带用户认证的GIT开发环境设置

Git 的访问可以采用 HTTP 或 SSH 协议安全的访问,通常我们使用 gitlib 进行 Web 管理,但是在 Linux 命令行开发环境下,基本都是使用 SSH 协议,只需要在 gitlib 里面配置好相应的 SSH Key 就可以. 由于现在开发环境的特殊情况,我们需要在 Linux 命令行开发环境下,不能使用 SSH 方式,而只能使用 HTTP 协议进行安全访问,并且需要对开发者进行认证,并且开发者在本地开发环境中的用户名和密码需要加密存储. 接下来我就简单介绍我们的开发团队是如何在

搭建属于自己的GIT服务器——pingg

1.下载并安装jdk. 下载地址:https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html 点击Accept,根据PC配置下载32位或64位的jdk 2.配置Java环境变量 右键” 计算机” => ”属性” => ”高级系统设置” => ”高级” => “环境变量” => “系统变量”. 新建:变量名:JAVA_HOME:变量值:C:\Program Files\

centos 下git服务器搭建

准备 CentOS Linux release 7.0.1406 (Core) ssh 22端口 http 80端口 本文主要是ssh协议支持,http协议配置后还有问题. 摘抄的一段说明 SSH 协议 架设 Git 服务器时常用 SSH 协议作为传输协议. 因为大多数环境下已经支持通过 SSH 访问 —— 即时没有也比较很容易架设. SSH 协议也是一个验证授权的网络协议:并且,因为其普遍性,架设和使用都很容易. 通过 SSH 协议克隆版本库,你可以指定一个 ssh:// 的 URL: $ g

在CentOS搭建Git服务器 转

在CentOS搭建Git服务器 来自 :http://www.jianshu.com/p/69ea5ded3ede 前言 我们可以GitHub发布一些开源代码的公共仓库,但对于私密仓库就需要收费了.公司内部通常会搭建自己的Git服务器,我也通过在自己的服务器上搭建练习一下. 开始前先说一下服务器信息,这里是阿里云的CentOS 6.5 64位操作系统. 一 确认服务器是否安装Git [[email protected] git]# rpm -qa gitgit-1.7.1-3.el6_4.1.x

mac搭建git服务器

http://blog.csdn.net/kesalin/article/details/6943770 XCode 4 默认支持 Git 作为代码仓库,当我们新建一个仓库的时候,可以勾选创建默认仓库,只不过这个仓库是在本地的.本文介绍如何在 mac 机器上创建 Git 服务器,总体思路是:使用 gitosis 来简化创建过程,在用作服务器的机器上创建一个名为 git 的账户来创建 git 服务器,其他客户端通过 ssh 机制访问 git 服务器. 本文文档:点此下载 一,创建 git 账户1,

CentOS 6.4 搭建git 服务器

CentOS 6.4 搭建git 服务器 (2013-11-22 19:04:09)转载▼ 标签: it 分类: Linux 此文件是依据markdown所编写,更好效果参见本人github的文档https://github.com/jackliu2013/recipes/blob/master/doc/linux/CentOS_6.4_git服务器搭建.md ##CentOS安装Git服务器 Centos 6.4 + Git 1.8.2.2 + gitosis## 1.查看Linux系统服务器

本地Git服务器的搭建及使用

本地Git服务器的搭建及使用 Git本地服务器环境搭建 搭建好的本地git服务器的局域网ip是192.168.1.188,用户名是RSCSVN 教程链接:http://blog.csdn.net/ccf0703/article/details/7578276 安装git(git下载地址:https://git-scm.com/downloads) 配置git的系统环境变量(或 使用gitBash)以执行git命令 生成用户密钥(参照以上教程链接) Git客户端环境搭建 安装git(推荐[tort