Linux下使用Gogs搭建Git仓库详细教程

系统管理员 2021-09-24 07:38 785阅读 1赞

> `创作不易，如果觉得这篇文章对你有帮助，欢迎各位老铁点个赞呗，您的支持是我创作的最大动力！`

### 文章目录 ###

*  1 前言
 *  2 Git仓库有哪些
 *  3 为什么要搭建私有Git仓库
 *  4 什么是Gogs
 *  5 搭建Git仓库（Gogs搭建）
 *   *  5.1 环境要求
     *   *  5.1.1 数据库（选择以下中的任意一项）：
         *  5.1.2 git（bash）：
         *  5.1.3 SSH 服务器：
     *  5.2 搭建Gogs步骤
     *   *  5.2.1 Linux中安装一个MySQL
         *  5.2.2 Linux上安装Git
         *  5.2.3 Linux安装gogs
         *  5.2.4 启动Gogs
         *  5.2.5 第一次访问需要按向导配置一下
 *  6 懒人-设置systemctl启动

# 1 前言 #

最近两年，越来越多的公司倾向于使用Git作为项目版本控制工具，相比较svn而言，还是会便利一些，尤其是Git强大的分支管理。这里笔者建议使用`Gogs`搭建轻量级的Git仓库，当然啦，如果服务器配置足够好，搭建GitLab也是不错的选择。

# 2 Git仓库有哪些 #

Git仓库一般是指远程仓库，而不是我们自己机器上的本地仓库，常见的Git仓库种类有：

*  GitHub：[https://github.com][https_github.com]
 *  Gitee：[https://gitee.com][https_gitee.com]
 *  公司自己搭建Git仓库 （主要有：GitLab、Gogs）

# 3 为什么要搭建私有Git仓库 #

公司里，为了更好地进行团队协作，通常会划分不同的项目小组，每个小组，负责不同的项目。而项目多的时候，就需要有一个好用的项目版本控制工具，Git就是一个很好的项目版本控制工具。

一般来说，公司的项目对外都是保密的，所以需要有一个私有的项目管理工具，这时候Gogs就派上用场了，相比较GitLab，更加的轻量级，方便。

# 4 什么是Gogs #

`Gogs`是一个使用`Go`语言写的，轻量级的Git代码版本控制仓库，可以利用该软件搭建一套公司内部的Git仓库环境，供公司内部，各开发部门各个项目小组使用。

# 5 搭建Git仓库（Gogs搭建） #

## 5.1 环境要求 ##

笔者这里，使用MySQL数据库，搭建Gogs仓库环境。

### 5.1.1 数据库（选择以下中的任意一项）： ###

*  `MySQL：版本 >= 5.7`
 *  PostgreSQL
 *  TiDB（实验性支持，使用 MySQL 协议连接）
 *  或者 什么都不安装 直接使用 SQLite3

### 5.1.2 git（bash）： ###

`服务端和客户端均需版本 >= 1.8.3`  
Windows 系统建议使用最新版

### 5.1.3 SSH 服务器： ###

**如果您只使用 HTTP/HTTPS 的话请忽略此项**  
如果您选择在 Windows 系统使用内置 SSH 服务器，请确保添加 ssh-keygen 到您的 %PATH% 环境变量中  
推荐 Windows 系统使用 Cygwin OpenSSH 或 Copssh  
Windows 系统 请确保 Bash 是默认的 Shell 程序，而不是 PowerShell

## 5.2 搭建Gogs步骤 ##

### 5.2.1 Linux中安装一个MySQL ###

如果没有MySql环境的老铁们，可以参考我的博客：[Linux下安装MySQL详细教程][Linux_MySQL]

`把MySQL启动起来，并且在MySQL数据库上创建gogs数据库，不用创建表`

### 5.2.2 Linux上安装Git ###

Gogs需要Linux安装了git，可以执行 `git --version`命令，看一下是否有git环境，如果提示`-bash: git: command not found`找不到命令，说明没有安装git。

这里为了简单，使用yum安装方式，执行以下命令：  
`yum install git -y`  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NtaWxlaGFwcGluZXNz_size_16_color_FFFFFF_t_70]  
出现以上红框所示信息，说明git环境配置成功。

### 5.2.3 Linux安装gogs ###

官网给出了两种方式：`二进制安装`和`源码安装`，笔者这里使用二进制安装。

**二进制方式安装：**  
下载tar.gz包：[https://dl.gogs.io/0.11.91/gogs\_0.11.91\_linux\_amd64.tar.gz][https_dl.gogs.io_0.11.91_gogs_0.11.91_linux_amd64.tar.gz]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NtaWxlaGFwcGluZXNz_size_16_color_FFFFFF_t_70 1]

下载Gogs包，把下载的tar.gz包上传到服务器，然后解压缩，解压缩之后就安装完成。  
`tar -zxvf gogs_0.11.91_linux_amd64.tar.gz -C /usr/local/`

**安装后的目录结构：**  
![在这里插入图片描述][20200521225139178.png]

### 5.2.4 启动Gogs ###

*  切换到安装目录  
    使用命令： `cd /usr/local/gogs`
 *  启动  
    使用命令（一次性启动）：`./gogs web > ./gogs.log`  
    也可以使用命令：`nohup ./gogs web > ./gogs.log &`  
    `nohup`是把命令的启动日志默认输出到一个nohup.out文件
    
    启动时添加了一个重定向 `> ./gogs.log`，把日志信息重定向输出到`./gogs.log`，方便以后分析日志。
    
    通过gogs.log文件，可以查看启动日志，使用命令：  
    `cat gogs.log`  
    ![在这里插入图片描述][20200521230045671.png]
 *  检查是否启动成功  
    使用命令：`ps -ef | grep gogs`  
    ![在这里插入图片描述][20200521225804944.png]  
    有gogs进程，说明启动Gogs成功。

### 5.2.5 第一次访问需要按向导配置一下 ###

访问：`http://ip:3000`

访问时，有可能访问不到，如果是阿里云服务，需要配置安全组：  
![在这里插入图片描述][20200521230340689.png]

如果你的服务器或者虚拟机开启了防火墙，需要开放3000端口：

*  **开启3000防火墙端口**  
    `firewall-cmd --zone=public --add-port=3000/tcp --permanent`
 *  **重新加载防火墙配置**  
    `firewall-cmd --reload`

第一次访问时，需要配置Gogs：`http://ip:3000/install`，可以按向导，根据公司实际需求，配置即可。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NtaWxlaGFwcGluZXNz_size_16_color_FFFFFF_t_70 2]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NtaWxlaGFwcGluZXNz_size_16_color_FFFFFF_t_70 3]

