在CentOS上使用 Gogs 搭建自己的 Git 服务器

发布时间: 2017-11-04热度: 1290

为了同步代码我们通常使用git来对代码进行管理,最常用的就是Github了。但出于某些原因,有些代码我们并不想公开(当然我们可以使用github的私有仓库,但同样有基于安全意义上的考量),作为一个现实意义上的穷人,我并不能支付得起github的付费方案,因此使用免费开源的git server就成为了我的最佳选择。作为折腾的一部分,在这里把安装的过程和一些需要注意的地方记录一下。

目前比较好的git server有两个,GitlabGogs。Gitlab作为Github的山寨版,功能非常全面,但与此同时也十分臃肿。国人开发的Gogs则十分轻量,据作者说甚至能在一台普通的树莓派上运行,作为个人用的代码托管平台,显然Gogs更适合我。

安装步骤

1.新建用户
2.下载源码进行编译/下载预编译二进制文件
3.安装
4.调整配置
5.配置nginx反向代理
6.添加服务及开机启动

注意,这里默认你已经安装并配置好了MySQLnginx,如果没有,请自行查找如何安装和配置这些依赖。当然你也可以使用SQLite数据库。

新建用户

Gogs默认以git用户运行,因此我们需要建立一个git用户

$ sudo adduser git   #建立git用户
$ su git             #以git用户登录
$ mkdir ~/.ssh       #建立.ssh目录

下载并解压缩

为了节省时间,我选择的是编译好的二进制文件,需要从源码编译的话,请参考一般Go语言项目的编译。
这里寻找适用于你系统的二进制包

下载后解压到你喜欢的地方,例如/usr/share/gogs/或者/home/git/gogs/。目录结构如下:

$ ls ~/gogs

custom gogs log README.md scripts
data LICENSE public README_ZH.md templates

安装

首先建立数据库。Gogs目录的scripts/mysql.sql文件是数据库初始化文件。
执行mysql -u root -p < scripts/mysql.sql(需要输入密码)即可初始化数据库。

然后登录MySQL创建一个新用户gogs,并将数据库gogs 的所有权限都赋予该用户。

$ mysql -u root -p
mysql> # (输入密码)
mysql> create user 'gogs'@'localhost' identified by '密码';
mysql> grant all privileges on gogs.* to 'gogs'@'localhost';
mysql> flush privileges;
mysql> exit;

执行./gogs web运行Gogs,然后访问http://服务器IP:3000/ 安装,按照页面提示填写信息。

调整配置

配置文件位于Gogs目录的custom/conf/app.ini,为INI格式的文本文件,关键配置如下。
详细的配置解释和默认值请参考配置文件手册

  • RUN_USER默认为git,指定Gogs以哪个用户运行
  • ROOT 所有仓库的存储根路径
  • PROTOCOLnginx反代的话使用http
  • DOMAIN域名,会影响SSH clone地址
  • ROOT_URL完整的根路径,会影响页面上链接指向,以及HTTP(s) clone的地址
  • HTTP_ADDR监听地址,使用nginx建议127.0.0.1,否则localhost0.0.0.0也可以
  • HTTP_PORT监听端口,默认3000
  • INSTALL_LOCK锁定安装页面
  • Mailer相关的选项
    注意邮箱stmp地址要加端口号

配置nginx反向代理

修改nginx的配置文件,添加如下内容:

server {

server_name 域名或IP;
listen 80; #或者443,如果你使用 HTTPS 的话
# ssl on; 是否启用加密连接
# 如果你使用HTTPS,还需要填写ssl_certificate和ssl_certificate_key

location / { #如果你希望通过子路径访问,此处修改为子路径,注意以/开头和结束
    proxy_pass http://127.0.0.1:3000/;
}

}

执行sudo service nginx reload重新载入nginx配置

添加服务及开机启动

Gogs目录的scripts目录中找到对应你所用发行版的版本,文件名为gogs
执行

$ sudo cp ~/gogs/scripts/gogs /etc/init.d/
$ sudo chmod +x /etc/init.d/gogs

以后就可以使用sudo service gogs {start|stop|status|restart}来对Gogs服务进行管理。

但是我们还需要为Gogs添加开机启动,执行:

$ sudo chkonfig gogs on

即可添加开机启动,取消自启可以执行sudo chkonfig gogs off

参考资料

使用Gogs搭建自己的Git服务器
配置文件手册
Gogsgithub上的项目页

请在下方留下您的评论.加入TG吹水群