Git 服务器搭建

封面图 • 2025-09-29 • git

搭建 Git 服务器是一个常见的需求，尤其是在团队协作开发中。Git 本身是分布式版本控制系统，但如果你希望有一个集中式的 Git 仓库（例如公司内部的代码托管），你可以使用 **Git 服务器**。

下面我将详细介绍如何在 Linux 系统（以 Ubuntu 为例）上搭建一个简单的 Git 服务器。

---

## 🧰 一、准备工作

1. **安装 Git**
   ```bash
   sudo apt update
   sudo apt install git -y
   ```

2. **创建 Git 用户（可选）**
   如果你不想用 root 用户来管理 Git 服务，可以创建一个专门的用户：
   ```bash
   sudo adduser git
   ```

3. **设置 SSH 登录权限（可选）**
   如果你想通过 SSH 来访问 Git 服务器，确保 `git` 用户可以通过 SSH 登录。

---

## 🛠️ 二、创建 Git 仓库

### 方法一：本地 Git 仓库（适合单机测试）

```bash
mkdir /path/to/repo.git
cd /path/to/repo.git
git init --bare
```

- `--bare` 表示这是一个裸仓库，没有工作目录。
- 以后其他用户可以通过 `git clone git@your-server:/path/to/repo.git` 来克隆。

---

### 方法二：使用 Gitolite（更高级的 Git 服务器）

Gitolite 是一个基于 SSH 的 Git 服务器，支持用户权限管理。

#### 安装 Gitolite：

1. 在 `git` 用户下执行以下命令：
   ```bash
   su - git
   git clone https://github.com/sitaramc/gitolite.git
   cd gitolite
   ./gl-setup
   ```

2. 设置完成后，会生成 `.ssh/authorized_keys` 文件，用于 SSH 访问。

3. 配置用户权限（在 `/home/git/.gitolite/conf/gitolite.conf` 中添加项目和用户权限）。

4. 其他用户可以通过 SSH 连接到 Git 服务器，并推送/拉取代码。

---

## 🔐 三、SSH 访问配置（推荐）

为了安全，建议使用 SSH 而不是 HTTP 方式访问 Git 服务器。

### 步骤如下：

1. 在客户端生成 SSH 密钥对（如果还没有）：
   ```bash
   ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
   ```

2. 将公钥上传到 Git 服务器（假设你已登录到 Git 服务器）：
   ```bash
   cat ~/.ssh/id_rsa.pub | ssh git@your-git-server 'mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys'
   ```

3. 测试连接：
   ```bash
   ssh git@your-git-server
   ```

4. 推送代码：
   ```bash
   git remote add origin git@your-git-server:/path/to/repo.git
   git push -u origin master
   ```

---

## 📁 四、使用 HTTP 协议（可选）

如果你不想使用 SSH，也可以通过 HTTP 协议访问 Git 仓库。

### 使用 Apache 或 Nginx 配置 Git HTTP 服务

#### 示例：使用 Apache

1. 安装 Apache 和 Git：
   ```bash
   sudo apt install apache2 git -y
   ```

2. 创建 Git 仓库目录：
   ```bash
   sudo mkdir /var/www/html/repo.git
   sudo chown -R www-data:www-data /var/www/html/repo.git
   ```

3. 初始化裸仓库：
   ```bash
   sudo git init --bare /var/www/html/repo.git
   ```

4. 配置 Apache（编辑 `/etc/apache2/sites-available/git.conf`）：
   ```apache
   <VirtualHost *:80>
       ServerName your-git-server
       DocumentRoot /var/www/html

<Directory /var/www/html>
           Options Indexes FollowSymLinks
           AllowOverride None
           Require all granted
       </Directory>

SetEnv GIT_HTTP_EXPORT_ALL true
       SetEnv GIT_PROJECT_ROOT /var/www/html
       ScriptAlias /git/ /usr/lib/git-core/git-http-backend/
   </VirtualHost>
   ```

5. 启用站点并重启 Apache：
   ```bash
   sudo a2ensite git
   sudo systemctl restart apache2
   ```

6. 访问：
   ```
   http://your-git-server/git/repo.git
   ```

---

## ✅ 五、常见问题

| 问题 | 解决方法 |
|------|----------|
| 无法通过 SSH 连接 | 检查防火墙、SSH 配置、`~/.ssh/authorized_keys` |
| 权限不足 | 确保仓库目录权限为 `git:git` |
| 无法推送 | 检查仓库是否为裸仓库（`--bare`） |

---

## 📦 六、推荐工具（可选）

| 工具 | 功能 |
|------|------|
| [Gitea](https://gitea.io/) | 轻量级自托管 Git 服务 |
| [Gogs](https://gogs.io/) | 类似 Gitea，功能丰富 |
| [GitLab CE](https://about.gitlab.com/install/) | 功能强大的 Git 托管平台（社区版） |

---

## 📝 总结

| 步骤 | 内容 |
|------|------|
| 安装 Git | `sudo apt install git` |
| 创建裸仓库 | `git init --bare` |
| SSH 访问 | 配置 SSH 密钥 |
| HTTP 访问 | 配置 Apache/Nginx |
| 更高级方案 | Gitolite、Gitea、GitLab |

---

如果你有特定的环境（如 Windows、Mac、Docker 等），我可以为你提供相应的搭建指南。

需要我帮你写一个完整的脚本或配置文件吗？