注意：本文基于 Docker Compose 一键启动 Gitea + Gitea Runner 的实战记录。
为什么使用 gitea#
使用 gitea，主要原因是它的内存占用低，只有100 M 左右，而 gitlab 官方推荐的最小配置是 4 G 内存。github 在大多数区域访问速度较慢，而 gitea 可以在自部署的情况下，提供与 github 相同的功能。
架构速览#
Gitea 采用微内核 + 插件扩展的轻量架构，核心组件如下：
-
Web 服务层
- 基于 Go 的 HTTP 服务（Gin 框架）
- 提供 Web UI、REST & Git 协议入口
-
业务逻辑层
- 路由与中间件（鉴权、CSRF、Session）
- 仓库管理（Git 命令封装、钩子触发）
- 组织/用户/权限模型（RBAC）
-
存储层
- SQLite（默认，单文件零配置）
- MySQL / PostgreSQL（生产推荐）
- 文件系统：Git 裸仓库、LFS 对象、头像、日志
-
后台任务
- 定时器：镜像同步、归档清理、统计更新
- 队列：邮件、WebHook、索引构建
-
可选扩展
- Gitea Runner：基于 act（兼容 GitHub Actions）的 CI 执行器
- 包管理：npm、maven、nuget、docker registry 统一入口
架构图（Mermaid）#
graph TB
subgraph "客户端层"
A[Web浏览器]
B[Git客户端]
C[API客户端]
end
subgraph "负载均衡/反向代理"
D[Nginx/Apache]
end
subgraph "Gitea核心服务"
E[Web服务<br/>Gin框架]
F[API服务<br/>RESTful]
G[Git服务<br/>SSH/HTTP]
H[认证授权<br/>Session/OAuth]
end
subgraph "业务逻辑层"
I[仓库管理]
J[用户管理]
K[组织管理]
L[权限控制<br/>RBAC]
M[WebHook]
N[邮件服务]
end
subgraph "数据存储层"
O[数据库<br/>SQLite/MySQL/PostgreSQL]
P[Git仓库<br/>文件系统]
Q[LFS对象存储]
R[缓存<br/>Redis/Memcached]
end
subgraph "后台任务"
S[定时任务<br/>Cron]
T[队列处理<br/>WebHook/邮件]
U[索引构建]
V[镜像同步]
end
subgraph "可选扩展"
W[Gitea Runner<br/>CI/CD]
X[包管理<br/>npm/docker/maven]
Y[代码搜索<br/>Bleve]
end
A --> D
B --> D
C --> D
D --> E
D --> F
D --> G
E --> H
F --> H
G --> H
H --> I
H --> J
H --> K
H --> L
I --> O
I --> P
J --> O
K --> O
L --> O
I --> Q
M --> T
N --> T
S --> V
U --> R
T --> N
W --> P
X --> Q
Y --> R
style A fill:#e1f5fe
style B fill:#e1f5fe
style C fill:#e1f5fe
style D fill:#fff3e0
style E fill:#f3e5f5
style F fill:#f3e5f5
style G fill:#f3e5f5
style H fill:#f3e5f5
style I fill:#e8f5e9
style J fill:#e8f5e9
style K fill:#e8f5e9
style L fill:#e8f5e9
style M fill:#e8f5e9
style N fill:#e8f5e9
style O fill:#ffebee
style P fill:#ffebee
style Q fill:#ffebee
style R fill:#ffebee
style S fill:#fce4ec
style T fill:#fce4ec
style U fill:#fce4ec
style V fill:#fce4ec
style W fill:#e0f2f1
style X fill:#e0f2f1
style Y fill:#e0f2f1架构说明#
Gitea 采用分层架构设计，各层职责清晰：
- 客户端层：支持 Web 浏览器、Git 客户端和 API 客户端访问
- 负载均衡层：可通过 Nginx/Apache 实现反向代理和负载均衡
- 核心服务层：提供 Web UI、API 接口和 Git 协议支持
- 业务逻辑层：处理仓库、用户、组织管理和权限控制
- 数据存储层：支持多种数据库和文件系统存储
- 后台任务：负责定时任务、队列处理和同步操作
- 扩展功能：提供 CI/CD、包管理和代码搜索等可选功能
这种架构设计使得 Gitea 具有轻量级、高可用和易扩展的特点。
graph TB
subgraph "客户端层"
A[Web浏览器]
B[Git客户端]
C[API客户端]
end
subgraph "负载均衡层"
D[Nginx/反向代理]
end
subgraph "Gitea核心服务"
E[Web服务<br/>Gin框架]
F[REST API]
G[Git协议处理器]
H[认证授权<br/>RBAC]
I[中间件<br/>CSRF/Session]
end
subgraph "业务逻辑层"
J[仓库管理]
K[用户/组织管理]
L[问题跟踪]
M[PR/MR流程]
N[WebHook系统]
O[通知系统]
end
subgraph "数据存储层"
P[Git仓库<br/>文件系统]
Q[SQLite/MySQL<br/>PostgreSQL]
R[LFS对象存储]
S[会话存储]
T[缓存Redis]
end
subgraph "后台服务"
U[定时任务<br/>镜像同步]
V[队列服务<br/>异步任务]
W[邮件服务]
X[索引构建]
end
subgraph "扩展组件"
Y[Gitea Runner<br/>CI/CD]
Z[包管理<br/>npm/maven]
AA[容器注册表]
end
A --> D
B --> D
C --> D
D --> E
D --> F
D --> G
E --> H
F --> H
G --> H
H --> I
I --> J
I --> K
I --> L
I --> M
I --> N
I --> O
J --> P
K --> Q
L --> Q
M --> P
N --> V
O --> W
V --> U
V --> X
V --> W
J --> Y
J --> Z
J --> AA
P --> R
Q --> S
Q --> T
style A fill:#e1f5fe
style B fill:#e1f5fe
style C fill:#e1f5fe
style D fill:#fff3e0
style E fill:#f3e5f5
style F fill:#f3e5f5
style G fill:#f3e5f5
style H fill:#f3e5f5
style I fill:#f3e5f5
style J fill:#e8f5e8
style K fill:#e8f5e8
style L fill:#e8f5e8
style M fill:#e8f5e8
style N fill:#e8f5e8
style O fill:#e8f5e8
style P fill:#fce4ec
style Q fill:#fce4ec
style R fill:#fce4ec
style S fill:#fce4ec
style T fill:#fce4ec
style U fill:#fff9c4
style V fill:#fff9c4
style W fill:#fff9c4
style X fill:#fff9c4
style Y fill:#e0f2f1
style Z fill:#e0f2f1
style AA fill:#e0f2f1架构特点说明#
1. 轻量级设计
- 单二进制文件部署，内存占用仅100M左右
- 内置Web服务器，无需额外HTTP服务
- SQLite零配置支持，适合个人和小团队
2. 模块化架构
- 核心服务与业务逻辑分离
- 插件化扩展机制
- 可选组件按需启用
3. 数据一致性
- Git裸仓库直接存储，保证数据完整性
- 数据库存储元数据，支持快速查询
- LFS支持大文件存储
4. 高可用支持
- 支持数据库主从复制
- 文件系统可对接分布式存储
- 会话和缓存支持外部存储
docker compose 部署#
docker 和 docker compose 的安装可以参考 docker 官方文档
networks:
gitea:
external: false
services:
gitea:
image: gitea/gitea:latest
container_name: gitea
environment:
- USER_UID=1000
- USER_GID=10
- GITEA__database__DB_TYPE=mysql
- GITEA__database__HOST=db:3306
- GITEA__database__NAME=gitea
- GITEA__database__USER=gitea
- GITEA__database__PASSWD=xxxxx
restart: always
networks:
- gitea
volumes:
- ./data:/data
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "23000:3000"
- "22222:22"
depends_on:
- db
db:
image: mysql:8
container_name: mysql-gitea
restart: always
environment:
- MYSQL_ROOT_PASSWORD=gitea
- MYSQL_USER=gitea
- MYSQL_PASSWORD=xxxxxx
- MYSQL_DATABASE=gitea
networks:
- gitea
volumes:
- ./mysql:/var/lib/mysql
runner:
image: gitea/act_runner:latest
container_name: runner
restart: always
depends_on:
- gitea
volumes:
- ./runner/data:/data
- ./runner/cache:/root/.cache
- ./runner/config.yaml:/config.yaml
- /var/run/docker.sock:/var/run/docker.sock
networks:
- gitea
environment:
- GITEA_INSTANCE_URL=http://gitea:3000/
- GITEA_RUNNER_REGISTRATION_TOKEN=xxxxxxx
- CONFIG_FILE=/config.yaml
- GITEA_RUNNER_NAME=docker-runner
- GITEA_RUNNER_LABELS=docker其中，runner 的 token可以先随便填一个，后面在 gitea 中注册时会替换。