准备工作

Gitea官方文档
文档 | Gitea 官方文档
https://docs.gitea.cn/

• 开启 3000 端口
• 检查是否安装 Git。要求 Git 版本 >= 2.0。
• Gitea 支持 PostgreSQL (>=10)、MySQL (>=5.7)、SQLite 和 MSSQL (>=2008R2 SP3) 这几种数据库

Git下载 | Git文档
https://git-scm.com/download/linux
https://git-scm.com/book/zh/v2

安装教程

在宝塔添加网站后，我们打开 SSH

cd /自己的站点目录
例如：cd /www/wwwroot/git.sfwww.cn
cd ..
chmod 777 ./git.sfwww.cn/

我们需要创建一个新用户，Gitea 不支持 root 用户启动

useradd gitea
passwd gitea
# 输入要设置的密码

usermod -a -G sudo gitea     # 将gitea添加到sudo组
# 如果提示没有sudo这组，用下面命令创建一下
groupadd sudo                # 创建sudo组

现在准备下载启动

cd /www/wwwroot/git.sfwww.cn
wget -O gitea https://dl.gitea.com/gitea/1.20.2/gitea-1.20.2-linux-amd64
chmod +x gitea

su gitea
./gitea web       # 启动Gitea
nohup ./gitea web &   # 后台启动Gitea

启动后输入：

IP:3000

进入安装界面。

按步骤填写即可。

然后我们打开宝塔的 反向代理，按图填写。

（这里插入你的截图）

保存就可以用域名访问了。

示例：
https://git.sfwww.cn/

文件上传限制解决

Gitea 默认对上传文件有以下限制：

• 单个文件不得超过 3MB
• 单次上传不得超过 5个文件

可以通过修改 git 根目录（或你设置的路径）下 custom/conf/app.ini 配置文件 来解除限制。

但很多版本的 app.ini 中没有相关设置，需要 手动添加配置项。

打开 app.ini，查找：

repository.upload

如果没有找到，在 [security] 的上面添加：

[repository.upload]
ENABLED = true
ALLOWED_TYPES =
FILE_MAX_SIZE = 1024
MAX_FILES = 100

说明：

• ENABLED：是否启用存储库文件上传（默认 true）
• ALLOWED_TYPES：允许上传的文件类型，留空为无限制（MIME 格式）
• FILE_MAX_SIZE：单个文件最大大小（单位 MB）
• MAX_FILES：单次上传文件数量