如何在 CentOS 8 上安装 Gitea

2023-11-10

Gitea 是一个用 Go 编写的自托管开源 git 服务器。它配备了存储库文件编辑器、项目问题跟踪、用户管理、通知、内置 wiki 等等。

Gitea是一个轻量级应用程序，可以安装在功能较弱的系统上。如果您正在寻找内存占用小得多的 Gitlab 替代方案，并且不需要 Gitlab 提供的所有功能，那么您应该尝试 Gitea。

本文向您展示如何在 CentOS 8 上安装和配置 Gitea。

先决条件#

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

我们将使用 SQLite。它是一个轻量级数据库，将数据存储在单个文件中。如果您的 CentOS 计算机上未安装 SQLite，您可以通过运行以下命令来安装它：须藤用户 :

sudo dnf install sqlite

我们假设SELinux 被禁用或设置为宽容模式。

安装Gitea#

Gitea 可以从源代码、二进制文件或软件包的形式安装。它还可以部署为 Docker 映像。我们将使用二进制文件安装 Gitea。

安装Git#

第一步是安装Git在你的 CentOS 上：

sudo dnf install git

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

git --version

git version 2.18.4

创建 Git 用户#

创建新的系统用户运行 Gitea 应用程序：

sudo useradd \   --system \   --shell /bin/bash \   --comment 'Git Version Control' \   --create-home \   --home /home/git \   git

该命令将创建一个名为的新用户和组git，并将主目录设置为/home/git.

下载 Gitea 二进制文件#

最新的 Gitea 二进制文件可以从吉泰亚下载页面。确保为您的架构下载正确的二进制文件。

在撰写本文时，最新版本是 1.12.3。如果有新版本可用，请更改VERSION下面的命令中的变量。

Use wget下载 Gitea 二进制文件/tmp目录：

VERSION=1.12.3sudo wget -O /tmp/gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64

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

sudo mv /tmp/gitea /usr/local/bin

使二进制可执行文件：

sudo chmod +x /usr/local/bin/gitea

以下命令将创建必要的目录并设置所需的权限和所有权 :

sudo mkdir -p /var/lib/gitea/{custom,data,indexers,public,log}sudo chown git: /var/lib/gitea/{data,indexers,log}sudo chmod 750 /var/lib/gitea/{data,indexers,log}sudo mkdir /etc/giteasudo chown root:git /etc/giteasudo chmod 770 /etc/gitea

上面的目录结构是Gitea官方文档推荐的。

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

创建 Systemd 单元文件#

Gitea 提供了一个 Systemd 单元文件，该文件的配置与我们的设置相匹配。

将文件下载到/etc/systemd/system/目录，输入：

sudo wget https://raw.githubusercontent.com/go-gitea/gitea/master/contrib/systemd/gitea.service -P /etc/systemd/system/

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

sudo systemctl daemon-reloadsudo systemctl enable --now gitea

验证服务是否启动成功：

sudo systemctl status gitea

● gitea.service - Gitea (Git with a cup of tea)
   Loaded: loaded (/etc/systemd/system/gitea.service; enabled; vendor preset: enabled)
   Active: active (running) since Sat 2020-01-04 21:27:23 UTC; 3s ago
 Main PID: 14804 (gitea)
    Tasks: 9 (limit: 1152)
   CGroup: /system.slice/gitea.service
           └─14804 /usr/local/bin/gitea web --config /etc/gitea/app.ini
...

配置Gitea#

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

默认情况下，Gitea 监听端口上的连接3000在所有网络接口上。您需要配置您的firewall启用对 Gitea Web 界面的访问：

sudo firewall-cmd --permanent --zone=public --add-port=3000/tcpsudo firewall-cmd --reload

打开浏览器，输入http://YOUR_DOMAIN_IR_IP:3000/install，然后会出现初始配置页面：

填写必填字段，如下所示：

数据库设置：

数据库类型：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”按钮。安装是即时的。完成后，您将被重定向到登录页面。

单击“立即注册”链接。第一个注册用户会自动添加到管理员组。

为了使安装更加安全，请更改权限使用以下命令将 Gitea 配置文件设置为只读：

sudo chmod 750 /etc/giteasudo chmod 640 /etc/gitea/app.ini

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

将 Nginx 配置为 SSL 终止代理#

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

首先，安装 Nginx 并使用以下指南生成免费的 Let’s Encrypt SSL 证书：

如何在 CentOS 8 上安装 Nginx
在 CentOS 8 上使用 Let's Encrypt 保护 Nginx

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

sudo nano /etc/nginx/conf.d/git.example.com.conf

/etc/nginx/conf.d/git.example.com.conf

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

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

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

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

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

不要忘记将 git.example.com 替换为您的 Gitea 域，并设置 SSL 证书文件的正确路径。这HTTP 流量重定向到 HTTPS .

一旦完成，重启 Nginx 服务使更改生效：

sudo systemctl restart nginx

接下来，更改 Gitea 域和根 url。为此，请打开配置文件并编辑以下行：

sudo nano /etc/gitea/app.ini

/etc/gitea/app.ini

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

输入以下命令重新启动 Gitea 服务：

sudo systemctl restart gitea

至此，Gitea代理就配置完成了，您可以通过以下地址访问它：https://git.example.com

配置电子邮件通知#

对于要发送的通知电子邮件，您可以安装 Postfix 或使用事务性邮件服务，例如 SendGrid、MailChimp、MailGun 或 SES。

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

sudo nano /etc/gitea/app.ini

/etc/gitea/app.ini

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

确保您使用正确的 SMTP 服务器信息。

每次编辑时app.ini文件中，您需要重新启动 Gitea 服务才能使更改生效：

sudo systemctl restart gitea

要验证设置并发送测试电子邮件，请登录 Gitea 并转至：站点管理 > 配置 > SMTP 邮件程序配置。

Gitea 还允许您通过创建一个连接到 Slack网络钩子并向您发送通知松弛通道 .

升级Gitea#

升级到最新的 Gitea 版本是一项简单的任务。您只需下载并替换二进制文件。

停止 Gitea 服务：
```
sudo systemctl stop gitea
```

下载最新的 Gitea 二进制文件并将其移至/usr/local/bin目录：

VERSION=<THE_LATEST_GITEA_VERSION>wget -O /tmp/gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64sudo mv /tmp/gitea /usr/local/bin

使二进制可执行文件：
```
sudo chmod +x /usr/local/bin/gitea
```
重启Gitea服务：
```
sudo systemctl restart gitea
```

就是这样。

结论#

我们已经向您展示了如何在 CentOS 8 上安装 Gitea。您现在应该访问Gitea 文档页面并了解如何配置您的安装并创建您的第一个项目。

如果您有疑问，请随时在下面发表评论。

本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系:hwhale#tublm.com(使用前将#替换为@)

centOS

git

Gitea