mirror of
https://github.com/8butubb/8butubb.github.io.git
synced 2026-10-12 16:30:03 +08:00
374 lines
8.5 KiB
Markdown
374 lines
8.5 KiB
Markdown
---
|
||
title: gitea 自部署使用体验
|
||
tags: ["git","docker"]
|
||
date: 2025-11-27
|
||
summary: "本文基于 Docker Compose 一键启动 Gitea + Gitea Runner 的实战记录。"
|
||
---
|
||
|
||
> 注意：本文基于 Docker Compose 一键启动 Gitea + Gitea Runner 的实战记录。
|
||
|
||
## 为什么使用 gitea
|
||
使用 gitea，主要原因是它的内存占用低，只有100 M 左右，而 gitlab 官方推荐的最小配置是 4 G 内存。github 在大多数区域访问速度较慢，而 gitea 可以在自部署的情况下，提供与 github 相同的功能。
|
||
|
||
## 架构速览
|
||
|
||
Gitea 采用微内核 + 插件扩展的轻量架构，核心组件如下：
|
||
|
||
1. **Web 服务层**
|
||
- 基于 Go 的 HTTP 服务（Gin 框架）
|
||
- 提供 Web UI、REST & Git 协议入口
|
||
|
||
2. **业务逻辑层**
|
||
- 路由与中间件（鉴权、CSRF、Session）
|
||
- 仓库管理（Git 命令封装、钩子触发）
|
||
- 组织/用户/权限模型（RBAC）
|
||
|
||
3. **存储层**
|
||
- **SQLite**（默认，单文件零配置）
|
||
- **MySQL / PostgreSQL**（生产推荐）
|
||
- 文件系统：Git 裸仓库、LFS 对象、头像、日志
|
||
|
||
4. **后台任务**
|
||
- 定时器：镜像同步、归档清理、统计更新
|
||
- 队列：邮件、WebHook、索引构建
|
||
|
||
5. **可选扩展**
|
||
- **Gitea Runner**：基于 act（兼容 GitHub Actions）的 CI 执行器
|
||
- **包管理**：npm、maven、nuget、docker registry 统一入口
|
||
|
||
### 架构图（Mermaid）
|
||
|
||
```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** 采用分层架构设计，各层职责清晰：
|
||
|
||
1. **客户端层**：支持 Web 浏览器、Git 客户端和 API 客户端访问
|
||
2. **负载均衡层**：可通过 Nginx/Apache 实现反向代理和负载均衡
|
||
3. **核心服务层**：提供 Web UI、API 接口和 Git 协议支持
|
||
4. **业务逻辑层**：处理仓库、用户、组织管理和权限控制
|
||
5. **数据存储层**：支持多种数据库和文件系统存储
|
||
6. **后台任务**：负责定时任务、队列处理和同步操作
|
||
7. **扩展功能**：提供 CI/CD、包管理和代码搜索等可选功能
|
||
|
||
这种架构设计使得 Gitea 具有轻量级、高可用和易扩展的特点。
|
||
|
||
```mermaid
|
||
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 官方文档](https://docs.docker.com/get-docker/)
|
||
|
||
```yaml
|
||
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 中注册时会替换。
|
||
|