硬體需求：Ubuntu電腦（或虛擬機器），正常網路訪問。

         軟體需求：git-core,gitosis, openssh-server, git-daemon-run（ubuntu），msysgit（windows）

Step1. 安裝配置Git伺服器(IP:10.203.138.101)

         安裝Git和openssh。

         $ sudo apt-get install git-core openssh-server

新建使用者git，該使用者作為所有程式碼倉庫和使用者許可權的管理者。

         $ sudo groupadd git

         $ sudo useradd git –g git –m

         $ sudo passwd git （需要設定使用者git的密碼）

Step2. 安裝gitosis

         初始化伺服器的全域性設定，為安裝gitosis做準備。在任何一臺機器上使用git，第一次必須要先設定user.name和user.email。

         $ git config --global user.name “david”

         $ git config --global user.email “[email protected]”（name和email隨意）

         安裝一下python的setup tool。

         $ sudo apt-get install python-setuptools

         獲取gitosis包。

         $ git clone https://github.com/res0nat0r/gitosis.git（或者到網上下載對應的gitosis）

         $ cd gitosis

         $ sudo python setup.py install

Step3. 配置gitosis

         在git管理員的PC上，先安裝msysgit（windows系統），安裝後，開啟gitbash，執行如下命令生成管理員金鑰：

         $ ssh-keygen –t rsa

執行以上命令後，可以預設提示直接回車。回車後在當前使用者目錄下生成了.ssh/id_rsa和.ssh/id_rsa.pub。其中.ssh/id_rsa是私玥，.ssh/id_rsa.pub是公鑰。接下來可以使用如下命令將git管理員的公鑰上傳到git伺服器，也可以直接拷貝到git伺服器。

         $ scp xxx/.ssh/id_rsa.pub [email protected]:/tmp/id_rsa.pub

回到Git伺服器上。

         $ sudo chmod a+r /tmp/id_rsa.pub

讓gitosis執行起來：

         $ sudo –H –u git gitosis-init </tmp/id_rsa.pub

Initialized empty Git repository in /home/repo/gitosis-admin.git/

Reinitialized existing Git repository in /home/repo/gitosis-admin.git/

Gitosis是通過一個git倉庫來管理配置檔案，倉庫放在/home/git/repositories/gitosis-admin.git。

         設定git倉庫許可權

         $ sudo chown git:git /home/git/repositories

         $ sudo chmod 755 /home/git/repositories

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

Step4. 在伺服器上新建測試專案倉庫

         在伺服器上新建一個空的專案倉庫可，叫“test”。

         切換到git使用者：

         $ su – git

         $ cd repositories

         $ git init --bare test.git

         $ exit

到這裡，test只是一個空倉庫，它是不能clone下來的。為了能做clone，必須先讓管理員或有許可權的人放一個初始化的版本到倉庫中。所以，我們必須先修改一個gitosis-admin。

Step5. 管理gitosis的配置檔案

         Gitosis本身的配置也是通過git來實現的。在剛剛上傳公鑰（伺服器端gitosis-init時使用了該公鑰）的機器上，把gitosis-admin.git這個倉庫clone下來，就可以以管理員的身份修改配置了。

         新建一個資料夾，如git101：

         $ mkdir git101

         $ cd git101

         $ git clone [email protected]:gitosis-admin.git（或使用全路徑）

         注：訪問git使用者倉庫的預設路徑是/home/git/repositories/

         $ cd gitosis-admin

該目錄下的keydir目錄是用來存放所有需要訪問git伺服器的使用者的ssh公鑰。各個使用者按照前面提到的辦法生成各自的ssh公鑰檔案後，把所有人的ssh公鑰檔案按名字重新命名一下，然後拷貝到keydir目錄下，然後修改gitosis.conf檔案，做相應的配置：

         [gitosis]

         [group gitosis-admin]

         writable = gitosis-admin

         members = [email protected]  [email protected]

         [group team]

         writable = test

         members = [email protected]  [email protected]  [email protected]

這個配置檔案表達瞭如下含有：gitosis-admin組成員有david，tom，該組對gitosis-admin倉庫有讀寫許可權；test組有david，tom，pitter三個成員，該組對test倉庫有讀寫許可權。目前這些配置檔案的修改只是在本地，必須推送到遠端的git伺服器上才能真正生效。

         加入新檔案、提交併push到Git伺服器：

         $ git add .

         $ git commit –m “add test and someusers”

         $ git push origin master

