# Gitea Docker 部署

使用 Docker Compose 部署 Gitea，支持两种模式：

- **HTTP 模式**：Gitea 直接暴露端口，仅 HTTP
- **Caddy 模式**：通过 Caddy 反向代理，同时支持 HTTP 和 HTTPS（自动证书）

## 架构

### HTTP 模式（默认）

```
Client → Gitea (HTTP_PORT, e.g. 3000)
          Gitea SSH (22 → 宿主机 SSH_PORT)
```

### Caddy 模式（--profile caddy）

```
Client → Caddy (80/443, HTTP + HTTPS) → Gitea (3000, Docker 内部网络)
                                        Gitea SSH (22 → 宿主机 SSH_PORT)
```

## 快速开始

### 前提条件

- 服务器 `SSH_PORT`（默认 2222）端口可从外网访问
- 如使用 Caddy 模式：域名已解析到服务器公网 IP，且 80、443 端口可从外网访问

### 1. 配置环境变量

```bash
cp .env.example .env
```

编辑 `.env`，关键配置：

```env
DOMAIN=git.example.com    # 你的域名
SSH_PORT=2222             # SSH 端口（宿主机端口，容器内仍为 22）
```

#### HTTP 模式

```env
ROOT_URL=http://git.example.com:3000/
```

#### Caddy 模式

```env
ROOT_URL=https://git.example.com/
```

### 2. 启动服务

```bash
# HTTP 模式（仅 Gitea，无 Caddy）
docker compose up -d

# Caddy 模式（HTTP + HTTPS，Caddy 反向代理）
docker compose --profile caddy up -d
```

> Caddy 会自动为 `DOMAIN` 申请 Let's Encrypt 证书，稍等片刻后即可通过 HTTPS 访问。

### 3. 初始配置

首次访问会进入安装向导：

1. 设置管理员账户
2. 数据库已默认使用 SQLite

## 访问方式

### HTTP 模式

| 方式 | 地址 |
|-----|------|
| Web 界面 | `http://<DOMAIN>:<HTTP_PORT>` |
| HTTP 克隆 | `git clone http://<DOMAIN>:<HTTP_PORT>/<用户>/<仓库>.git` |
| SSH 克隆 | `git clone ssh://git@<DOMAIN>:<SSH_PORT>/<用户>/<仓库>.git` |

### Caddy 模式

| 方式 | 地址 |
|-----|------|
| Web 界面 | `https://<DOMAIN>` |
| HTTP 克隆 | `git clone http://<DOMAIN>/<用户>/<仓库>.git` |
| HTTPS 克隆 | `git clone https://<DOMAIN>/<用户>/<仓库>.git` |
| SSH 克隆 | `git clone ssh://git@<DOMAIN>:<SSH_PORT>/<用户>/<仓库>.git` |

## Git LFS

已启用 Git LFS 支持，使用方法：

```bash
git lfs install
git lfs track "*.psd"
git add .gitattributes
git commit -m "Track PSD files with LFS"
git push
```

## 数据备份

备份 `data/` 目录：

```bash
# 备份
tar -czvf gitea-backup-$(date +%Y%m%d).tar.gz data/

# 恢复
tar -xzvf gitea-backup-20260320.tar.gz
```

重要文件：

- `data/gitea/gitea.db` - 用户和配置数据
- `data/git/repositories/` - 仓库数据
- `data/git/lfs/` - LFS 文件

## 常用命令

```bash
# 启动（HTTP 模式）
docker compose up -d

# 启动（Caddy 模式）
docker compose --profile caddy up -d

# 停止
docker compose down

# 查看日志
docker compose logs -f

# 查看 Caddy 日志
docker compose logs -f caddy

# 重启
docker compose restart

# 更新版本
# 修改 .env 中的 GITEA_VERSION 后
docker compose up -d
```