Ubuntu 18.04 上安装搭建私有 Git 服务器 Gitea

共计 5780 个字符，预计需要花费 15 分钟才能阅读完成。

Gitea 是用 Go 编写的自托管开源 git 服务器。这是 Gogs 的分叉。Gitea 包括存储库文件编辑器，项目问题跟踪，用户管理，通知，内置 Wiki 等。

Gitea 是轻量级的应用程序，可以安装在低功率系统上。如果您正在寻找内存占用量少得多的 Gitlab 替代产品，并且不需要 Gitlab 提供的所有功能，那么您绝对应该尝试 Gitea。

本教程说明了如何在 Ubuntu 18.04 上安装和配置 Gitea。相同的说明适用于 Ubuntu 16.04 和任何其他基于 Debian 的发行版。

Ubuntu 18.04 上安装搭建私有 Git 服务器 Gitea

必要条件

Gitea 支持 SQLite，PostgreSQL 和 MySQL/MariaDB 作为数据库后端。

我们将使用 SQLite 作为 Gitea 的数据库。如果您的 Ubuntu 系统上未安装 SQLite，则可以通过以 sudo 用户身份输入以下命令来安装它：

[linuxidc@linux:~/www.linuxidc.com]$ sudo apt update

[linuxidc@linux:~/www.linuxidc.com]$ sudo apt install sqlite3

Ubuntu 18.04 上安装搭建私有 Git 服务器 Gitea

安装 Gitea

Gitea 提供了 Docker 映像，可以从源代码，二进制文件或作为软件包安装。

我们将从二进制文件安装 Gitea。完成以下步骤，在 Ubuntu 上安装 Gitea。

安装 Git

第一步是在您的服务器上安装 Git：

[linuxidc@linux:~/www.linuxidc.com]$ sudo apt install git

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

[linuxidc@linux:~/www.linuxidc.com]$ git –version

git version 2.17.1

Ubuntu 18.04 上安装搭建私有 Git 服务器 Gitea

创建一个 Git 用户

创建一个新的系统用户，将通过键入以下内容来运行 Gitea 应用程序：

该命令将创建一个名为 git 的新用户和组，并将主目录设置为 /home/git。输出如下所示：

[linuxidc@linux:~/www.linuxidc.com]$ sudo adduser –system –group –disabled-password –shell /bin/bash –home /home/git –gecos ‘Git Version Control’ git
正在添加系统用户 ”git” (UID 122)…
正在添加新组 ”git” (GID 127)…
正在将新用户 ”git” (UID 122)添加到组 ”git”…
创建主目录 ”/home/git”…

Ubuntu 18.04 上安装搭建私有 Git 服务器 Gitea

下载 Gitea 二进制文件

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

使用以下 wget 命令在 /tmp 目录中下载 Gitea 二进制文件：

[linuxidc@linux:~/www.linuxidc.com]$ VERSION=1.10.2
[linuxidc@linux:~/www.linuxidc.com]$ sudo wget -O /tmp/gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64

Ubuntu 18.04 上安装搭建私有 Git 服务器 Gitea

gitea 二进制文件可以在任何位置运行。我们将遵循约定并将二进制文件移至 /usr/local/bin 目录：

[linuxidc@linux:~/www.linuxidc.com]$ sudo mv /tmp/gitea /usr/local/bin

赋予二进制文件可执行权限：

[linuxidc@linux:~/www.linuxidc.com]$ sudo chmod +x /usr/local/bin/gitea

Ubuntu 18.04 上安装搭建私有 Git 服务器 Gitea

运行以下命令以创建目录并设置所需的权限和所有权：

[linuxidc@linux:~/www.linuxidc.com]$ sudo mkdir -p /var/lib/gitea/{custom,data,indexers,public,log}
[linuxidc@linux:~/www.linuxidc.com]$ sudo chown git: /var/lib/gitea/{data,indexers,log}
[linuxidc@linux:~/www.linuxidc.com]$ sudo chmod 750 /var/lib/gitea/{data,indexers,log}
[linuxidc@linux:~/www.linuxidc.com]$ sudo mkdir /etc/gitea
[linuxidc@linux:~/www.linuxidc.com]$ sudo chown root:git /etc/gitea
[linuxidc@linux:~/www.linuxidc.com]$ sudo chmod 770 /etc/gitea

