owngit/docs/troubleshooting.md

Troubleshooting

1) https://git.papatramp.ru не открывается

Проверь DNS и маршрутизацию:

dig +short git.papatramp.ru

• из интернета должен резолвиться во внешний IP;
• из локалки лучше Split DNS на LAN IP HAProxy.

Проверь HAProxy:

sudo haproxy -c -f /etc/haproxy/haproxy.cfg
sudo systemctl status haproxy --no-pager

2) 404 от HAProxy

Причина: не совпадает Host, запрос уходит в bk_http_default.

Проверка:

curl -I -H "Host: git.papatramp.ru" http://127.0.0.1

Убедись, что есть ACL:

• acl host_git hdr(host) -i git.papatramp.ru
• use_backend bk_gitea if host_git

3) 503 от HAProxy на Gitea

Причина: backend bk_gitea down.

Проверки:

curl -I http://192.168.128.100:3000
curl -I http://192.168.128.100:3000/api/healthz

Если не отвечает:

cd /opt/gitea
sudo docker compose ps
sudo docker compose logs --tail=200 gitea

4) SSH push не работает (Permission denied (publickey))

Проверь порт и доступ:

nc -zv git.papatramp.ru 2222
ssh -vvv -p 2222 git@git.papatramp.ru

Убедись:

• публичный ключ добавлен в Gitea аккаунт;
• в ~/.ssh/config правильный HostName, Port, IdentityFile;
• backend bk_git_ssh смотрит на правильный IP/порт.

5) В локалке не работает, а из интернета работает

Обычно это DNS/NAT loopback:

• настрой Split DNS (git.papatramp.ru -> LAN IP HAProxy);
• либо включи Hairpin NAT на роутере.

6) Миграция не создает репозитории в Gitea

Проверь токен и права:

• GITEA_TOKEN должен иметь право создавать репозитории;
• для org нужен доступ к организации;
• GITEA_OWNER_TYPE должен соответствовать user/org.

Проверка API:

curl -H "Authorization: token $GITEA_TOKEN" "$GITEA_URL/api/v1/user"

7) Private репозитории GitHub не видны в миграции

Проверь GITHUB_TOKEN:

• токен должен иметь права на чтение приватных репозиториев;
• GITHUB_OWNER и GITHUB_OWNER_TYPE должны быть корректными.

8) LFS не перенесся

Включи:

export MIGRATE_LFS=true

И проверь наличие git-lfs:

git lfs version

9) Кривые редиректы/URL в Gitea

Проверь ROOT_URL в app.ini:

[server]
ROOT_URL = https://git.papatramp.ru/

И заголовки от HAProxy в bk_gitea (X-Forwarded-Proto, X-Forwarded-Host, Host).