# Handoff: gitea-daily-backup Дата снимка: 2026-10-31 (Europe/Moscow). Ветка: `main` (последний коммит `fix: не пугаю WARNING, если wiki в Gitea ещё не создана`). ## Задача пользователя Есть локальный Gitea на `192.168.1.9`. Нужен **ежедневный бэкап всех репозиториев**. Это сделано. Проект — Python-CLI `gitea-backup` + Docker (Alpine) / venv+cron / systemd. ## Кто и где это крутит - Пользователь: Max Pro. Десктоп Windows, сначала пробовал в **WSL** (`max@SheinovM:~/gitea-daily-backup`). - Потом **перенёс на сервер RedOS** (`root@redos`) и там поднял `docker compose`. Это текущий прод, насколько известно из чата. - Gitea в LAN: `192.168.1.9`. В `.env.example` порт `:3000`, но в боевых логах clone URL без порта (`http://oauth2:***@192.168.1.9/Matvey/ChatService.git`) — на проде Gitea, скорее всего, на 80 (nginx) или в `GITEA_URL` указан хост без порта. Главное: **clone с того URL, что отдаёт API, работает**. Публичное имя репозитория кода: `max-pro/gitea-daily-backup` (Origin, private). Страница: https://cursor.com/codebase/max-pro/gitea-daily-backup ## Что считается «готово» - Список репозиториев через Gitea API (search + user + orgs + admin users, без дублей). - `git clone --mirror` / дальше `git fetch --all --prune --tags`. - Git LFS (`git lfs fetch --all`), если включено. - Wiki (`.wiki.git`), если Gitea отдала `has_wiki` **и** git-репозиторий wiki реально существует. - Ежедневные снимки `cp -al` (hardlink) с хранением `BACKUP_KEEP_DAYS` (сейчас 30). - `status.json` после прогона, flock чтобы два бэкапа не пересеклись. - Демон `gitea-backup schedule`: сразу при старте (`RUN_ON_START=true`) и каждый день в `BACKUP_AT` (03:00, `TZ=Europe/Moscow`). - Docker-образ `CMD ["schedule"]`. ## Чего в бэкапе нет (и это сознательно) Тикеты, PR, пользователи, настройки инстанса — это БД Gitea. Для полного дампа на самом сервере Gitea: `gitea dump`. Пользователь просил репозитории. ## Последний подтверждённый прогон Лог с RedOS (контейнер `gitea-backup`), репозиторий `Matvey/ChatService`: - `fetch --all --prune --tags` — зеркало уже было, инкремент ок. - `lfs fetch --all` — ок. - Клон `ChatService.wiki.git` упал: wiki в настройках включена, git-репо wiki не создано (нет страниц). Код это **пропускает**, пишет «Готово: Matvey/ChatService». - Пользователь спросил, нормально ли это. Ответ: да, код в порядке. После этого смягчили лог (INFO вместо WARNING для «wiki ещё нет»). На проде этот коммит мог быть ещё не задеплоен — если виден старый WARNING, это тот же самый безобидный случай. Проверка зеркала: ```bash git -C backups/mirrors//.git rev-list --all --count git -C backups/mirrors//.git fsck ``` В `objects/` у зеркала часто только `info/` и `pack/` — так и должно быть у `--mirror`. ## На чём остановились 1. Прод на RedOS через Docker работает, бэкап репозиториев идёт. 2. Пользователь попросил **документацию для следующего агента** (этот каталог). Других фич в очереди нет. 3. WSL-путь с Docker у пользователя был мучительный (нет демона, нет compose-плагина, permission denied, призрак контейнера). На RedOS compose уже собрал Alpine-образ. Предпочитать то, что работает на текущей машине. 4. Не делали: алерты, UI, бэкап БД Gitea, restore-playbook сверх `git clone` из зеркала, CI. ## Если продолжать работу — разумные следующие шаги (не запрошены) - Убедиться, что на RedOS после `git pull` пересобран Alpine-образ (`docker compose build --no-cache` один раз после смены Dockerfile). - Если wiki не нужны: `BACKUP_INCLUDE_WIKI=false`. - Restore-инструкция / проверка `status.json` после ночного прогона. - Если понадобится полный инстанс: документировать `gitea dump` на 192.168.1.9, это другой инструмент. ## Правила репозитория - Коммиты на русском, формат `тип: описание`. - PR не создавать, пока пользователь не попросил. - Отвечать пользователю по-русски. - Не коммитить `.env` и `backups/`.