Ubuntu 18.04 上安装搭建私有 Git 服务器 Gitea

/etc/gitea 目录的权限设置为 770，以便安装向导可以创建配置文件。安装完成后，我们将设置更多限制性权限。

创建 Systemd Unit 位文件

Gitea 提供了已配置为与我们的设置匹配的 Systemd Unit 文件。

通过键入以下命令将文件下载到 /etc/systemd/system/ 目录：

[linuxidc@linux:~/www.linuxidc.com]$ sudo wget https://raw.githubusercontent.com/go-gitea/gitea/master/contrib/systemd/gitea.service -P /etc/systemd/system/

Ubuntu 18.04 上安装搭建私有 Git 服务器 Gitea

完成后，启用并启动 Gitea 服务：

[linuxidc@linux:~/www.linuxidc.com]$ sudo systemctl daemon-reload
[linuxidc@linux:~/www.linuxidc.com]$ sudo systemctl enable –now gitea
Created symlink /etc/systemd/system/multi-user.target.wants/gitea.service → /etc/systemd/system/gitea.service.

Ubuntu 18.04 上安装搭建私有 Git 服务器 Gitea

配置 Gitea

现在已经下载并运行了 Gitea，是时候通过 Web 界面完成安装了。

默认情况下，Gitea 会侦听所有网络接口上端口 3000 上的连接。

如果您的服务器上运行着 UFW 防火墙，则需要打开 Gitea 端口：

要允许端口 3000 上的流量，请输入以下命令：

[linuxidc@linux:~/www.linuxidc.com]$ sudo ufw allow 3000/tcp
[sudo] linuxidc 的密码：
防火墙规则已更新
规则已更新(v6)

Ubuntu 18.04 上安装搭建私有 Git 服务器 Gitea

打开浏览器，输入 http://git.linuxidc.com:3000/ 然后将显示类似以下的屏幕：

Ubuntu 18.04 上安装搭建私有 Git 服务器 Gitea

数据库设置：

数据库类型：SQLite3
路径：使用绝对路径 /var/lib/gitea/data/gitea.db

应用程序常规设置：

站点名称：您可以在此输入您公司的名称。
存储库根路径：保留默认的 /home/git/gitea-repositories。
Git LFS 根路径：保留默认的 /var/lib/gitea/data/lfs。
以用户名运行：git
SSH 服务器域：输入您的域或服务器 IP 地址。
SSH 端口：22，如果 SSH 正在侦听其他端口，请更改它
Gitea HTTP 侦听端口：3000
Gitea 基本 URL：使用 http 和您的域或服务器 IP 地址。
日志路径：保留默认的 /var/lib/gitea/log

您可以随时通过编辑 Gitea 配置文件来更改设置。

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

点击“立即注册”链接。第一个注册用户将自动添加到 Admin 组。

Ubuntu 18.04 上安装搭建私有 Git 服务器 Gitea

使用以下命令将 Gitea 配置文件的权限更改为只读：

[linuxidc@linux:~/www.linuxidc.com]$ sudo chmod 750 /etc/gitea

[linuxidc@linux:~/www.linuxidc.com]$ sudo chmod 640 /etc/gitea/app.ini

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

将 Nginx 配置为 SSL/TLS 代理(termination proxy)

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

首先，安装 Nginx 并使用以下指南生成免费的“加密 SSL”证书：

https://www.linuxidc.com/Linux/2018-05/152257.htm

https://www.linuxidc.com/Linux/2020-02/162228.htm

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

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

server {listen 80;
    server_name git.linuxidc.com;

    include snippets/letsencrypt.conf;
    return 301 https://git.linuxidc.com$request_uri;
}

server {listen 443 ssl http2;
    server_name git.linuxidc.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/git.linuxidc.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/git.linuxidc.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/git.linuxidc.com/chain.pem;
    include snippets/letsencrypt.conf;
    include snippets/ssl.conf;

    # log files
    access_log /var/log/nginx/git.linuxidc.com.access.log;
    error_log /var/log/nginx/git.linuxidc.com.error.log;

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