# Gitea 部署指南

> 2026-08-13 记录。自托管轻量 Git 服务，个人代码仓库，Web 用 Caddy 反代套 HTTPS。域名域名 `git.hyonglin.top`。

---

## 选型

| 方案 | 是否选用 | 原因 |
|---|---|---|
| **Gitea** | ✅ | Go 单二进制，轻量（~50–100MB），功能全（仓库/Issue/PR/Actions/Package），社区活跃、安全更新及时 |
| Gogs | ❌ | Gitea 的 fork 前身，开发停滞，新项目不推荐 |
| 裸仓库+SSH | ❌ | 无 Web 界面 |

> Gitea 是 Gogs 的 fork（社区驱动），新项目无脑选 Gitea；若更在意「纯社区治理」可选 Forgejo。

---

## docker-compose 服务

`silverbullet/docker-compose.yml`：

```yaml
  gitea:
    image: gitea/gitea:latest
    container_name: gitea
    restart: unless-stopped
    environment:
      - USER_UID=1000
      - USER_GID=1000
      - GITEA__server__ROOT_URL=https://git.hyonglin.top/
      - GITEA__server__DOMAIN=git.hyonglin.top
      - GITEA__server__SSH_DOMAIN=git.hyonglin.top
      - GITEA__server__SSH_PORT=2222
    ports:
      - "2222:22"          # SSH clone 用（服务器 22 已被 SSH 占用，故映射 2222）
    volumes:
      - ./gitea:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
```

- Web（3000）不映射端口，由 Caddy 反代 `gitea:3000`
- SSH 需映射 `2222:22`，因为宿主机 22 被 OpenSSH 占用

## Caddy 反代

`silverbullet/Caddyfile` 加一段：

```caddyfile
# Git 服务
git.hyonglin.top {
    tls {
        dns cloudflare {env.CF_API_TOKEN}
    }
    reverse_proxy gitea:3000
}
```

## compose 部署

```bash
docker compose up -d gitea
docker compose up -d --force-recreate caddy   # 让 caddy 加载新站点
```

---

## 首次安装（web 向导）

打开 `https://git.hyonglin.top` 走安装向导：

- **数据库**：默认 `SQLite3`（个人用足够）
- **域名/URL**：环境变量已预设（`git.hyonglin.top`），保持默认
- **SSH 端口**：`2222`
- **管理员账号**：设置用户名/邮箱/密码
- 点「安装 Gitea」

验证安装完成：

```bash
# app.ini 应已锁定安装
grep INSTALL_LOCK /home/ubuntu/silverbullet/gitea/gitea/conf/app.ini   # → true

# 确认管理员存在
docker compose exec -T gitea su git -c "gitea admin user list"
```

---

## 使用

- **Web**：登录 `https://git.hyonglin.top` 建仓库
- **HTTPS clone**：`git clone https://git.hyonglin.top/用户名/仓库.git`
- **SSH clone**：`git clone git@git.hyonglin.top:2222/用户名/仓库.git`（需安全组放行 TCP 2222）
- **备份**：备份 `silverbullet/gitea` 目录（含数据库和所有仓库）

---

## 相关链接

- [[主页与Caddy反向代理]] — git.hyonglin.top 的 HTTPS 入口
- [[frp内网穿透部署指南]] — 本服务器其他自建服务
- [Gitea 官方文档](https://docs.gitea.com/zh-cn/)