如何在 CentOS 8 上使用 HTTPS 安装 Gitea 代码托管平台

在此页

要求
第 1 步：准备系统
第 2 步：数据库设置
第 3 步：安装 Gitea
第 4 步：配置 Gitea
第 5 步：反向代理设置
可选步骤
1. 记录配置
2. 独立的 SSH 服务器
Gitea 是一个用 Go 编写的代码托管 Web 应用程序。顾名思义，它旨在与流行的源代码控制程序 Git 一起使用，类似于 Gitlab 和 Github。本指南将解释在 CentOS 8 上使用 Nginx HTTPS 反向代理安装 Gitea。
要求
- 您拥有 root 权限的 CentOS 8 系统。
- 指向您的服务器的注册域名。
- $EDITOR 环境变量应设置为您首选的文本编辑器。
- 访问 SMTP 服务器以获取电子邮件通知（可选）。
确保您的（子）域指向带有 A 记录的服务器的 IPv4 地址。（可选）创建指向您的服务器 IPv6 地址的 AAAA 记录。
注意：本指南假定 SELinux 设置为禁用或允许。
第 1 步：准备系统
首先安装任何可用的更新并重新启动：
```
dnf update -y
reboot
```
对于此设置，需要几个软件组件：
- Git，Gitea 的依赖项。
- PostgreSQL，因为 Gitea 需要一个数据库。
- Nginx，将用作反向代理。
- Sudo，以 postgres 系统用户身份运行命令。
- Wget
- Certbot，一种用于获取 Lets Encrypt SSL 证书的实用程序。 Certbot 将单独安装，因为它在 CentOS 软件存储库中不可用。
安装它们如下：
```
dnf install -y git postgresql postgresql-server nginx sudo wget
```
Certbot-auto 是一个管理 certbots 安装的脚本。下载它：
```
wget https://dl.eff.org/certbot-auto -O /usr/local/bin/certbot-auto
```
确保设置了正确的权限：
```
chmod 0755 /usr/local/bin/certbot-auto
```
运行以下命令安装 certbot。包管理器将提示您确认安装依赖项，回答 y。
```
certbot-auto --install-only
```
接下来，创建一个用户来运行 Gitea：
```
useradd --system --shell /bin/bash --create-home --home-dir /home/gitea gitea
```
然后为Gitea创建目录结构：
```
mkdir -p /var/lib/gitea/{data,log} /etc/gitea /run/gitea
```
并设置所有权和权限如下：
```
chown -R gitea:gitea /var/lib/gitea
chown -R gitea:gitea /var/run/gitea
chown -R root:gitea /etc/gitea
chmod -R 750 /var/lib/gitea
chmod 770 /etc/gitea
```
/etc/gitea 的权限是临时的，运行 web 安装程序后会收紧。
永久启用到端口 80 和 443 的流量：
```
firewall-cmd --add-port 80/tcp --add-port 443/tcp --permanent
firewall-cmd --reload
```
初始设置仅临时需要访问端口 3000，因为我们将 gitea 配置为使用 Unix 套接字。
```
firewall-cmd --add-port 3000/tcp
```
第 2 步：数据库设置
初始化 Postgres：
```
postgresql-setup --initdb --unit postgresql
```
确保它已启用并正在运行：
```
systemctl enable --now postgresql.service
```
登录到 Postgres：
```
sudo -u postgres psql
```
然后创建一个用户角色和数据库供Gitea使用：
```
postgres=# CREATE ROLE gitea LOGIN ENCRYPTED PASSWORD 'your_password';
postgres=# CREATE DATABASE gitea;
postgres=# GRANT ALL PRIVILEGES ON DATABASE gitea TO gitea;
postgres=# \q
```
打开 Postgres 客户端认证配置文件：
```
$EDITOR /var/lib/pgsql/data/pg_hba.conf
```
在 #IPv4 local connections 之后添加以下行：
```
# IPv4 local connections:
host	gitea		gitea		127.0.0.1/32		md5
```
保存文件并重启 Postgres：
```
systemctl restart postgresql.service
```
第三步：安装 Gitea
从 Giteas 下载页面下载 Gitea 的 linux-amd64 二进制版本。例如：
```
wget https://dl.gitea.io/gitea/master/gitea-master-linux-amd64 -O /usr/local/bin/gitea
```
为下载的二进制文件设置正确的权限：
```
chmod 755 /usr/local/bin/gitea
```
接下来，创建一个 systemd 单元文件：
```
$EDITOR /etc/systemd/system/gitea.service
```
并输入以下内容：
```
[Unit]
Description=Gitea (Git with a cup of tea)
After=syslog.target
After=network.target
Requires=postgresql.service
[Service]
Type=simple
User=gitea
Group=gitea
WorkingDirectory=/var/lib/gitea/
RuntimeDirectory=gitea
ExecStart=/usr/local/bin/gitea web -c /etc/gitea/app.ini
Restart=always
Environment=USER=gitea HOME=/home/gitea GITEA_WORK_DIR=/var/lib/gitea
[Install]
WantedBy=multi-user.target
```
确保已加载新单元：
```
systemctl daemon-reload
```
然后指示 systemd 在启动时启动 Gitea：
```
systemctl enable gitea.service
```
第 4 步：配置 Gitea
对于初始配置，我们将使用包含的 Web 安装程序。首先，启动 Gitea：
```
systemctl start gitea.service
```
然后导航到 http://your_domain:3000/install 并填写所需参数，如下所示：
- 数据库类型：PostgreSQL
- 主机：127.0.0.1:5432
- 用户名：gitea
- 密码：输入您在创建 Postgres 角色时选择的密码。
- 数据库名称：gitea
- SSL：禁用
- 网站标题：您选择的标题。
- 存储库根路径：/var/lib/gitea/data/repositories
- Git LFS 根路径：/var/lib/gitea/data/lfs
- 以用户名运行：gitea
- SSH 服务器域：your_domain
- SSH 服务器端口：22
- Gitea HTTP 监听帖子：3000
- Gitea 基本 URL：https://your_domain/
- 日志路径：/var/lib/gitea/log
根据需要配置电子邮件和其余设置，然后单击“安装 Gitea”。您将被重定向到错误的 URL。这是正常的，因为我们还没有配置 Nginx 或 HTTPS。出于性能原因，我们现在将配置 Gitea 以侦听 unix 套接字而不是默认的 TCP 端口。
在继续之前停止 Gitea：
```
systemctl stop gitea.service
```
如下所示加强 /etc/gitea 的权限。这可以防止不在 gitea 组中的任何人读取 app.ini ，其中包含敏感信息，包括数据库凭据。
```
chmod 750 /etc/gitea
chown root:gitea /etc/gitea/app.ini
chmod 640 /etc/gitea/app.ini
```
打开它的配置文件：
```
$EDITOR /etc/gitea/app.ini
```
从服务器部分删除以下行：
```
HTTP_PORT = 3000
```
并在服务器部分添加以下行：
```
HTTP_ADDR        = /run/gitea/gitea.sock
PROTOCOL         = unix
UNIX_SOCKET_PERMISSION = 666
```
第 5 步：反向代理设置
如果 Nginx 正在运行，请停止它，以允许 certbot 侦听端口 80：
```
systemctl stop nginx.service
```
使用以下命令为您的域获取证书：
```
certbot-auto certonly --standalone --agree-tos -m  -d your_domain
```
Lets Encrypt 将在颁发证书之前验证域所有权。您的证书、链和私钥将存储在 /etc/letsencrypt/live/your_domain/ 中。
我们现在可以配置 Nginx。创建一个新的配置文件：
```
$EDITOR /etc/nginx/conf.d/gitea.conf
```
并输入以下服务器块：
```
server {
        listen 80;
        listen [::]:80;
        server_name your_domain;
        return 301 https://$server_name$request_uri;
	access_log /var/log/nginx/gitea-proxy_access.log;
	error_log /var/log/nginx/gitea-proxy_error.log;
}
server {
        listen 443 ssl;
        listen [::]:443 ssl;
        server_name your_domain;
        ssl on;
        ssl_certificate /etc/letsencrypt/live/your_domain/fullchain.pem;
        ssl_certificate_key /etc/letsencrypt/live/your_domain/privkey.pem;
        location / {
                proxy_pass http://unix:/var/run/gitea/gitea.sock;
	}
	access_log /var/log/nginx/gitea-proxy_access.log;
	error_log /var/log/nginx/gitea-proxy_error.log;
}
```
第一个服务器块只是用于将所有 HTTP 请求重定向到 HTTPS。第二个块侦听 HTTPS 连接并将它们代理到我们已将 Gitea 配置为侦听的 Unix 套接字。
保存上述配置后，检查是否存在任何语法错误并在必要时编辑您的配置：
```
nginx -t
```
最后，启动 Nginx 和 Gitea：
```
systemctl start nginx.service gitea.service
```
您的 Gitea 实例现在应该已成功运行。在 https://your_domain 访问它
可选步骤
记录配置
默认情况下，Giteas 会记录严重级别为 Info 及以上的消息。您很可能希望将其更改为 Warn 或 Error 。为此，打开 /etc/gitea/app.ini 并将 [log] 部分中的 LEVEL 参数更改为以下之一：trace、debug、info、warn、error、critical、fatal、none。例如，要记录严重程度为 Warn 及以上的消息，请使用：
```
[log]
MODE = file
LEVEL = warn
ROOT_PATH = /var/lib/gitea/log
```
重启 Gitea 使更改生效：
```
systemctl restart gitea.service
```
单独的 SSH 服务器
Gitea 也可以使用它自己的 SSH 服务器。要启用它，请将以下行添加到 [server] 配置部分：
```
START_SSH_SERVER = true
```
并将 SSH 端口更改为 1024 以上的任意数字，例如：
```
SSH_PORT = 2222
```
然后重新启动 Gitea 以应用更改并启用到所选端口的流量：
```
firewall-cmd --add-port 2222/tcp --permanent
firewall-cmd --reload
```

如何在 CentOS 8 上使用 HTTPS 安装 Gitea 代码托管平台

在此页

要求

第 1 步：准备系统

第 2 步：数据库设置

第三步：安装 Gitea

第 4 步：配置 Gitea

第 5 步：反向代理设置

可选步骤

记录配置

单独的 SSH 服务器