本页内容
- 先决条件
- 安装 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 服务器。现在,你可以将这套配置应用到你的本地开发环境中,并使用命令行管理和跟踪你的项目。