Gogs是用Go语言编写的自托管开源git服务器。它包括一个存储库文件编辑器,项目问题跟踪和一个内置的Wiki。

Gogs 是轻型应用程序,可以安装在低功率系统上。如果您正在寻找内存占用空间更小的Gitlab替代品,并且不需要 Gitlab 提供的所有功能,那么您绝对应该尝试Gogs。

本教程介绍了在Ubuntu 18.04上安装和配置Gogs的步骤。相同的说明适用于Ubuntu 16.04和任何其他基于Ubuntu的发行版。

开始之前

Gogs可以使用SQLite, PostgreSQL MySQL / MariaDB 数据库存储其所有数据。

在本教程中,我们将使用SQLite作为选择的数据库。如果您的系统上未安装SQLite,则可以输入以下内容进行安装:

sudo apt install sqlite3

为增加安全性,建议设置基本防火墙。您可以按照如何在Ubuntu 18.04上使用UFW设置防火墙中的步骤操作。

安装Gogs

我们将从二进制文件安装Gogs。安装过程非常简单。

安装Git

第一步是在您的服务器上安装Git 。为此,请以 sudo用户的身份运行以下命令来刷新本地软件包索引并安装git软件包:

sudo apt update
sudo apt install git

通过显示Git版本来验证安装:

git --version
git version 2.17.1

创建Git用户

通过键入以下内容来创建新的系统用户以运行Gogs服务:

sudo adduser --system --group --disabled-password --shell /bin/bash --home /home/git --gecos 'Git Version Control' git

该命令将创建用户并将主目录设置为/home/git。输出如下所示:

Adding system user `git' (UID 111) ...
Adding new group `git' (GID 116) ...
Adding new user `git' (UID 111) with group `git' ...
Creating home directory `/home/git' ...

下载Gogs二进制文件

访问 Gogs下载页面,然后下载适用于您的体系结构的最新二进制文件。在撰写本文时,最新版本为0.11.86,如果有可用的新版本,请更改以下命令中的VERSION变量。

使用以下 wget命令下载/tmp目录中的Gogs存档:

VERSION=0.11.86
wget https://dl.gogs.io/${VERSION}/gogs_${VERSION}_linux_amd64.tar.gz -P /tmp

下载完成后,解压Gogs tar.gz文件,并将其移至/home/git目录:

sudo tar xf /tmp/gogs_*_linux_amd64.tar.gz -C /home/git

运行以下命令以将Gogs安装目录的所有权更改为用户和git组:

sudo chown -R git: /home/git/gogs

创建系统的单位文件

Gogs随附了已配置为与我们的设置匹配的Systemd单位文件。

通过键入以下内容将文件复制到/etc/systemd/system/目录:

sudo cp /home/git/gogs/scripts/systemd/gogs.service /etc/systemd/system/

完成后,启动并启用Gogs服务:

sudo systemctl start gogs
sudo systemctl enable gogs

验证服务已成功启动:

* gogs.service - Gogs
   Loaded: loaded (/etc/systemd/system/gogs.service; enabled; vendor preset: enabled)
   Active: active (running) since Thu 2019-04-25 04:13:44 PDT; 9s ago
 Main PID: 14376 (gogs)
    Tasks: 8 (limit: 2319)
   CGroup: /system.slice/gogs.service
           `-14376 /home/git/gogs/gogs web

使用网络安装程序安装Gogs

现在已下载并正在运行Gogs,现在该通过网络界面完成安装了。

打开浏览器,键入http://YOUR_DOMAIN_IR_IP:3000,将出现类似于以下的屏幕:

数据库设置:

  • 数据库类型:SQLite3
  • 路径:使用绝对路径,/home/git/gogs/gogs.db

应用常规设置

  • 应用程序名称:输入您的组织名称
  • 存储库根路径:保留默认值/home/git/gogs-repositories
  • 运行用户:git
  • 域:输入您的域或服务器IP地址。
  • SSH端口:22,如果SSH在其他端口
  • HTTP端口:3000
  • 应用程序URL:使用http和您的域或服务器IP地址。
  • 登录路径:保留默认设置/home/git/gogs/log

​​  之后,您可以通过编辑Gogs配置文件来更改设置。

完成后,点击“安装Gogs”按钮。安装是即时的,完成后您将被重定向到登录页面。

点击“立即注册”链接。

