Gitea: fix ROOT_URL / reverse-proxy headers so links use domain name instead of 192.168.1.96 #7

Closed
opened 2026-08-27 00:14:47 +02:00 by hermes · 1 comment
Contributor

Симптомы

  • Все ссылки в Gitea ведут на http://192.168.1.96/... вместо https://gitea.rudolf.keenetic.link/...
  • На странице логина — warning "The detected web site URL is unlikely matching the site config"
  • <meta property="og:url" content="http://192.168.1.96"> на главной

Корневая причина

Подтверждённая цепочка трафика:

client (из tailscale-сети, иначе нет маршрута в LAN)
  → Keenetic router: DNS resolve (gitea.rudolf.keenetic.link → 192.168.1.96) + Let's Encrypt TLS termination
    → plain HTTP на 192.168.1.96
      → swarm ingress-endpoint (10.0.0.2)
        → gitea_server (10.0.0.235)

Keenetic — потребительский роутер, proxy headers не передаёт. Поэтому gitea видит:

  • r.URL.Scheme = "http" (после TLS termination идёт plain HTTP)
  • r.Host = "192.168.1.96" (NAT-адрес, не домен)
  • r.RemoteAddr = "10.0.0.2" (swarm ingress)

Подтверждение из логов gitea:

HTTPRequest [I] router: completed GET / for 10.0.0.2:55642, 200 OK
HTTPRequest [I] router: completed GET /user/login for 10.0.0.2:55658, 200 OK