注意：要保证MySQL服务启动成功了

至此，简单的Git仓库环境-Gogs就安装完成了，童鞋们，可以去玩耍了。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NtaWxlaGFwcGluZXNz_size_16_color_FFFFFF_t_70 4]

# 6 懒人-设置systemctl启动 #

*  设置systemctl启动原因  
    每次使用 `nohup ./gogs web &` 进行后台启动比较麻烦，不仅需要进入安装目录，还得敲这么麻烦的命令。配置使用systemctl方式启动gogs，可以很方便的在任何目录下执行启动。
 *  设置systemctl启动  
    这里，博主使用官方的启动脚本gogs.service（这里gogs.service脚本文件在你的gogs安装目录下），使用以下命令，把启动脚本复制到Linux system目录下  
    `cp /usr/local/gogs/scripts/systemd/gogs.service /usr/lib/systemd/system/`
    
    然后就可以很方便的在任何目录下启动和停止Gogs服务了。
    
    **使用命令启动服务**  
    `systemctl start gogs.service`  
    或者  
    `systemctl start gogs`  
    或者  
    `service gogs start`
    
    **使用命令查看服务状态**  
    `systemctl status gogs.service`
    
    **使用命令停止服务**  
    `systemctl stop gogs.service`
    
    **设置永久启动**（不建议使用，前提要启动mysql）：`systemctl enable gogs.service`
 *  **说明：**  
    如果不能正常启动，把`/usr/lib/systemd/system/gogs.service`里的配置文件进行修改  
    使用命令：`vim /usr/lib/systemd/system/gogs.service`
    
    **修改前文件内容：**
    
        [Unit]
        Description=Gogs
        After=syslog.target
        After=network.target
        After=mariadb.service mysqld.service postgresql.service memcached.service redis.service
        
        [Service]
        # Modify these two values and uncomment them if you have
        # repos with lots of files and get an HTTP error 500 because
        # of that
        ###
        #LimitMEMLOCK=infinity
        #LimitNOFILE=65535
        Type=simple
        User=git
        Group=git
        WorkingDirectory=/home/git/gogs
        ExecStart=/home/git/gogs/gogs web
        Restart=always
        Environment=USER=git HOME=/home/git
        
        # Some distributions may not support these hardening directives. If you cannot start the service due
        # to an unknown option, comment out the ones not supported by your version of systemd.
        ProtectSystem=full
        PrivateDevices=yes
        PrivateTmp=yes
        NoNewPrivileges=true
        
        [Install]
        WantedBy=multi-user.target
    
    修改部分如下：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NtaWxlaGFwcGluZXNz_size_16_color_FFFFFF_t_70 5]  
    **修改后文件内容：**
    
        [Unit]
        Description=Gogs
        After=syslog.target
        After=network.target
        After=mariadb.service mysqld.service postgresql.service memcached.service redis.service
        
        [Service]
        # Modify these two values and uncomment them if you have
        # repos with lots of files and get an HTTP error 500 because
        # of that
        ###
        #LimitMEMLOCK=infinity
        #LimitNOFILE=65535
        Type=simple
        User=root
        Group=root
        WorkingDirectory=/usr/local/gogs
        ExecStart=/usr/local/gogs web
        Restart=always
        Environment=USER=root HOME=/usr/local/gogs
        
        # Some distributions may not support these hardening directives. If you cannot start the service due
        # to an unknown option, comment out the ones not supported by your version of systemd.
        # ProtectSystem=full
        # PrivateDevices=yes
        # PrivateTmp=yes
        # NoNewPrivileges=true
        
        [Install]
        WantedBy=multi-user.target
    
    更改成功后，使用`systemctl daemon-reload`重新加载即可启动成功。
    
    启动成功界面，如下图所示：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NtaWxlaGFwcGluZXNz_size_16_color_FFFFFF_t_70 6]
    
    参考资料：[Gogs官网][Gogs]

