123 lines
3.2 KiB
Markdown
123 lines
3.2 KiB
Markdown
# Gitea 局域网部署设计
|
||
|
||
## 概述
|
||
|
||
使用 Docker Compose 在局域网中部署 Gitea Git 服务，支持 HTTP 和 SSH 访问，启用 Git LFS 支持。
|
||
|
||
## 需求
|
||
|
||
- 仅局域网使用
|
||
- Docker Compose 容器化部署
|
||
- 数据库：SQLite（简单可靠）
|
||
- 访问方式：HTTP + SSH
|
||
- 端口配置：通过 `.env` 文件灵活配置
|
||
- 数据存储：宿主机目录挂载
|
||
- 支持 Git LFS
|
||
- 镜像版本：固定版本（避免 latest）
|
||
|
||
## 技术选型
|
||
|
||
| 组件 | 选择 | 说明 |
|
||
|-----|------|-----|
|
||
| Gitea 版本 | 1.25.4 | 当前最新稳定版 |
|
||
| 数据库 | SQLite | 零配置，适合小规模使用 |
|
||
| 容器镜像 | gitea/gitea:1.25.4 | 官方镜像，固定版本 |
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
gitea/
|
||
├── docker-compose.yml # 容器编排配置
|
||
├── .env # 环境变量（端口等配置）
|
||
├── .gitignore # 忽略数据目录和敏感文件
|
||
└── data/ # Gitea 数据（挂载目录）
|
||
├── git/ # Git 仓库数据
|
||
│ ├── repositories/ # 仓库存储
|
||
│ └── lfs/ # LFS 文件存储
|
||
├── gitea/ # Gitea 配置和数据库
|
||
│ ├── gitea.db # SQLite 数据库（用户数据）
|
||
│ └── conf/app.ini # 配置文件
|
||
└── ssh/ # SSH 密钥
|
||
```
|
||
|
||
## 配置文件
|
||
|
||
### .env - 环境变量
|
||
|
||
```env
|
||
# 镜像版本
|
||
GITEA_VERSION=1.25.4
|
||
|
||
# 端口配置
|
||
HTTP_PORT=3000
|
||
SSH_PORT=2222
|
||
|
||
# 时区
|
||
TZ=Asia/Shanghai
|
||
|
||
# Git LFS 配置
|
||
GITEA__lfs__START_SERVER=true
|
||
GITEA__lfs__PATH=/data/git/lfs
|
||
```
|
||
|
||
### docker-compose.yml
|
||
|
||
- 镜像：`gitea/gitea:${GITEA_VERSION}`
|
||
- 端口映射：
|
||
- `${HTTP_PORT}:3000` - Web 界面和 HTTP Git 操作
|
||
- `${SSH_PORT}:22` - SSH Git 操作
|
||
- 数据卷挂载：`./data:/data`
|
||
- 环境变量：从 `.env` 文件读取
|
||
- 重启策略：`always`
|
||
- 网络：bridge 模式
|
||
|
||
### .gitignore
|
||
|
||
忽略 `data/` 目录和 `.env` 文件（避免敏感信息提交）
|
||
|
||
## 数据存储说明
|
||
|
||
| 数据类型 | 容器内路径 | 宿主机路径 |
|
||
|---------|-----------|-----------|
|
||
| 用户账户、权限 | /data/gitea/gitea.db | ./data/gitea/gitea.db |
|
||
| Git 仓库 | /data/git/repositories/ | ./data/git/repositories/ |
|
||
| SSH 密钥 | /data/git/.ssh/ | ./data/git/.ssh/ |
|
||
| LFS 文件 | /data/git/lfs/ | ./data/git/lfs/ |
|
||
| 配置文件 | /data/gitea/conf/app.ini | ./data/gitea/conf/app.ini |
|
||
|
||
## 使用方式
|
||
|
||
### 启动服务
|
||
|
||
```bash
|
||
docker compose up -d
|
||
```
|
||
|
||
### 访问方式
|
||
|
||
- Web 界面：`http://<服务器IP>:3000`
|
||
- HTTP 克隆：`git clone http://<服务器IP>:3000/用户/仓库.git`
|
||
- SSH 克隆：`git clone ssh://git@<服务器IP>:2222/用户/仓库.git`
|
||
|
||
### 初始配置
|
||
|
||
首次访问 Web 界面会进入安装向导，需要：
|
||
1. 设置管理员账户
|
||
2. 配置服务器域名等基本信息
|
||
3. 数据库已使用 SQLite，无需额外配置
|
||
|
||
### 备份
|
||
|
||
备份 `./data/` 目录即可，特别是：
|
||
- `./data/gitea/gitea.db` - 用户和配置数据
|
||
- `./data/git/repositories/` - 仓库数据
|
||
- `./data/git/lfs/` - LFS 文件
|
||
|
||
## 文件清单
|
||
|
||
需要创建的文件：
|
||
1. `docker-compose.yml` - Docker Compose 配置
|
||
2. `.env` - 环境变量配置
|
||
3. `.gitignore` - Git 忽略规则
|
||
4. `README.md` - 使用说明文档
|