原文:http://aaba.me/blog/2014/03/setup-a-private-http-nginx-based-git-server.html

https://doomzhou.github.io/git/linux/2016/03/30/git-over-http-by-nginx.html

参考:http://beginor.github.io/2016/03/12/http-git-server-on-nginx.html

« Downgrade Lightroom 5 catalog back to Lightroom 4 | Home | jsp tag属性的动态求值 »

March 22, 2014

Setup a private http/nginx based GIT server

搭建一个私有的GIT服务器,我们的需求不多:

  • http访问,使用nginx
  • web浏览界面
  • 简单的http base验证

操作系统为某个发行版的debian, 很多无关的细节都会略过,会有一些简单nginx的fastcgi配置说明。

查了很多资料,得出这些结论:

  • 使用git-http-backend 支持客户端访问,支持smart HTTP protocol
  • 使用gitweb 支持浏览器访问
  • 以上两个模块是普通的cgi,需要用fcgiwrap包装成fast-cgi
  • 可以使用nginx的fast-cgi支持
  • nginx的fast-cgi是代理,真正的fastcgi进程需要使用spawn-fcgi启动

启动spawn-fcgi

这里指定了监听的端口(9001),进程(2个,可以根据实际需要增加),最后一个参数是fcgiwrap的位置

spawn-fcgi -a 127.0.0.1 -p 9001 -F 2 /usr/local/sbin/fcgiwrap

