Gogs：可能是比Gitlab更好的选择

Bertha 。 2022-06-03 08:44 888阅读 0赞

转载自：https://segmentfault.com/a/1190000002605142

> 译者注：看到一篇介绍能简单自建git托管服务的项目—— Gogs ——的文章，感觉这个项目很棒，翻译给大家参考一下。  
> 这个项目的四位主要开发者都是中国人，该项目今天蝉联 GitHub Go 语言 Trending 第一。(づ￣3￣)づ莫名的自豪感油然而生。希望能有更多优秀的国产项目出现~

[Gitlab][]是一个很棒的Git托管服务，几乎像[GitHub][]一样强大。 但是，有没有能和Gitlab/Github媲美但操作更简单的项目呢？我认为 [Gogs][]是很好的选择。

## 简介 ##

现在，GitHub已经成为首选的代码托管平台。 因为它又很多很棒的功能，操作简单，几乎所有的开发者都喜欢它。

同时，[谷歌的代码托管项目准备关闭][Link 1]，你可以把项目转移到这里。

但如果你在写Android应用程序，或者正在创建下一个伟大的iOS游戏，或者不想让别人看到你的代码没，该怎么办？

你当然可以购买私人GitHub库，但你肯定更想把资金投资到更紧迫的事情上。

这就是 Gitlab 和 Gogs 这样的软件诞生的原因。

他们提供的服务和GitHub非常相似，不同的是，你可以把项目放在你自己的服务器上，甚至是自己的工作站上。

下面一起来进行更深入的了解。

## Gitlab ##

Gitlab是一个强大的git服务，基本功能和对手GitHub一样。 这是一个成熟的项目和并且在不断更新。

![bVk5Pp][]

他们最近收购了[Gitorius][]（另一个类似GitHub的服务），所以功能将有望得到扩展（[查看有关收购的新闻剪辑][Link 2]）。

以前是手动安装，很耗时间，问题也很多。最近安装过程有所改善。

现在有 Linux DEB／RPM 的安装包可用（称为Omnibus），解决了所有的依赖问题，简化了安装过程。

升级是一个复杂的事情，尤其是从较早的版本升级到最新版，但也没那么复杂。

然而，你可以感受到很多东西是在后台执行的。 你可以运行 Sidekiq、Unicorn、Nginx、Ruby (包括 gems) 和 Gitlab本身。

自定义安装不是那么简单，有很多不确定因素，如果出了什么差错，要自己一个个排查。

## 输入二进制包 ##

现在，我们有了[Gogs][]。 你所要做的就是运行一个的二进制包。

它是用[Go][]语言写的，能兼容各个系统。

它能运行于 Windows，MAC，Linux，ARM 等。

![bVk5Pr][]

安装时只需要把压缩包解压到选定的文件夹中。 就是这样。 升级也一样：只要解压压缩包即可。

这就是[Go语言二进制开发][Go]的美，你可以轻松在多个平台下开发。

Gogs占用资源少，所以它很容易在系统资源上运行（它可以在[Raspberry Pi][]运行）。

你可以用默认的配置运行，或做一些小调整。

默认的配置文件位于安装文件夹的`/conf/app.ini`，文档建议把自定义配置写到`/custom/conf/app.ini`，这样升级就不会覆盖配置。

有三个可自定义的东西：

*  库的位置
    
        [repository]
        ROOT = !! 库的地址 !!
 *  数据库位置
    
        [database]
        PATH = !! 数据库地址 !!
 *  公钥

![bVk5Pt][]

注意：目前，你需要运行一个SSH服务器（OpenSSH也很好），这和gitlab相同。

## 比较 ##

让我们比较一下这两个产品。 我将以GitHub作为参考。

<table style="border-collapse:collapse; border-spacing:0px; background-color:transparent; margin:1.5em 0px; width:825px"> 
 <thead style=""> 
  <tr style=""> 
   <th style="padding:5px 8px; text-align:left; border:1px solid rgb(230,230,230); word-break:normal; background:rgb(243,243,243)"> 特性</th> 
   <th style="padding:5px 8px; text-align:left; border:1px solid rgb(230,230,230); word-break:normal; background:rgb(243,243,243)"> Gogs</th> 
   <th style="padding:5px 8px; text-align:left; border:1px solid rgb(230,230,230); word-break:normal; background:rgb(243,243,243)"> Gitlab</th> 
   <th style="padding:5px 8px; text-align:left; border:1px solid rgb(230,230,230); word-break:normal; background:rgb(243,243,243)"> Github</th> 
  </tr> 
 </thead> 
 <tbody style=""> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Dashboard &amp; File Browser</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Issue Tracking, Milestones &amp; Commit keywords</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Organizations support</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> N</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Wiki</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> N</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Code Review</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> N</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Code Snippets</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> N</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Web Hooks</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Git Hooks</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> * Enterprise</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> * Enterprise</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> LDAP Login</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Y</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> LDAP Group Sync</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> N</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> * Enterprise</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> * Enterprise</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Branded Login Page</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> N</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> * Enterprise</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> * Enterprise</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Language</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Go</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Ruby</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Ruby</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Platform</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Cross-Platform</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Linux</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> * Virtual Machine</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> License</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> MIT</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> MIT</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Proprietary</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Resource Usage</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Low</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Medium/High</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Medium/High</td> 
  </tr> 
 </tbody> 
</table>

代码审查（拉取请求）可以说是缺失的最重要的功能。 这是 Gogs 在[Github issues][] 里首要问题，Gogs的主要开发者正在尽力开发中。