> 写博客是为了记住自己容易忘记的东西，另外也是对自己工作的总结，希望尽自己的努力，做到更好，大家一起努力进步！  
>   
> 如果有什么问题，欢迎大家一起探讨，代码如有问题，欢迎各位大神指正！  
>   
> 给自己的梦想添加一双翅膀，让它可以在天空中自由自在的飞翔！

[https_github.com]: https://github.com
[https_gitee.com]: https://gitee.com
[Linux_MySQL]: https://blog.csdn.net/smilehappiness/article/details/105344516
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NtaWxlaGFwcGluZXNz_size_16_color_FFFFFF_t_70]: /images/20210923/0f612e74dc5e4219b0954deac85d903c.png
[https_dl.gogs.io_0.11.91_gogs_0.11.91_linux_amd64.tar.gz]: https://dl.gogs.io/0.11.91/gogs_0.11.91_linux_amd64.tar.gz
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NtaWxlaGFwcGluZXNz_size_16_color_FFFFFF_t_70 1]: /images/20210923/ad5a295102a64c9ab73f9db3c3af8d6a.png
[20200521225139178.png]: /images/20210923/7f07a9e405ce45f18760c8b846c6fa13.png
[20200521230045671.png]: /images/20210923/b1ad71922cf448c69e36d0920952ddf7.png
[20200521225804944.png]: /images/20210923/c7208fd16dd7471e86b45bb97fbcc3d6.png
[20200521230340689.png]: /images/20210923/7c1448f9194e4480b1cd9c6ffe1dbcf1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NtaWxlaGFwcGluZXNz_size_16_color_FFFFFF_t_70 2]: /images/20210923/8042a77f43f7475f91514b065dc6fdbd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NtaWxlaGFwcGluZXNz_size_16_color_FFFFFF_t_70 3]: /images/20210923/6719d268233f42e191bc14bfc84ee506.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NtaWxlaGFwcGluZXNz_size_16_color_FFFFFF_t_70 4]: /images/20210923/f25b400e4ed74d51a36ccb4cf1016ea8.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NtaWxlaGFwcGluZXNz_size_16_color_FFFFFF_t_70 5]: /images/20210923/0a6c7ca7a6144745a3bc903aa49b2339.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NtaWxlaGFwcGluZXNz_size_16_color_FFFFFF_t_70 6]: /images/20210923/96dcc0fb0b7e4184970d77920f7ed168.png
[Gogs]: https://gogs.io