debian默认的fcgiwrap好像有些问题,按照别人的[经验](http://stackoverflow.com/questions/14304922/nginx-fcgiwrapper-error-cannot-get-script-name)自己安装了一个。 这里启动的fcgiwrap进程监听在9001端口,nginx使用fastcgi的协议和它们交互,执行的真正脚本通过fcgi参数传过来,稍后就会配置到。 **安装好git, gitweb,创建git目录**

mkdir /data/git

修改 /etc/gitweb.conf ,gitweb需要知道代码放在哪里

# path to git projects (.git)
$projectroot = "/data/git";

**配置nginx** 配置文件里提到的auth_basic_user_file文件,可以用htpasswd(apache2)生成

server {
listen 80;
server_name my_git_server.com; # gitweb的非cgi资源
location ~ \.(png|css|js)$ {
root /usr/share/gitweb;
}
# gitweb
location /gitweb {
auth_basic "Restricted";
auth_basic_user_file /path_to_passwd;
# fcgiwrap is set up to listen on this host:port
fastcgi_pass 127.0.0.1:9001;
include fastcgi_params;
# fcgiwrapper执行这个文件
fastcgi_param SCRIPT_FILENAME /usr/share/gitweb/index.cgi;
} # git client
location / {
auth_basic "Restricted";
auth_basic_user_file /path_to_passwd;
# fcgiwrap is set up to listen on this host:port
fastcgi_pass 127.0.0.1:9001;
include fastcgi_params;
# fcgiwrapper执行这个文件
fastcgi_param SCRIPT_FILENAME /usr/lib/git-core/git-http-backend;
# export all repositories under GIT_PROJECT_ROOT
fastcgi_param GIT_HTTP_EXPORT_ALL "";
# git目录
fastcgi_param GIT_PROJECT_ROOT /data/git;
fastcgi_param PATH_INFO $1;
# 把用户带上,否则push会失败
fastcgi_param REMOTE_USER $remote_user;
}
}

按照上面步骤,一个基本可用的GIT就准备好了,如果你遇到了一些问题,比如,访问gitweb返回403错误,一般都出现在fcgiwrapper的执行上,可以把spawn-fcgi使用-n参数启动,看错误输出。

新建项目

在/data/git目录

$ mkdir my-new-repo.git
$ cd my-new-repo.git
$ git --bare init

切换到gitweb,就可以看到了。如果要提交代码,记得检查spawn-fcgi启动的用户要有写入/data/git目录权限。

---------------------------------------------------------------------------------------------------------------------------------------------

在 Ubuntu 系统上配置 Nginx Git 服务器

多年前发表过一篇在 Windows 系统上配置 Apache Git 服务器的博文, 主要是用 Apache 的 Basic 认证 + git-http-backend 实现, 现在需要在公司的 vps 上再部署一个类似的简单 git 服务器, 这次的软件环境如下:

  • Ubuntu 14.04.4 LTS
  • nginx/1.4.6 (Ubuntu)
  • git version 1.9.1

使用 git-http-backend 搭建 git 服务的原理都是类似的, 主要是利用 web 服务器 (apache/nginx) 进行用户认证, 并将用户信息传递给 CGI 程序 git-http-backend , 从而实现通过 http 完成 git 操作。

安装 git-core、 nginx 和 fcgiwrap

输入下面的命令安装需要的这三个软件包:

apt-get install git-core nginx fcgiwrap

配置 nginx

我的目的是在 nginx 的默认网站下添加一个虚拟目录 /git/ , 通过访问 /git/xxx.git 的形式来访问服务器上的 xxx.git 代码库, 这就需要修改一下 nginx 默认网站的配置文件 /etc/nginx/sites-available/default , 添加下面的信息:

# 配置以 /git 开始的虚拟目录
location ~ /git(/.*) {
# 使用 Basic 认证
auth_basic "Restricted";
# 认证的用户文件
auth_basic_user_file /etc/nginx/passwd;
# FastCGI 参数
fastcgi_pass unix:/var/run/fcgiwrap.socket;
fastcgi_param SCRIPT_FILENAME /usr/lib/git-core/git-http-backend;
fastcgi_param GIT_HTTP_EXPORT_ALL "";
# git 库在服务器上的跟目录
fastcgi_param GIT_PROJECT_ROOT /var/git-repos;
fastcgi_param PATH_INFO $1;
# 将认证用户信息传递给 fastcgi 程序
fastcgi_param REMOTE_USER $remote_user;
# 包涵默认的 fastcgi 参数;
include fastcgi_params;
# 将允许客户端 post 的最大值调整为 100 兆
max_client_body_size 100M;
}

创建 nginx 认证用户文件

参考 nginx ngx http auth basic module , 用户认证文件格式如下:

# comment
name1:password1
name2:password2:comment
name3:password3

可以使用 htpasswd 命令创建用户, 如果服务器上没有这个命令的话, 可以输入命令 apt-get install apache2-utils 来安装这个命令, 安装了这个命令之后, 就可以使用它来创建认证用户了, 比如要创建用户 user1, 输入命令如下:

htpasswd /etc/nginx/passwd user1

然后根据提示输入密码就可以了。

创建 git 代码库

上面配置的 git 跟目录是 /var/git-repos , 我们在这个目录下初始化一个空的代码库, 命令如下:

cd /var/git-repos
git init --bare test.git

注意检查一下 test.git 的权限, 如果权限不足的话, 使用这个命令设置一下权限:

chmod a+rw -R test.git

重启 nginx 并测试

输入命令重启 nginx 并测试 git 服务:

nginx -s reload
git clone http://server-name/git/test.git

最新文章

  1. mvc过滤器学习(1)
  2. The superclass "javax.servlet.http.HttpServlet" was not found on the Java Build Path。问题
  3. [转]office 2016 4合1/3合1 专业版 增强版 精简绿色安装版
  4. Visual Studio 2015 RC版官方下载(ISO)
  5. GMap.NET使用一
  6. jQuery设计思想之取值和赋值
  7. Handler知识点详解
  8. python模块以及导入出现ImportError: No module named 'xxx'问题
  9. MemoryStream类
  10. Learing WCF Chapter1 WCF Services
  11. 《第一行代码》学习笔记28-内容提供器Content Provider(1)
  12. 可删除超炫&多种特效的Card视图(改造自cardsui-for-android开源项目),提供DEMO下载
  13. Django权限管理测试
  14. CSS魔法(五)项目实战
  15. scrapy的Middleware
  16. Copycat - CopycatServer
  17. Oracle_高级功能(2) 索引
  18. Spring 3.1新特性之二:@Enable*注解的源码,spring源码分析之定时任务Scheduled注解
  19. get 与 next()
  20. git 还原某个文件到特定版本

热门文章

  1. 第七十八节,CSS3文本效果
  2. js-json教程从入门到使用
  3. 《JS权威指南学习总结--第五章语句》
  4. assign retain copy
  5. WiMAX协议栈
  6. digitalocean完成B轮8300万美元融资,赠送10美元优惠码
  7. Openjudge-计算概论(A)-奇数求和
  8. java的克隆
  9. F - 小晴天老师系列——苹果大丰收
  10. Set下面HashSet,TreeSet和LinkedHashSet的区别