如何搭建一个自己的repo服务器？

搭建一个 Git 仓库服务器（通常称为 Git Repo 服务器）是软件开发团队进行版本控制和协作的重要步骤，本文将详细介绍如何从零开始搭建一个 Git Repo 服务器，包括环境准备、安装配置、权限设置以及常见问题解答。

环境准备

在搭建 Git Repo 服务器之前，需要确保以下几点：

操作系统: 大多数情况下，Linux 系统是首选，如 Ubuntu、CentOS 等，本文以 Ubuntu 为例。

域名和 IP 地址: 用于访问 Git Repo 服务器的域名或 IP 地址。

SSH 密钥: 用于安全地访问服务器。

安装必要的软件

在 Ubuntu 上，首先需要更新系统并安装必要的软件包：

sudo apt update
sudo apt install -y git openssh-server

启动并启用 SSH 服务：

sudo systemctl start ssh
sudo systemctl enable ssh

配置 SSH

为了安全起见，建议使用 SSH 密钥进行身份验证，在本地生成 SSH 密钥对：

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

将生成的公钥 (~/.ssh/id_rsa.pub) 复制到服务器上的~/.ssh/authorized_keys 文件中：

ssh-copy-id user@your_git_repo_server_ip

创建 Git 用户和组

为了更好的权限管理，可以创建一个专门的 Git 用户和组：

sudo addgroup git
sudo adduser --system --group --shell /bin/bash --gecos 'Git Version Control' --disabled-password --home /home/git git

初始化 Git 仓库

切换到git 用户，然后创建一个新的仓库目录并初始化：

su git
mkdir -p /home/git/repositories/myproject.git
cd /home/git/repositories/myproject.git
git init --bare

配置 Git 仓库权限

为了确保只有授权用户可以访问该仓库，需要配置适当的权限：

chown -R git:git /home/git/repositories/myproject.git
chmod -R 755 /home/git/repositories/myproject.git
find /home/git/repositories/myproject.git -type d -exec chmod 750 {} ;

7. 配置 Post-Receive 钩子（可选）

如果需要在推送代码后自动执行某些操作（例如构建项目），可以配置 Post-Receive 钩子：

cd /home/git/repositories/myproject.git/hooks
cat > post-receive << 'EOF'
#!/bin/sh
Your post-receive hook script here
EOF
chmod +x post-receive

克隆和推送代码

可以在本地机器上克隆这个远程仓库并进行推送操作：

git clone ssh://git@your_git_repo_server_ip/home/git/repositories/myproject.git
cd myproject
echo "Hello, World!" > testfile.txt
git add .
git commit -m "Initial commit"
git push origin master

配置 Web 访问（可选）

如果希望可以通过 Web 界面访问和管理 Git 仓库，可以使用工具如 Gitolite 或 Gitea，这里以 Gitolite 为例：

安装 Gitolite

sudo apt install -y perl libapache2-mod-php libaprutil1-dbd-sqlite3 libaprutil1-ldap
curl -LO http://www.github.com/sitaramc/gitolite/downloader
perl downloader --fast
sudo -H -u git /usr/local/share/gitolite/src/gl-system-install --prefix=/usr/local --mandir=/usr/share/man --enable='adnldap,hooks,resinspector'

配置 Gitolite

按照提示完成 Gitolite 的配置，包括管理员邮箱和密码等。

配置 Apache

编辑 Apache 配置文件以启用 Gitolite：

sudo nano /etc/apache2/sites-available/default

添加以下内容：

SetEnv GITOLITE_HTTP_HOME /usr/local/share/gitolite/src/htdocs
Alias /git /usr/local/share/gitolite/src/htdocs
<Directory "/usr/local/share/gitolite/src/htdocs">
    Options +ExecCGI +Includes
    AddHandler cgi-script .cgi .pl .py
    Require all granted
</Directory>

重启 Apache 服务：

sudo systemctl restart apache2

现在可以通过浏览器访问 Gitolite Web 界面，默认地址为http://your_git_repo_server_ip/git。

常见配置示例

配置项	说明	示例
post-receive 钩子	在推送代码后自动执行某些操作	#!/bin/sh ...
webhook	配置 Webhook 触发器	https://your_ci_server/webhook
branch protection	保护特定分支，防止被覆盖或删除	refs/heads/main
access control	控制不同用户对仓库的访问权限	read,write,admin
LFS (Large File Support)	支持大文件存储	git config --add core.lfs.contenttype application/vnd.git-lfs

FAQs

Q1: 如何在本地配置多个 SSH 密钥？

A1: 在本地机器上，可以通过以下步骤配置多个 SSH 密钥：

1、生成新的 SSH 密钥对：

   ssh-keygen -t rsa -b 4096 -C "another_email@example.com" -f ~/.ssh/id_rsa_another

2、将新的公钥添加到服务器的~/.ssh/authorized_keys 文件中：

   ssh-copy-id -i ~/.ssh/id_rsa_another.pub user@your_git_repo_server_ip

3、在~/.ssh/config 文件中添加配置，指定不同的主机使用不同的密钥：

   Host your_git_repo_server_alias
       HostName your_git_repo_server_ip
       User git
       IdentityFile ~/.ssh/id_rsa_another

Q2: 如何更改 Gitolite 管理员密码？

A2: 如果忘记了 Gitolite 管理员密码，可以通过以下步骤重置：

1、登录到服务器，切换到git 用户：

   su git

2、确保 Gitolite 已经安装并运行：

   gitolite setup --fast

3、根据提示输入新的管理员密码，完成后，Gitolite 将使用新的密码进行认证。

4、如果仍然无法登录，可以尝试重新安装 Gitolite，但请注意这可能会导致现有配置丢失。