# CT124 Gitea(自架 Git 服務)— 操作手冊

> 主機:CT124（192.168.42.124，Ubuntu 24.04 LXC）　|　位置:`/opt/gitea`
> 用途:自架 Git 託管(本 `42_124` repo 即放在此:`http://192.168.42.124:31337/timmy/42_124`)

---

## 一、基本資訊

- 版本:**Gitea 1.25.4** + **PostgreSQL 14**（`gitea/gitea:latest`、`postgres:14`）
- 容器:`gitea`、`gitea-db-1`（皆 `restart: always`,共用內網 `gitea`）
- 埠:`31337 → 3000`（Web）、`31338 → 22`（Git over SSH）
- 對外:**僅 LAN**（`git/gitea.lotimmy.com` 皆不解析,`ROOT_URL=http://192.168.42.124:31337/`）
- 註冊:`DISABLE_REGISTRATION = false` → **開放註冊**(見注意事項)

## 二、操作

```bash
cd /opt/gitea
./start.sh                  # = docker-compose up -d
./stop.sh                   # = docker-compose down
docker compose logs -f
docker compose restart
```

## 三、存取與 clone

```bash
# Web
http://192.168.42.124:31337

# HTTP clone
git clone http://192.168.42.124:31337/<user>/<repo>.git

# SSH clone(注意走 31338,非 22)
git clone ssh://git@192.168.42.124:31338/<user>/<repo>.git
```

## 四、資料與設定

| 項目 | 位置 / 值 |
|---|---|
| Gitea 應用資料(repos/config/上傳) | `./data`(→ 容器 `/data`) |
| 設定檔 | `./data/gitea/conf/app.ini` |
| PostgreSQL 資料 | `./postgres` |
| DB 連線 | `db:5432`,gitea/gitea(內網,環境變數帶入) |

## 五、備份

> ⚠️ **舊 README 只 `tar data/` 不夠** —— 現在中繼資料在 PostgreSQL,光打包 `data/` 會缺 DB,
> 且對運行中的 `postgres/` 直接 tar 不保證一致。正確做法用 Gitea 內建 dump:

```bash
# 產出含 repos + DB + 設定的單一壓縮檔(寫到容器 /data,即 host ./data)
docker exec -u git gitea gitea dump -c /data/gitea/conf/app.ini
# 取出
mv /opt/gitea/data/gitea-dump-*.zip /opt/gitea/
```
（`gitea-backup-20260309.tar.gz` 是早期的 `tar data/` 手動備份,僅供參考。）

## 六、注意事項

- **開放註冊**:`DISABLE_REGISTRATION = false`,任何能連到 `:31337` 的人都能註冊帳號。雖僅 LAN,要鎖就在 `app.ini` 設 `DISABLE_REGISTRATION = true` 後 `docker compose restart`。
- SSH clone 必須用 **31338**;app.ini 的 `SSH_PORT = 22` 是容器內埠,Gitea 介面產生的 clone URL 可能顯示 22,手動改成 31338。
- `/opt/gitea` 自身是個 git repo(有自己的 `push.sh`/`CLAUDE.md`),其 remote 與 post-receive hook 是該部署目錄的設定,與使用者 repo 無關。