Git 主要透過四種協議傳輸資料:本機傳輸、SSH 協議、Git 協議與 HTTP 協議。其中最常見的莫過於 SSH——大多數環境都已支援對伺服器的 SSH 存取,而且它是少數同時支援讀寫操作的網路協議(HTTP 與 Git 協議通常為唯讀)。此外,SSH 本身具備驗證與授權機制,加上其普及性,架設與使用都相對容易。本文就來說明如何搭建一個以 SSH 為基礎的 Git 伺服器。
首先,你需要一台具備 sudo 權限的 Linux 機器(本文以 Debian 7.0 x32 為例)。接著開始安裝。
$ sudo apt-get install git
建立一個專門用來運行 Git 服務的帳號:
$ sudo adduser git
讓團隊成員都能存取的作法有幾種:
~/.ssh/authorized_keys,此後所有人都透過 git 帳號存取主機。本文採用第二種方法:收集所有需要登入此 Git 伺服器的使用者公鑰(即各自的 id_rsa.pub),全部匯入 /home/git/.ssh/authorized_keys,每行一把。(注意:該檔案的 owner 應為 git,若不符請以 chown 命令修正。)
產生公鑰的命令如下:
$ ssh-keygen -t rsa -C 'your email@domain.com'
其中 -t 指定金鑰類型,預設即為 rsa,可省略;-C 則用來設定註解文字,例如你的電子郵件。更詳細的說明可參考 GitHub 的官方指南。
基於安全考量,可用 Git 自帶的 git-shell 工具來限制 git 使用者的活動範圍。做法是編輯 /etc/passwd,找到類似下面這一行:
git:x:1003:1003:,,,:/home/git:/bin/bash
把 /bin/bash 改為 /usr/bin/git-shell(可用 which git-shell 查詢實際路徑):
git:x:1003:1003:,,,:/home/git:/usr/bin/git-shell
如此一來,git 使用者只能透過 SSH 進行推送與抓取,而無法直接取得伺服器的 shell。若嘗試一般 SSH 登入,將會被拒絕。
選定一個目錄作為 Git 倉庫,例如 /home/git/project.git。在 /home/git/ 目錄下執行:
$ sudo git init --bare project.git
Git 會建立一個「裸倉庫」——它沒有工作區,因為伺服器上的倉庫是供共享之用,不讓使用者直接登入去改動工作區;這類倉庫通常以 .git 結尾。接著把 project.git 的 owner 改為 git:
$ sudo chown -R git:git project.git
為了方便管理 SSH 連線,可在本機為伺服器設定別名。編輯 ~/.ssh/config(若無此檔請自行建立):
$ vi ~/.ssh/config
在其中加入以下設定:
# 註解說明
Host 別名
HostName 網域或 IP
User 登入伺服器用的帳號
Port 連接埠(預設 22,若伺服器改了 SSH 埠請一併修改)
IdentityFile 金鑰檔案的位置
例如設定為:
# bingdian's git server
Host gitserver
HostName 162.188.23.33
User git
Port 9000
IdentityFile ~/.ssh/server_rsa
完成後,就能用 clone 命令拉取遠端倉庫了:
$ git clone ssh://git@gitserver:/home/git/project.git
接下來,就盡情享受你的 Git 之旅吧。