ROOT_URL и DOMAIN в текущем app.ini уже правильные (https://gitea.rudolf.keenetic.link/), но это не помогает — gitea использует request-derived URL для og:url и warning'а.

Топология (что я нашёл при разборе)

  • Image: docker.gitea.com/gitea:1.27.0, task gitea_server.1.fx8lrhxza6s7xhjeqr46oiioa на node odroid (id j9bljgaqh9qc)
  • Network: gitea_server в трёх overlay-сетях: gitea_gitea (10.0.17.13), ingress (10.0.0.235), nginx_ingress (10.0.3.134)
  • Compose: admin/ansible/poc/gitea/stack-compose.yml
  • Data: /data/gitea/conf/app.ini в named volume gitea_data (NFS на 192.168.1.96:/root/volumes/gitea)
  • nginx_nginx (jwilder/nginx-proxy) в compose есть, но Replicas: 0 — не запущен и не нужен. Keenetic уже делает TLS termination
  • Tailscale установлен на odroid (/etc/resolv.conf контейнеров содержит search anoa-bebop.ts.net), но DNS для gitea.rudolf.keenetic.link отвечает Keenetic, не tailscale. Tailscale — только транспорт для клиента

Фикс

Только правка app.ini (без нового nginx, без изменения DNS):

[server]
APP_DATA_PATH = /data/gitea
DOMAIN = gitea.rudolf.keenetic.link
SSH_DOMAIN = gitea.rudolf.keenetic.link
HTTP_PORT = 3000
ROOT_URL = https://gitea.rudolf.keenetic.link/
DISABLE_SSH = true
SSH_PORT = 22
SSH_LISTEN_PORT = 22
LFS_START_SERVER = true
PROTOCOL = https
REVERSE_PROXY_TRUSTED_PROXIES = *

LFS_JWT_SECRET = <из vault или env>

Что меняется:

  1. PROTOCOL = https — главный фикс. Заставляет gitea считать что приходит HTTPS даже при plain HTTP-сокете. Решает og:url = http://... и warning на login page.
  2. REVERSE_PROXY_TRUSTED_PROXIES = * (или конкретные подсети 192.168.1.0/24, 10.0.0.0/8) — без этого gitea отбрасывает все X-Forwarded-* headers. Сейчас headers не приходят, но это подстраховка и правильная гигиена.
  3. LFS_JWT_SECRET (и JWT_SECRET) переезжает в vault/env, не коммитится в открытом виде.

Что нужно сделать (порядок)

  1. Создать admin/ansible/poc/gitea/app.ini с содержимым выше (секреты — placeholder)
  2. Решить где хранить секреты: ansible-vault рядом с compose / env-переменные / генерация при первом deploy
  3. В stack-compose.yml добавить bind mount ./app.ini:/data/gitea/conf/app.ini:ro
  4. Удалить старый app.ini из volume (или docker service update --force после mount'а перезапишет)
  5. Переименовать poc/gitea/ → gitea/ (это prod, имя poc/ вводит в заблуждение) — отдельным PR или вместе
  6. Верификация после deploy:
    curl -sSL https://gitea.rudolf.keenetic.link/ | grep og:url
    # ожидаем: <meta property="og:url" content="https://gitea.rudolf.keenetic.link/">
    
    curl -sSL https://gitea.rudolf.keenetic.link/user/login | grep -iE 'detected|warning|mismatch'
    # ожидаем: пусто (нет warning)
    

Открытые вопросы

  1. Секреты — vault / env / генерация при первом deploy?
  2. poc/gitea/ → gitea/ переименовать?
  3. REVERSE_PROXY_TRUSTED_PROXIES = * или указать 192.168.1.0/24, 10.0.0.0/8?
  4. nginx_nginx сервис — выпилить из compose (мёртвый, Replicas=0) или восстановить?
## Симптомы - Все ссылки в Gitea ведут на `http://192.168.1.96/...` вместо `https://gitea.rudolf.keenetic.link/...` - На странице логина — warning "The detected web site URL is unlikely matching the site config" - `<meta property="og:url" content="http://192.168.1.96">` на главной ## Корневая причина Подтверждённая цепочка трафика: ``` client (из tailscale-сети, иначе нет маршрута в LAN) → Keenetic router: DNS resolve (gitea.rudolf.keenetic.link → 192.168.1.96) + Let's Encrypt TLS termination → plain HTTP на 192.168.1.96 → swarm ingress-endpoint (10.0.0.2) → gitea_server (10.0.0.235) ``` Keenetic — потребительский роутер, **proxy headers не передаёт**. Поэтому gitea видит: - `r.URL.Scheme = "http"` (после TLS termination идёт plain HTTP) - `r.Host = "192.168.1.96"` (NAT-адрес, не домен) - `r.RemoteAddr = "10.0.0.2"` (swarm ingress) Подтверждение из логов gitea: ``` HTTPRequest [I] router: completed GET / for 10.0.0.2:55642, 200 OK HTTPRequest [I] router: completed GET /user/login for 10.0.0.2:55658, 200 OK ``` `ROOT_URL` и `DOMAIN` в текущем `app.ini` уже правильные (`https://gitea.rudolf.keenetic.link/`), но это не помогает — gitea использует request-derived URL для `og:url` и warning'а. ## Топология (что я нашёл при разборе) - **Image**: `docker.gitea.com/gitea:1.27.0`, task `gitea_server.1.fx8lrhxza6s7xhjeqr46oiioa` на node `odroid` (id `j9bljgaqh9qc`) - **Network**: gitea_server в трёх overlay-сетях: `gitea_gitea` (10.0.17.13), `ingress` (10.0.0.235), `nginx_ingress` (10.0.3.134) - **Compose**: `admin/ansible/poc/gitea/stack-compose.yml` - **Data**: `/data/gitea/conf/app.ini` в named volume `gitea_data` (NFS на 192.168.1.96:/root/volumes/gitea) - **`nginx_nginx` (jwilder/nginx-proxy)** в compose есть, но `Replicas: 0` — **не запущен и не нужен**. Keenetic уже делает TLS termination - **Tailscale** установлен на odroid (`/etc/resolv.conf` контейнеров содержит `search anoa-bebop.ts.net`), но DNS для `gitea.rudolf.keenetic.link` отвечает Keenetic, не tailscale. Tailscale — только транспорт для клиента ## Фикс Только правка `app.ini` (без нового nginx, без изменения DNS): ```ini [server] APP_DATA_PATH = /data/gitea DOMAIN = gitea.rudolf.keenetic.link SSH_DOMAIN = gitea.rudolf.keenetic.link HTTP_PORT = 3000 ROOT_URL = https://gitea.rudolf.keenetic.link/ DISABLE_SSH = true SSH_PORT = 22 SSH_LISTEN_PORT = 22 LFS_START_SERVER = true PROTOCOL = https REVERSE_PROXY_TRUSTED_PROXIES = * LFS_JWT_SECRET = <из vault или env> ``` **Что меняется:** 1. **`PROTOCOL = https`** — главный фикс. Заставляет gitea считать что приходит HTTPS даже при plain HTTP-сокете. Решает `og:url = http://...` и warning на login page. 2. **`REVERSE_PROXY_TRUSTED_PROXIES = *`** (или конкретные подсети `192.168.1.0/24, 10.0.0.0/8`) — без этого gitea отбрасывает все `X-Forwarded-*` headers. Сейчас headers не приходят, но это подстраховка и правильная гигиена. 3. **`LFS_JWT_SECRET`** (и `JWT_SECRET`) переезжает в vault/env, не коммитится в открытом виде. ## Что нужно сделать (порядок) 1. Создать `admin/ansible/poc/gitea/app.ini` с содержимым выше (секреты — placeholder) 2. Решить где хранить секреты: ansible-vault рядом с compose / env-переменные / генерация при первом deploy 3. В `stack-compose.yml` добавить bind mount `./app.ini:/data/gitea/conf/app.ini:ro` 4. Удалить старый `app.ini` из volume (или `docker service update --force` после mount'а перезапишет) 5. Переименовать `poc/gitea/` → `gitea/` (это prod, имя `poc/` вводит в заблуждение) — отдельным PR или вместе 6. Верификация после deploy: ``` curl -sSL https://gitea.rudolf.keenetic.link/ | grep og:url # ожидаем: <meta property="og:url" content="https://gitea.rudolf.keenetic.link/"> curl -sSL https://gitea.rudolf.keenetic.link/user/login | grep -iE 'detected|warning|mismatch' # ожидаем: пусто (нет warning) ``` ## Открытые вопросы 1. **Секреты** — vault / env / генерация при первом deploy? 2. **`poc/gitea/` → `gitea/`** переименовать? 3. **`REVERSE_PROXY_TRUSTED_PROXIES = *`** или указать `192.168.1.0/24, 10.0.0.0/8`? 4. **`nginx_nginx` сервис** — выпилить из compose (мёртвый, Replicas=0) или восстановить?
Author
Contributor

2026-09-13: блокирует Gitea Packages /v2/token для Docker push

Этот же баг ломает Gitea Container Registry. Симптом:

$ docker login gitea.rudolf.keenetic.link
# login passes

$ docker push gitea.rudolf.keenetic.link/Org1/hermes-voice-gateway:v0.1.0
Error response from daemon: Get "https://gitea.rudolf.keenetic.link/v2/":
  Get "http://192.168.1.96/v2/token?account=***&client_id=docker&offline_token=true&service=container_registry":
  dial tcp 192.168.1.96:80: connect: connection refused

Gitea API возвращает html_url: http://192.168.1.96/... (внутренний IP). Docker daemon, не получив токен по правильному URL, пытается зайти на 192.168.1.96:80 — там нет gitea listener.

Воспроизведено в Gitea Actions run #121 на runner v0.6.1+1-g8e6b3be9 (arm64, ubuntu-latest executor). После фикса PROTOCOL=https + REVERSE_PROXY_TRUSTED_PROXIES Gitea будет отдавать корректный публичный token URL.

Без этого фикса невозможно использовать Gitea Packages как container registry (build-and-push через Gitea Actions зависает на этом шаге).

PR готов к merge: жду обновления app.ini в admin/ansible/poc/gitea/.

## 2026-09-13: блокирует Gitea Packages /v2/token для Docker push Этот же баг ломает Gitea Container Registry. Симптом: ``` $ docker login gitea.rudolf.keenetic.link # login passes $ docker push gitea.rudolf.keenetic.link/Org1/hermes-voice-gateway:v0.1.0 Error response from daemon: Get "https://gitea.rudolf.keenetic.link/v2/": Get "http://192.168.1.96/v2/token?account=***&client_id=docker&offline_token=true&service=container_registry": dial tcp 192.168.1.96:80: connect: connection refused ``` Gitea API возвращает `html_url: http://192.168.1.96/...` (внутренний IP). Docker daemon, не получив токен по правильному URL, пытается зайти на `192.168.1.96:80` — там нет gitea listener. Воспроизведено в Gitea Actions run #121 на runner v0.6.1+1-g8e6b3be9 (arm64, ubuntu-latest executor). После фикса `PROTOCOL=https` + `REVERSE_PROXY_TRUSTED_PROXIES` Gitea будет отдавать корректный публичный token URL. Без этого фикса невозможно использовать Gitea Packages как container registry (build-and-push через Gitea Actions зависает на этом шаге). PR готов к merge: жду обновления `app.ini` в `admin/ansible/poc/gitea/`.
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Reference: admin/ansible#7