前言
最近一直在写 django 网页的代码,随着代码的量越来越大,管理起来也有点复杂(当然,有在使用 git 进行代码管理)。同时由于有不同的工作环境,有些工作环境对 ssh 的访问有限制,所以想到了在自己的服务器上面搭建 http 协议的 git 仓库。在这里记录一下搭建的过程以及期间遇到的问题和解决方案,以便有需要可以取用。
环境的安装
往下走之前,事先说明一下我的 linux 环境。
我的所有搭建都是建立在树莓派系统Raspbian之上,其他的环境均是根据 apache 的 conf 文件配置 说明所写。
作为主角 git 自然是不能缺少。
sudo apt-get install git
其次是搭建 http 要用到的 apache2。
sudo apt-get install apache2 apache2-utils
apache 配置
启用 apache 模块
配置 apache2.conf
(httpd.conf
) 文件之前需要先启用 mod_cgi, mod_alias,mod_env 等 Apache 模块。
a2enmod cgi alias env
配置 apache2.conf
接下来是配置 apache2.conf
(httpd.conf
),根据 linux 系统的版本有区别。
因为我用的是树莓派,所以配置路径在 /etc/apache2/apache2.conf
。
配置的模板:
SetEnv GIT_PROJECT_ROOT (存放 git 库的文件夹)
SetEnv GIT_HTTP_EXPORT_ALL
ScriptAlias /git/ (git 请求处理器的路径)
<Directory "/usr/lib/git-core*">
Options ExecCGI Indexes
Order allow,deny
Allow from all
Require all granted
</Directory>
<LocationMatch "^/git/.*/git-receive-pack$">
AuthType Basic
AuthName "Git Access"
AuthUserFile (授权文件)
Require valid-user
</LocationMatch>
需要添加到配置文件的配置例子:
参考:progit.pdf
SetEnv GIT_PROJECT_ROOT /opt/git
SetEnv GIT_HTTP_EXPORT_ALL
ScriptAlias /git/ /usr/lib/git-core/git-http-backend/
<Directory "/usr/lib/git-core*">
Options ExecCGI Indexes
Order allow,deny
Allow from all
Require all granted
</Directory>
<LocationMatch "^/git/.*/git-receive-pack$">
AuthType Basic
AuthName "Git Access"
AuthUserFile /opt/git/.htpasswd
Require valid-user
</LocationMatch>
经过如此配置,已经可以实现 git clone
和 git pull
这里操作。
配置完成之后,重启 apache2 即可。
service apache2 restart
在远程的计算机上便可以通过 http 的方式 clone 创建在这台服务器上的 git 仓库了。
git clone http://yourip:port/git/yourproject.git
遇到的问题和解决方法
收到原有搭建的网站影响而不能下载。
a. 由于我在服务器上搭建了 django 网页,django 网页的过滤器可能会受到/git/
的影响,所以要在 django 中对该 url 不进行处理。
b. 还有一种方法是建立虚拟机映射到其他端口。
这个方法需要将添加的文件囊括在<VirtualHost *:port></VirtualHost>
中,如下<VirtualHost *:8000> SetEnv GIT_PROJECT_ROOT /opt/git SetEnv GIT_HTTP_EXPORT_ALL ScriptAlias /git/ /usr/lib/git-core/git-http-backend/ <Directory "/usr/lib/git-core*"> Options ExecCGI Indexes Order allow,deny Allow from all Require all granted </Directory> <LocationMatch "^/git/.*/git-receive-pack$"> AuthType Basic AuthName "Git Access" AuthUserFile /opt/git/.htpasswd Require valid-user </LocationMatch> </VirtualHost>
同时要在
port.conf
(httpd.conf
) 中加入虚拟机映射的端口的监听:Listen 8000
有可能会遇到这样的问题,发现你想要上传代码的时候报错
E:\Codes\Git\MyWeb>git push fatal: unable to access 'http://hello.vip/git/MyWeb.git/': The requested URL returned error: 403
这个有可能是因为服务器的 git 库没有更改
http.receivepack
配置,进入你要配置的 git 仓库sudo git config http.receivepack true
,然后再试着上传代码就可以了!
结尾
其实在 github,gitee 上直接建立 git 仓库是最省事的办法,而且他们也提供了很好的辅助工具。我是刚好在学习 django 的过程中想到了要搭建一个 git 仓库,同时因为部分环境用不了 ssh ,所以就搭建了一个属于自己的 git 服务器。学习新的知识也是个令人愉快的事情,共勉!
参考
progit.pdf
git-http-backend
Git Over Http: Service not enabled: 'receive-pack'
conf 文件配置