9.6 KiB
Бэкап репозиториев Gitea
Каждый день забирает все доступные репозитории с вашего Gitea (http://192.168.1.9:3000 по умолчанию) и хранит их как git-зеркала плюс компактные ежедневные снимки.
Для другого агента или передачи контекста: каталог docs/agent/ (оглавление, архитектура, прод, грабли). Короткий указатель в корне: AGENTS.md.
Docker не нужен. Достаточно Python 3.11+ и Git.
Что попадает в бэкап:
- все ветки и теги (
git clone --mirror); - wiki, если она включена у репозитория;
- объекты Git LFS;
- короткий JSON с описанием репозитория.
Что не входит: тикеты, PR, пользователи и настройки инстанса. Это лежит в БД Gitea — для полного дампа на самом сервере есть gitea dump.
Быстрый старт (без Docker)
На машине в той же сети, что и Gitea (чтобы открывался 192.168.1.9):
sudo apt install python3 python3-venv python3-pip git git-lfs
git lfs install
./install.sh
nano .env # впишите GITEA_TOKEN
.venv/bin/gitea-backup list
.venv/bin/gitea-backup run
Ежедневно в 03:00:
./install.sh --cron
Если cron в WSL не запущен: sudo apt install cron && sudo service cron start.
Альтернативы расписанию:
./install.sh --systemd # пользовательский systemd-таймер
.venv/bin/gitea-backup schedule # демон в текущем терминале
Зеркала появятся в ./backups/mirrors, снимки — в ./backups/snapshots/ГГГГ-ММ-ДД, отчёт о последнем прогоне — в ./backups/status.json.
Запускайте бэкап на машине, которая включена ночью (сам сервер Gitea или всегда включённый ПК). Сессия WSL без окон часто засыпает — тогда cron внутри WSL не сработает.
Токен Gitea
- Войдите в Gitea под администратором сайта — иначе бэкапятся только репозитории, которые видит обычный пользователь.
- Настройки → Приложения → Создать токен.
- Права:
read:repository,read:user,read:organization. - Вставьте токен в
.envкакGITEA_TOKEN.
Если Gitea слушает не :3000, поправьте GITEA_URL.
Docker
Пакет docker.io ставит только docker. Команда docker compose — это отдельный плагин. Без него docker compose up -d ломается с ошибкой unknown shorthand flag: 'd' in -d.
sudo apt update
sudo apt install -y docker.io docker-compose-v2
sudo service docker start
sudo usermod -aG docker "$USER"
# закройте терминал и откройте новый, чтобы группа docker применилась
docker compose version # должно быть: Docker Compose version v2.x
cp .env.example .env # если ещё нет; впишите GITEA_TOKEN
docker compose up -d --build
Если видите permission denied ... docker.sock — демон запущен, но ваш пользователь не в группе docker. Сейчас можно так:
sudo docker compose up -d --build
Навсегда (один раз):
sudo usermod -aG docker "$USER"
newgrp docker
docker compose up -d --build
newgrp действует только в этом терминале. Чтобы группа работала везде — закройте сессию и зайдите снова.
Если docker info показывает Client, но Server пишет no such file or directory / Is the docker daemon running? — есть только клиент, движка нет. То же самое, если sudo service docker start отвечает unrecognized service и нет /etc/init.d/docker.
Поставьте движок и запустите его:
sudo apt update
sudo apt install -y docker.io containerd
which dockerd # должен быть /usr/bin/dockerd
Дальше — как получится в вашей системе:
# если есть systemd
sudo systemctl enable --now docker
# если service есть
sudo service docker start
# типичный WSL без systemd: запустить демон вручную
sudo dockerd
sudo dockerd оставьте в одном терминале, в другом:
sudo docker info
sudo docker compose up -d --build
Чтобы демон поднимался сам при старте WSL, в /etc/wsl.conf:
[boot]
systemd=true
Затем из Windows: wsl --shutdown, снова откройте Ubuntu и выполните sudo systemctl enable --now docker.
Если Docker ставили через Docker Desktop на Windows — apt-клиент в WSL к нему не подключится, пока Desktop не запущен. Откройте Docker Desktop и в Settings → Resources → WSL integration включите свой дистрибутив.
Либо одной командой из репозитория: ./docker-up.sh --install-engine, затем ./docker-up.sh.
Если плагин v2 недоступен в репозиториях:
sudo apt install -y docker-compose
docker-compose up -d --build
Контейнер сразу делает первый бэкап и дальше каждый день в 03:00 (таймзона Europe/Moscow). Каталог на хосте: ./backups.
docker compose logs -f
docker compose exec gitea-backup gitea-backup list
docker compose exec gitea-backup gitea-backup run --dry-run
docker compose exec gitea-backup gitea-backup run
docker compose down
Если docker compose up падает с No such container: ac8d23cfcfca… — это сломанное состояние Compose после перезапуска dockerd. Образ уже собран, Compose лучше не использовать. Запустите контейнер напрямую:
sudo docker rm -f gitea-backup 2>/dev/null || true
sudo docker run -d \
--name gitea-backup \
--network host \
--restart unless-stopped \
--env-file .env \
-e BACKUP_DIR=/backups \
-v "$PWD/backups:/backups" \
gitea-daily-backup-gitea-backup:latest
sudo docker logs -f gitea-backup
sudo docker exec gitea-backup gitea-backup list
Или из репозитория после git pull: ./docker-up.sh (он собирает образ и делает docker run, без Compose).
Предупреждение build using Bake, but buildx isn't installed на запуск не влияет.
Если на RedOS / CentOS / RHEL сборка Debian-образа падает с At least one invalid signature was encountered — это не подпись репозитория, а хост: старый libseccomp или неверные часы. Образ переведён на Alpine, поэтому после обновления кода:
git pull
date # время должно быть близко к реальному; иначе: timedatectl set-ntp true
sudo docker compose build --no-cache
sudo docker compose up -d
Если Alpine тоже не качается, обновите seccomp на хосте: sudo dnf update libseccomp (или yum).
Как устроено хранение
backups/
mirrors/ # актуальные зеркала, каждый день git fetch
alice/app.git
alice/app.git.meta.json
alice/app.wiki.git
snapshots/ # hardlink-копии mirrors на дату (почти не едят место)
2026-09-07/
2026-09-08/
status.json
Снимки старше BACKUP_KEEP_DAYS (по умолчанию 30) удаляются. Живые зеркала всегда можно клонировать обратно:
git clone --bare backups/mirrors/alice/app.git
# или
git clone backups/mirrors/alice/app.git restored-app
Переменные окружения
| Переменная | По умолчанию | Смысл |
|---|---|---|
GITEA_URL |
http://192.168.1.9:3000 |
Адрес Gitea |
GITEA_TOKEN |
— | Обязательный токен API |
BACKUP_DIR |
./backups |
Корень бэкапов |
BACKUP_AT |
03:00 |
Время ежедневного запуска |
TZ |
Europe/Moscow |
Таймзона планировщика |
RUN_ON_START |
true |
Бэкап сразу при старте демона schedule |
BACKUP_SNAPSHOTS |
true |
Делать датированные снимки |
BACKUP_KEEP_DAYS |
30 |
Сколько дней хранить снимки |
BACKUP_INCLUDE_WIKI |
true |
Бэкап wiki |
BACKUP_INCLUDE_LFS |
true |
git lfs fetch --all |
Тесты
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
python -m unittest discover -s tests -v