在 Ubuntu 22.04 安装 Gitea 指南

参考官方文档写的指南，并写了一个可以用的 Systemd 服务。

【许可声明： MIT License】

参考文献： https://docs.gitea.com/zh-cn/installation/install-from-binary

Gitea是开源自托管Git服务器，简单、轻量级且易于配置。与Gogs是孪生兄弟，基于Gogs开发，由社区进行维护。

1. 准备环境

更新系统软件源：

sudo apt update

安装 wget ：

 sudo apt install wget

安装 Git ：

sudo apt install git

2. 安装和配置 MariaDB (MySQL) 服务器

Gitea 可以选择的数据库有： MySQL、SQLLite3、MariaDB 等。

下面以使用 MariaDB 为例：

sudo apt install mariadb-server

2.1 创建Gitea数据库

使用默认用户名和密码登录 MariaDB 服务器：
```
sudo mysql -u root -p
```
创建数据库：
```
CREATE DATABASE gitea;
```

创建用户名和密码：

GRANT ALL PRIVILEGES ON gitea.* TO 'gitea'@'localhost' IDENTIFIED BY "<Your_Password>";

保存 MySQL 设置：
```
FLUSH PRIVILEGES;
QUIT;
```

3. 安装 Gitea

下载最新的 Gitea 安装文件：

https://gitea.cn/gitea/gitea/releases

如（截至2025年05月24日最新发布的稳定版）：

wget https://gitea.cn/gitea/gitea/releases/download/v1.22.1/gitea-1.22.1-linux-amd64

添加可执行权限：
```
chmod +x gitea-1.22.1-linux-amd64
```

程序复制到系统目录：

cp gitea-1.22.1-linux-amd64 /usr/local/bin/gitea

检查 Gitea 版本：
```
gitea --version
```

4. 设置系统Git用户

在系统中，新建一个 git 用户：

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

创建 Gitea 工作目录：

sudo mkdir -pv /var/lib/gitea/{custom,data,log}

修改 Gitea 工作目录权限：

sudo chown -Rv git:git /var/lib/gitea
sudo chmod -Rv 750 /var/lib/gitea

创建 Gitea 的配置文件目录：
```
sudo mkdir -v /etc/gitea
```
设置配置文件权限：
```
sudo chown -Rv root:git /etc/gitea
```
现在允许通过以下命令更改配置目录的权限：
```
sudo chmod -Rv 770 /etc/gitea
```

5. 创建 Gitea 的 Systemd 服务

创建：/etc/system/system/gitea.service

编辑文件：

sudo vim /etc/systemd/system/gitea.service

编辑内容：

[Unit]
Description=Gitea
After=syslog.target
After=network.target
After=mysqld.service

[Service]
RestartSec=3s
Type=simple
User=git
Group=git
WorkingDirectory=/var/lib/gitea/

ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini
Restart=always
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea

[Install]
WantedBy=multi-user.target

测试（启动） Gitea 服务：
```
sudo systemctl start gitea
```
检查 Gitea 状态：
```
sudo systemctl status gitea
```

6. 设置系统开机服务

输入下列命令后，Gitea服务将加入系统开机任务。
```
sudo systemctl enable gitea
```

7. 配置 Gitea 服务器

可在 Web 浏览器中，访问地址 http://<IP>:3000 在线配置。
查看本机IP地址：
```
hostname -I
```

Kimi / Install Gitea Server in Ubuntu 22.04