Step6. 初始化測試專案

         現在伺服器搭建完畢，並且有一個空的專案test在伺服器上。接下來，需要測試一下，空倉庫是不能clone的，所以需要某個有寫許可權的人初始化一個版本。在客戶端執行：

         $ mkdir test-ori

         $ cd test-ori

         $ git init （在客戶端執行，初始化一個本地的版本庫）

         $ echo “/* add something */” > hello.c

         $ git add .

         $ git commit –m “initial version”

         $ git remote add origin [email protected]:test.git

         $ git push origin master

到此為止，test已經有了一個版本了，team的其他成員只要先clone一下test倉庫就可以了，而且gitosis.conf中賦予的讀寫許可權。

Step7. 新增已有git專案

         如果想將一個現成的git倉庫，放到Git伺服器上供team使用（比如clone了一個官方的kernel倉庫，想在內部使用它作為基礎倉庫），可以這樣操作：

         首先需要從你的工作倉庫中得到一個純倉庫，比如你的工作目錄為~/kernel，你想將該純倉庫拷貝到Git伺服器上使用。Git伺服器的管理員拿到這個純倉庫（~/kernel）後，將其拷貝到/home/repo/下，同時配置gitosis相關配置檔案。比如說：下載ALSA庫。

         $ git clone git://android.git.kernel.org/platform/external/alsa-lib.git

         $ git clone git://android.git.kernel.org/platform/external/alsa-utils.git

生成bare庫：

         $ git clone --bare alsa-lib alsa-lib.git

         $ git clone --bare alsa-utils alsa-utils.git

將bare庫移動到Git伺服器目錄：

         $ cp alsa-lib.git /home/repo

         注意變更所有者，以獲取提交許可權。

         $ chown -R git alsa-lib.git

Step8. 安裝git-daemon

         如果想使用git協議，那麼就需要安裝git-daemon，它是git的一個守護程序（作為一個服務存在）。

         $ sudo apt-get install git-daemon-run

編輯git-daemon配置檔案：

         $ sudo gedit /etc/sv/git-daemon/run

         #!/bin/bash

         exec2>&1

         echo‘git-daemon starting.’

         execchpst -ugitdaemon

                   “$(git--exec-path)”/git-daemon --verbose --export-all--enable=receive-pack --enable=upload-pack --enable=upload-archive --reuseaddr --base-path=/home/webgod/      

         說明：

         --base-path      指向Git伺服器的根目錄

         --enable=receive-pack

         --enable=upload-pack

         --enable=upload-archive

         以上三個是與git-clone，git-push，git-pull相關的。檢視詳情使用命令：$ man git-daemon檢視。

         重啟git伺服器：

         $ sudo sv restart git-daemon

         在Git伺服器上：

         $ cd /home/webgod

         $ mkdir RepoServer

         $ cd RepoServer

         $ git init --bare manifest.git

切換到其他目錄：

         $ cd ~/test

         $ git clone git://127.0.0.1/RepoServer/manifest.git

($ git clone [email protected]:/home/webgod/RepoServer/manifest.git)

         這裡就實現了所謂的“匿名訪問”。

[說明]：

1. 如果其它新加入的成員無法clone一個git倉庫時，如出現如下錯誤提示：

ERROR: gitosis.serve.main:Repositoryread access denied 

原因是當前成員的key命名與在gitosis.conf中的members中的名字不一致！例如所用的key名是 lxq_rsa.pub，而在gitosis.conf中某一group下所用的名稱為 [email protected]

則只需要把lxq_rsa.pub重新命名為[email protected]並重新push到伺服器上即可！

2. 在克隆倉庫時如果出現如下錯誤提示：

fatal: ‘~/gitosis-admin.git’ does not appear to be a gitrepositories

fatal: The remote end hung up unexpectedly

試用 $ git clone [email protected]:/home/git/repositories/gitosis-admin.git

3.使用公鑰認證的方式登入。具體操作過程如下：

1) 在伺服器端(server)建立一個賬號（公共），例如anonymous；

2) 管理員收集需要訪問git服務的使用者公鑰，如user1.pub、user2.pub；

3) 使用ssh-copy-id命令將各個git使用者的公鑰遠端加入伺服器(server)的公鑰認證列表。

遠端操作，可以使用ssh-copy-id命令:

$ ssh-copy-id -I user1.pub [email protected]

$ ssh-copy-id -I user2.pub [email protected]

如果直接在服務區上操作，則直接將檔案追加到authorized_keys檔案中：

$ cat /path/to/user1.pub>> ~anonymous/.ssh/authorized_keys

$ cat/path/to/user2.pub >> ~anonymous/.ssh/authorized_keys