在企业或团队内部,搭建一个私有的 Git 服务器是保障代码安全、实现自主可控的重要举措，相较于公共托管平台，私有 Git 能够提供更高的数据隐私性、更灵活的权限配置以及无限制的存储空间，本文将以稳定可靠的 CentOS 系统为例，详细介绍如何从零开始搭建一个基础的私有 Git 服务。
第一步：环境准备与基础安装
在开始之前,请确保您具备以下条件：
- 一台运行 CentOS 7 或更高版本的云服务器或物理服务器。
- 拥有
sudo权限的非 root 用户账户，以确保操作安全。
我们需要在服务器上安装 Git 软件，CentOS 的官方软件源中包含了 Git，我们可以通过 yum 命令轻松完成安装。
sudo yum update -y sudo yum install git -y
安装完成后,可以通过 git --version 命令验证是否成功，为了安全和管理方便，我们创建一个专门用于运行 Git 服务的系统用户，git。
sudo adduser git sudo passwd git # 为 git 用户设置一个强密码
第二步：创建裸仓库
Git 仓库分为两种：普通仓库和裸仓库，普通仓库包含我们日常看到的源代码文件和 .git 目录，而裸仓库只包含 .git 目录下的所有内容，没有工作区，它不用于直接编辑文件，而是作为中央仓库，供团队成员推送和拉取代码，非常适合用作服务器端。
我们选择一个合适的目录来存放所有的 Git 项目，/opt/git。
# 创建存放仓库的目录 sudo mkdir /opt/git # 初始化一个名为 my_project.git 的裸仓库 cd /opt/git sudo git init --bare my_project.git
执行完毕后,/opt/git/my_project.git 目录下会生成一系列文件和文件夹，最关键的一步是，我们需要将这个仓库的所有权转移给我们之前创建的 git 用户，确保该用户有完全的读写权限。
sudo chown -R git:git /opt/git
至此,服务器端的中央仓库已经准备就绪。
第三步：客户端连接与操作
团队成员需要从各自的客户端（开发机器）连接到这个私有 Git 服务器，连接方式主要采用 SSH 协议，它安全且配置简单。
生成 SSH 密钥
在客户端电脑上，检查是否已有 SSH 密钥，通常位于 ~/.ssh 目录下，如果没有，请执行以下命令生成：
ssh-keygen -t rsa -C "your_email@example.com"
按提示操作即可,这会在 ~/.ssh 目录下生成 id_rsa（私钥）和 id_rsa.pub（公钥）两个文件。
配置服务器公钥
为了允许客户端通过 SSH 访问，我们需要将客户端的公钥内容添加到服务器 git 用户的 authorized_keys 文件中。
在服务器上切换到 git 用户并创建必要的目录和文件：
sudo su - git mkdir -p ~/.ssh touch ~/.ssh/authorized_keys chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys
将客户端 id_rsa.pub 文件中的内容完整地复制并追加到服务器的 /home/git/.ssh/authorized_keys 文件中，每换一个用户，就新起一行添加其公钥。
克隆、提交与推送
配置完成后，客户端就可以像使用 GitHub 一样操作我们的私有 Git 服务器了。
# 克隆仓库（请将 your_server_ip 替换为你的服务器IP地址） git clone git@your_server_ip:/opt/git/my_project.git # 进入项目目录 cd my_project # 创建一个文件并提交 echo "# My Private Project" > README.md git add . git commit -m "Initial commit" # 推送到服务器 git push origin main
如果一切顺利,代码就已经成功推送到我们搭建的私有服务器上了。
进阶管理：多用户与权限控制
上述方法适用于小型且高度信任的团队,随着团队规模扩大，对权限进行精细化控制变得至关重要，原生的 SSH 方式无法实现分支级别的读写权限管理，可以考虑引入以下工具：
| 工具名称 | 主要特点 | 适用场景 |
|---|---|---|
| Gitolite | 基于 SSH，提供强大的、基于配置文件的权限管理，可控制到分支和标签级别。 | 中大型团队，需要对仓库和分支进行精细化权限控制，且偏好命令行管理。 |
| Gitea | 一个轻量级的、类似 GitHub 的 Web 服务，提供 Web 界面、Issue、Pull Request 等功能。 | 需要可视化操作界面、团队协作功能，希望拥有类 GitHub 体验的团队。 |
通过部署 Gitolite 或 Gitea，可以将您的私有 Git 服务提升到一个新的水平，实现更专业、更便捷的代码托管。
相关问答FAQs
问1：我按照步骤操作，但在克隆时总是提示权限被拒绝（Permission denied），该怎么办？
答： 这是一个常见的 SSH 连接问题，请按以下顺序排查：
- 公钥是否正确添加： 确认客户端的
id_rsa.pub内容已完整无误地追加到服务器/home/git/.ssh/authorized_keys文件中，且没有多余的空格或换行。 - 文件和目录权限： 检查服务器上
~git/.ssh目录权限必须是700，~git/.ssh/authorized_keys文件权限必须是600，所有者必须是git用户，权限过宽会导致 SSH 安全机制拒绝连接。 - SELinux 状态： 检查服务器的 SELinux 是否处于
Enforcing模式，如果是，可以尝试临时设置为Permissive模式（sudo setenforce 0）来测试是否是 SELinux 导致的问题，如果是，则需要配置 SELinux 策略允许git用户访问authorized_keys。
问2：如何实现让某个用户只能读取（clone）代码，而不能推送（push）代码？
答： 使用本文介绍的“原生SSH + 裸仓库”方法无法实现这种精细化的读写分离，因为一旦用户的公钥被加入 authorized_keys，他就拥有了通过 git 用户 SSH 登录的完整权限，可以对仓库进行所有操作，要实现“只读”或更复杂的权限控制（如指定分支的读写权限），必须借助权限管理工具，如上文提到的 Gitolite 或 Gitea，这些工具通过在 Git 操作的钩子中加入权限判断逻辑，能够根据配置文件精确控制每个用户对每个仓库甚至每个分支的具体操作权限。
【版权声明】：本站所有内容均来自网络，若无意侵犯到您的权利，请及时与我们联系将尽快删除相关内容!
发表回复