但总的来说，这是一个功能丰富的、私有的Git托管服务。

## 运行一个 Gogs docker ##

我[以前描述][Link 3]我如何我的服务器环境docker化，所以我也会把gogs作为Docker容器来运行

让我们一步一步来做。

假设我有一个应用程序的文件在我的服务器根目录`/home/kayak/apps`，给每个作为Docker容器的应用创建子目录。

下载并解压最新版本gogs。

$ cd /home/kayak/apps
    $ wget http://gogs.dn.qbox.me/gogs_v0.5.13_linux_amd64.zip
    $ unzip gogs_v0.5.13_linux_amd64.zip
    $ rm gogs_v0.5.13_linux_amd64.zip

自定义配置

$ cd gogs $ mkdir -p custom/conf $ cd custom/conf $ nano app.ini [repository] ROOT = !! this is the location where you want to keep the repositories !! [database] PATH = !! this is the location of your database (sqlite3 by default) !!

注： 你也可以不把gogs作为docker容器，直接运行。

现在让我们创建dockerfile

$ cd /home/kayak/apps/gogs
    $ nano Dockerfile
    
    FROM ubuntu:14.04
    
    ENV DEBIAN_FRONTEND noninteractive
    
    RUN sed 's/main$/main universe multiverse/' -i /etc/apt/sources.list && \ apt-get update && apt-mark hold initscripts && \ apt-get install -y sudo openssh-server git && \ apt-get clean 
    EXPOSE 22 3000
    
    RUN addgroup --gid 501 kayak && adduser --uid 501 --gid 501 --disabled-password --gecos 'kayak' kayak && adduser kayak sudo 
    WORKDIR /home/kayak ENV HOME /home/kayak
    
    ENTRYPOINT ["/home/kayak/boot"]

dockerfile是基于最新的Ubuntu LTS版服务器（14.04）。

然后安装 sudo, openssh 和 git，暴露端口22（用于SSH）和3000（给gogs的Web界面）。

另外，我通常会创建一个用户（这里用 kayak），它具有与我的Max box用户相同的UID/GID，以防止访问权限问题。

最后，启动shell脚本运行。

$ touch boot
    $ chmod +x boot
    $ nano boot
    #!/bin/bash 
    sudo -u kayak -H touch /home/kayak/.ssh/authorized_keys
    chmod 700 /home/kayak/.ssh && chmod 600 /home/kayak/.ssh/authorized_keys
    
    # start openssh server
    mkdir /var/run/sshd
    /usr/sbin/sshd -D &
    
    exec sudo -u kayak /home/kayak/gogs web

这样就运行了ssh守护进程和gogs。现在是以kayak用户运行，这样比用默认的root用户好一些。

建立镜像

$ cd /home/kayak/apps/gogs
    $ docker build --rm -t apertoire/gogs .

镜像建立好就可以运行了

$ docker run -d --name gogs \
    -v /etc/localtime:/etc/localtime:ro \
    -v /home/kayak/apps/gogs:/home/kayak \
    -p 62723:22 \
    -p 3000:3000 \
    apertoire/gogs

可以在命令行查看运行情况。

![bVk5R1][]

现在可以打开网页界面，它会显示一个安装页面（首次运行）。

![bVk5R2][]

安装完成后，就搭建好一个功能丰富的Gogs了。

![bVk5R3][]

## 总结 ##

Gogs 是一个轻量级的、易于设置、跨平台的Git托管服务，不逊色于 Gitlab 和 GitHub。

虽然不比这二者成熟，但它有很大的潜力。

它是开源的，所以你可以帮助改善它。

我用Gogs取代Gitlab几个月了，感觉不错。

我创建42个库，感觉它的性能非常好。

我绝对推荐Gogs作为你的Git自托管服务。

## 附该项目在Github上的4位开发者： ##

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

英文原文 [Gogs, an alternative to Gitlab][Gogs_ an alternative to Gitlab]  
整理编译 [SegmentFault][]

*  [2015年03月18日发布][2015_03_18]

[Gitlab]: https://gitlab.com/
[GitHub]: https://github.com/
[Gogs]: http://gogs.io/
[Link 1]: http://arstechnica.com/information-technology/2015/03/google-to-close-google-code-open-source-project-hosting/
[bVk5Pp]: /images/20220603/8b75860df18543a5ab699ab9b1ca6fd8.png
[Gitorius]: https://gitorious.org/
[Link 2]: http://thenextweb.com/insider/2015/03/03/gitlab-acquires-rival-gitorious-will-shut-june-1/
[Go]: https://golang.org/
[bVk5Pr]: /images/20220603/33d3160b13c140bead67226c6896c86d.png
[Raspberry Pi]: http://www.raspberrypi.org/
[bVk5Pt]: /images/20220603/34bd155df06242599cf1124401c7f48a.png
[Github issues]: https://github.com/gogits/gogs/issues/5
[Link 3]: http://www.apertoire.net/dockeritazion
[bVk5R1]: /images/20220603/94fab45de78a4f65a68063e45bba9308.png
[bVk5R2]: /images/20220603/82d5feafacf0450cb2000bb5b834777b.png
[bVk5R3]: /images/20220603/b5f6fa92bbb04856a19763b3f797e5fd.png
[Gogs_ an alternative to Gitlab]: http://www.apertoire.net/gogs-an-alternative-to-gitlab/
[SegmentFault]: http://segmentfault.com/blog/news/1190000002605142
[2015_03_18]: https://segmentfault.com/a/1190000002605142