本页内容

  • 先决条件
  • 安装 Nginx 及其他依赖项
  • 创建 Git 仓库
  • 配置 Nginx 以提供 Git 仓库服务
  • 从客户端连接到 Git 仓库
  • 结论

Git 是一个开源版本控制系统,被全球成千上万的开发者使用。它用于在源代码层面跟踪软件的变更。它允许你跟踪变更、将变更回退到之前的阶段,并创建文件和目录的替代版本。

HTTP Git Server 是一个开源项目,它使用 Nginx web 服务器通过你的局域网(LAN)提供 Git 仓库服务。它非常简单且易于设置。任何人都可以通过命令行界面管理它。

在本教程中,我将解释如何在 Debian 11 上使用 Nginx 搭建一个 HTTP Git 仓库服务器。

先决条件

  • 一台运行 Debian 11 的服务器。
  • 一个指向你服务器 IP 的有效域名。
  • 你的服务器上已配置 root 密码。

安装 Nginx 及其他依赖项

首先,你需要安装 Nginx web 服务器及其他必需的软件包,以搭建 HTTP Git 服务器。你可以使用以下命令安装所有这些软件包:

apt-get install nginx git fcgiwrap apache2-utils unzip -y

所有软件包安装完成后,你可以继续进行下一步。

创建 Git 仓库

接下来,你需要创建一个目录来存储 Git 仓库。让我们在 Nginx web 根目录中创建一个名为 myrepo 的目录:

mkdir /var/www/html/myrepo

接下来,将目录切换到 myrepo,并为用户创建另一个目录:

cd /var/www/html/myrepo
mkdir user1.git

接下来,进入用户目录,并使用以下命令初始化 Git 仓库:

cd user1.git
git --bare init

你将得到如下输出:

Initialized empty Git repository in /var/www/html/myrepo/user1.git/

接下来,使用以下命令更新 Git 服务器信息:

git update-server-info

接下来,使用以下命令更改 myrepo 的所有权并设置适当的权限:

chown -R www-data:www-data /var/www/html/myrepo
chmod -R 755 /var/www/html/myrepo

接下来,创建一个名为 user1 的用户并设置密码:

htpasswd -c /var/www/html/myrepo/htpasswd user1

你可以如下所示设置密码:

New password: 
Re-type new password: 
Adding password for user user1

你可以使用以下命令检查你的密码:

cat /var/www/html/myrepo/htpasswd

示例输出:

user1:$apr1$LoyCEkzA$Fjq5nBbLhBRdaxCQBBUQd1

配置 Nginx 以提供 Git 仓库服务

接下来,你需要创建一个 Nginx 虚拟主机配置文件,以提供 Git 仓库服务。

nano /etc/nginx/conf.d/git.conf

添加以下几行:

server {
        listen 80;

        root /var/www/html/myrepo;

        # Add index.php to the list if you are using PHP
        index index.html index.htm index.nginx-debian.html;

        server_name git.yourdomain.com;

        location / {
                # First attempt to serve request as file, then
                # as directory, then fall back to displaying a 404.
                try_files $uri $uri/ =404;
        }

location ~ (/.*) {
    client_max_body_size 0; 
    auth_basic "Git Login"; 
    auth_basic_user_file "/var/www/html/myrepo/htpasswd";
    include /etc/nginx/fastcgi_params; 
    fastcgi_param SCRIPT_FILENAME /usr/lib/git-core/git-http-backend; 
    fastcgi_param GIT_HTTP_EXPORT_ALL "";
    fastcgi_param GIT_PROJECT_ROOT /var/www/html/myrepo;
    fastcgi_param REMOTE_USER $remote_user;
    fastcgi_param PATH_INFO $1; 
    fastcgi_pass  unix:/var/run/fcgiwrap.socket;
}

}

完成后保存并关闭文件,然后检查 Nginx 是否存在语法错误:

nginx -t

你将得到如下输出:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

最后,重启 Nginx 服务以应用更改:

systemctl restart nginx

你还可以使用以下命令检查 Nginx 状态:

systemctl status nginx

你将得到如下输出:

? nginx.service - A high performance web server and a reverse proxy server
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Sat 2021-12-11 08:00:04 UTC; 2s ago
       Docs: man:nginx(8)
    Process: 144985 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 144986 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 144987 (nginx)
      Tasks: 2 (limit: 2341)
     Memory: 2.5M
        CPU: 42ms
     CGroup: /system.slice/nginx.service
             ??144987 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
             ??144988 nginx: worker process

Dec 11 08:00:04 debian11 systemd[1]: Starting A high performance web server and a reverse proxy server...
Dec 11 08:00:04 debian11 systemd[1]: nginx.service: Failed to parse PID from file /run/nginx.pid: Invalid argument
Dec 11 08:00:04 debian11 systemd[1]: Started A high performance web server and a reverse proxy server.

从客户端连接到 Git 仓库

此时,Git HTTP 服务器已通过 Nginx 搭建完成。现在,是时候从客户端机器连接它并进行测试了。

首先,使用以下命令在客户端机器上安装 Git 软件包:

apt-get install git -y

接下来,使用以下命令为你的项目创建一个目录:

mkdir project

接下来,进入你的项目目录,并使用下面的命令初始化 Git:

cd project
git init

接下来,使用你的电子邮件和用户名配置 Git:

git config --global user.email "
[email protected]
"
git config --global user.name "user1"

接下来,使用以下命令添加你的 Git HTTP 服务器:

git remote add origin http://
[email protected]
/user1.git

接下来,创建一个名为 dev01 的目录,并在其中添加一个文件:

mkdir dev01
echo "This is my first application" > dev01/file1

接下来,将你创建的目录和文件添加到 Git 仓库中:

git add .

接下来,使用以下命令提交更改:

git commit -a -m "Add files and directories"

你将得到如下输出:

[master (root-commit) 0299d83] Add files and directories
 1 file changed, 1 insertion(+)
 create mode 100644 dev01/file1

接下来,使用以下命令将你的文件和目录上传到 HTTP Git 服务器:

git push origin master

系统将要求你提供密码以访问 Git 服务器:

Password for 'http://
[email protected]
': 

连接成功后,你将得到如下输出:

Counting objects: 4, done.
Writing objects: 100% (4/4), 281 bytes | 281.00 KiB/s, done.
Total 4 (delta 0), reused 0 (delta 0)
To http://git.yourdomain.com/user1.git
 * [new branch]      master -> master

你还可以使用以下命令直接从 Git 服务器下载你的仓库:

git clone http://
[email protected]
/user1.git

你将得到如下输出:

Cloning into 'user1'...
Password for 'http://
[email protected]
': 
remote: Enumerating objects: 4, done.
remote: Counting objects: 100% (4/4), done.
remote: Total 4 (delta 0), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (4/4), done.

结论

在上面的指南中,你学习了如何在 Debian 11 上使用 Nginx 搭建 HTTP Git 服务器。现在,你可以将这套配置应用到你的本地开发环境中,并使用命令行管理和跟踪你的项目。