Gitea - RuoXI'Blog

RuoXI

公告

欢迎访问我的博客！

关于我

标签

781 字

4 分钟

Gitea

2026-03-31

项目

若汐

/

项目

一、Gitea 简介#

Gitea 是一个轻量级、自托管的 Git 服务，采用 Go 语言编写，支持跨平台运行（Linux/macOS/Windows）。它提供代码托管、Issue 跟踪、Pull Request、Wiki 等完整功能，适合个人开发者或中小团队搭建私有代码仓库。

硬件要求：

最低配置：1核 CPU，512MB 内存
推荐配置：2核 CPU，2GB 内存
磁盘空间：至少 1GB 可用空间

二、安装部署#

方式一：二进制文件安装（Linux）#

1
# 1. 下载二进制文件
2
wget -O /tmp/gitea https://dl.gitea.com/gitea/1.25.5/gitea-1.25.5-linux-amd64
3

4
# 2. 移动到系统目录
5
sudo mv /tmp/gitea /usr/local/bin
6
sudo chmod +x /usr/local/bin/gitea
7

8
# 3. 创建专用用户和目录
9
sudo adduser --system --group --disabled-password --shell /bin/bash --home /home/gitea gitea
10
sudo mkdir -p /var/lib/gitea/{custom,data,log}
11
sudo chown -R gitea:gitea /var/lib/gitea/
12
sudo mkdir /etc/gitea
13
sudo chown root:gitea /etc/gitea
14
sudo chmod 770 /etc/gitea

方式二：Windows 安装#

从官网下载 Windows 版本的 .exe 文件
在非系统盘新建文件夹（如 D:\gitea）
在该文件夹下新建 data 子文件夹
双击运行 .exe 文件
浏览器访问 http://localhost:3000 完成初始化配置

三、初始化配置#

首次访问 http://服务器IP:3000 会进入安装向导：

数据库设置：选择 SQLite（简单）或 MySQL/PostgreSQL（生产环境）推荐使用MySQL，配置也不难 Win系统可以使用XAMPP来运行MySQL 点击 MySQL 后面的 “Admin” 按钮，会打开浏览器进入 phpMyAdmin 点击 "数据库" → 输入名称 gitea → 点击 "创建" 只需要创建空数据库，不用建表，Gitea 会自动创建
基本信息：
- 站点标题
- 仓库根目录
- 运行用户（Linux 建议 git 或 gitea）
管理员账号：创建第一个管理员账户
点击”Install Gitea”完成安装

四、日常使用#

1. 创建仓库#

登录后点击右上角 ”+” 按钮
选择”新建仓库”
填写仓库名称、描述
选择可见性（公开/私有）
勾选”初始化仓库”（可选添加 README、.gitignore、许可证）

2. 本地代码推送#

1
# 克隆仓库到本地
2
git clone http://your-gitea-server/username/repo.git
3

4
# 或关联现有项目
5
git remote add origin http://your-gitea-server/username/repo.git
6

7
# 推送代码
8
git add .
9
git commit -m "Initial commit"
10
git push -u origin master

3. 添加 SSH 密钥（免密登录）#

本地生成 SSH 密钥：
```
1
ssh-keygen -t rsa -b 4096
```
复制公钥内容（~/.ssh/id_rsa.pub）
在 Gitea 网页端：设置 → SSH/GPG密钥 → 增加密钥
添加后可直接使用 SSH 地址克隆，无需输入密码

4. 团队协作功能#

Issue 跟踪：创建问题、分配标签、设置里程碑
Pull Request：代码审查、分支合并
Wiki：项目文档管理
组织管理：创建组织、团队，分配权限

五、高级配置#

配置文件位置#

主配置文件 app.ini 通常位于：

Linux: /etc/gitea/app.ini 或 /var/lib/gitea/custom/conf/app.ini
Windows: gitea\custom\conf\app.ini

常用配置项#

1
[server]
2
DOMAIN = git.example.com
3
ROOT_URL = https://git.example.com/
4
HTTP_PORT = 3000
5

6
[database]
7
DB_TYPE = mysql
8
HOST = localhost:3306
9
NAME = gitea
10
USER = gitea
11
PASSWD = password
12

13
[mailer]
14
ENABLED = true
15
HOST = smtp.example.com:587
16
FROM = noreply@example.com

设置系统服务（Linux）#

创建 systemd 服务文件 /etc/systemd/system/gitea.service：

1
[Unit]
2
Description=Gitea
3
After=syslog.target network.target
4

5
[Service]
6
User=gitea
7
Group=gitea
8
WorkingDirectory=/var/lib/gitea
9
ExecStart=/usr/local/bin/gitea web -c /etc/gitea/app.ini
10
Restart=always
11

12
[Install]
13
WantedBy=multi-user.target

启用并启动服务：

1
sudo systemctl daemon-reload
2
sudo systemctl enable gitea
3
sudo systemctl start gitea

Windows 注册为服务#

使用 NSSM 工具：

1
nssm.exe install gitea
2
# 选择 Gitea 可执行文件路径，点击安装