Git 服务器搭建完全指南
Git 服务器搭建完全指南
从零开始，系统性地搭建和运维企业级 Git 服务。
适用读者
| 角色 | 需求 |
|---|---|
| 个人开发者 | 搭建私有 Git 仓库，替代 GitHub 付费方案 |
| 小团队（5-30 人） | 需要代码托管、Code Review、CI/CD 能力 |
| 中大型企业 | 需要 LDAP/SSO、高可用、审计合规 |
| DevOps 工程师 | 需要自动化部署、镜像同步、多环境管理 |
技术选型速查
| 方案 | 复杂度 | 功能丰富度 | 适用规模 | 协议支持 |
|---|---|---|---|---|
| 裸仓库 + SSH | ★☆☆☆☆ | 基础 | 1-5 人 | SSH |
| Gitolite | ★★☆☆☆ | 中等 | 5-50 人 | SSH |
| Gitea | ★★★☆☆ | 丰富 | 5-500 人 | SSH/HTTP |
| Forgejo | ★★★☆☆ | 丰富 | 5-500 人 | SSH/HTTP |
| GitLab CE | ★★★★★ | 完整 | 10-5000+ 人 | SSH/HTTP |
章节目录
第一部分：基础篇
- 第 1 章 - Git 服务器概述 — 服务器选项、裸仓库、SSH/HTTP 协议、适用场景
- 第 2 章 - SSH 基础方案 — 裸仓库搭建、用户管理、权限控制
- 第 3 章 - Gitolite 权限管理 — Gitolite 安装、配置、权限管理、钩子
第二部分：平台篇
- 第 4 章 - Gitea 轻量平台 — Gitea 安装、配置、功能、迁移、CI 集成
- 第 5 章 - Forgejo 社区分支 — Forgejo 安装、配置、与 Gitea 对比、Actions
- 第 6 章 - GitLab CE 企业方案 — GitLab CE 安装、Docker、配置、Runner、CI/CD
第三部分：进阶篇
- 第 7 章 - 多项目管理 — 组织、团队、权限继承、层级项目结构
- 第 8 章 - 服务端钩子 — pre-receive、post-receive、自动化工作流
- 第 9 章 - 镜像与备份 — 镜像同步、推送到 GitHub/GitLab、备份策略
第四部分：自动化篇
- 第 10 章 - CI/CD 集成 — Gitea Actions、Jenkins、自动化流水线
- 第 11 章 - 认证集成 — LDAP、SSO、SAML、OAuth2 认证
第五部分：运维篇
- 第 12 章 - 仓库迁移 — 迁移策略、从 GitHub 迁移、历史清理、LFS
- 第 13 章 - Docker 部署 — Docker、Compose、反向代理、SSL 配置
- 第 14 章 - 故障排除 — SSH 问题、权限问题、性能问题
- 第 15 章 - 最佳实践 — 运维规范、备份策略、安全加固、团队协作
环境要求
本教程默认环境：
| 项目 | 版本/规格 |
|---|---|
| 操作系统 | Ubuntu 22.04 LTS / Debian 12 |
| CPU | 2 核以上 |
| 内存 | 4 GB 以上（GitLab 建议 8 GB+） |
| 磁盘 | 50 GB 以上 |
| 网络 | 公网 IP 或内网可达 |
| 域名 | 可选（用于 HTTPS 访问） |
阅读建议
- 快速上手（30 分钟）：阅读第 1、2 章，搭建最基础的 Git 服务
- 团队使用（2 小时）：阅读第 1-4 章 + 第 13 章，搭建 Gitea 并容器化部署
- 企业落地（1 天）：通读全部章节，按需选型和配置