第一个注册用户将自动添加到管理员组。

就是这样。 Gogs已安装在您的Ubuntu计算机上。

将Nginx配置为SSL终止代理

此步骤是可选步骤,但强烈建议您这样做。要将 Nginx用作反向代理,您需要具有一个指向服务器公共IP的域或子域。在本教程中,我们将使用gogs.example.com

首先,请按照以下指南安装Nginx并生成免费的“加密我们的SSL”证书:

完成后,打开文本编辑器并编辑域服务器块文件:

sudo nano /etc/nginx/sites-enabled/gogs.example.com

/etc/nginx/sites-enabled/gogs.example.com

server {
    listen 80;
    server_name gogs.example.com;

    include snippets/letsencrypt.conf;
    return 301 https://gogs.example.com$request_uri;
}

server {
    listen 443 ssl http2;
    server_name gogs.example.com;

    proxy_read_timeout 720s;
    proxy_connect_timeout 720s;
    proxy_send_timeout 720s;

    client_max_body_size 50m;

    # Proxy headers
    proxy_set_header X-Forwarded-Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Real-IP $remote_addr;

    # SSL parameters
    ssl_certificate /etc/letsencrypt/live/gogs.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/gogs.example.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/gogs.example.com/chain.pem;
    include snippets/letsencrypt.conf;
    include snippets/ssl.conf;

    # log files
    access_log /var/log/nginx/gogs.example.com.access.log;
    error_log /var/log/nginx/gogs.example.com.error.log;

    # Handle / requests
    location / {
       proxy_redirect off;
       proxy_pass http://127.0.0.1:3000;
    }
}

请不要忘记将Gogs.example.com替换为您的Gogs域,并为SSL证书文件设置正确的路径。所有 HTTP请求都将重定向到HTTPS

重新启动Nginx服务,以使更改生效:

sudo systemctl restart nginx

接下来,我们需要更改Gogs域和根URL。为此,请打开配置文件并编辑以下行:

sudo nano /home/git/gogs/custom/conf/app.ini

/home/git/gogs/custom/conf/app.ini

[server]
DOMAIN           = gogs.example.com
ROOT_URL         = https://gogs.example.com/

通过键入以下内容来重新启动Gogs服务:

sudo systemctl restart gogs

至此,已配置Gogs,您可以在以下位置访问它:[27​​0]

配置电子邮件通知

为了使Gogs能够发送通知电子邮件,您可以安装Postfix或使用某些事务性邮件服务,例如SendGrid,MailChimp,MailGun或SES。

要启用电子邮件通知,请打开配置文件并编辑以下行:

sudo nano /home/git/gogs/custom/conf/app.ini

/home/git/gogs/custom/conf/app.ini

[mailer]
ENABLED = true
HOST    = SMTP_SERVER:SMTP_PORT
FROM    = SENDER_EMAIL
USER    = SMTP_USER
PASSWD  = YOUR_SMTP_PASSWORD

确保输入正确的SMTP服务器信息。

重新启动Gogs服务,以使更改生效:

sudo systemctl restart gogs

Gogs还允许您通过创建 web webhook 并将其发送到 Slack频道的通知来连接到Slack。

升级Gogs

要升级Gogs,需要执行几个手动步骤。

首先停止Gogs服务:

sudo systemctl stop gogs

重命名 Gogs安装目录。

sudo mv /home/git/gogs{,_old}

下载最新的Gogs版本并将其移至/home/git目录:

VERSION=<THE_LATEST_GOGS_VERSION>
wget https://dl.gogs.io/${VERSION}/gogs_${VERSION}_linux_amd64.tar.gz -P /tmp
sudo tar xf /tmp/gogs_*_linux_amd64.tar.gz -C /home/git

确保使用实际的Gogs发行版更改了VERSION

复制customdata ],使用以下 rsync命令log目录复制到提取的目录中:

sudo rsync -a /home/git/gogs_old/{custom,data,log} /home/git/gogs/

启动Gogs服务:

sudo systemctl restart gogs

结论

本教程将引导您完成Ubuntu 18.04上Gogs的安装和配置。现在,您可以创建第一个项目,并开始使用新的Gogs服务器。

如果您有任何疑问,请在下面发表评论。

如果你喜欢我们的内容可以选择在下方二维码中捐赠我们,或者点击广告予以支持,感谢你的支持