На этой странице

Диск и резервные копии#

Терминал
hangar volume add /data --size 10240 --backups daily
hangar volume set --size 20480          # только увеличение
hangar volume set --backup-mode dump    # базы: дамп без остановки
hangar volume show
hangar backup create
hangar backup list
hangar backup restore 01a1…

Файлы диска и ссылки на них#

Диск сервиса открывается в панели как обычная папка: файл можно загрузить, скачать, переименовать, удалить и дать на него публичную ссылку. Сервис видит изменения сразу, без перезапуска; работает и когда сервис остановлен.

Файлы диска сервиса
Сервис → «Файлы» → «Диск»: файлы, загрузка и ссылки.
  1. Откройте диск

    Сервис → вкладка «Файлы» → «Диск». Первое открытие занимает несколько секунд: Hangar запускает рядом с диском его файловый сервис, а через 15 минут без запросов он уходит сам.

  2. Загрузите файл

    Кнопка «Загрузить» или перетащите файлы и папки в окно. Файл получает владельца папки, в которую лёг, поэтому приложение может читать и менять его.

  3. Получите ссылку

    Выберите файл → «Поделиться». Будет две ссылки: страница файла и прямая ссылка, которая отдаёт сам файл.

  4. Ограничьте, если нужно

    У ссылки можно задать срок действия, пароль и лимит скачиваний. Отозвать — на вкладке «Ссылки».

Прямая ссылка вида https://hangar.my/f/<токен>/<имя> отдаёт сам файл, а папку — одним zip-архивом. Она подходит для curl, установщика, кнопки «Скачать» на сайте и докачки. У ссылки с паролем прямой формы нет: пароль спрашивает страница.

Терминал
# выложить сборку и получить прямую ссылку одной строкой
hangar files put build/app-release.apk releases/ --link --expires 30d
# → https://hangar.my/f/Zk3…/app-release.apk

hangar files ls releases
hangar files get releases/app-release.apk
hangar files link releases --dir          # папка одним zip
hangar files links                        # все ссылки и счётчики скачиваний
hangar files unlink 01a1…
  • Загрузить можно не больше размера диска; размер меняется в настройках сервиса → «Volume».
  • Диск базы данных открыт только для просмотра и скачивания: база хранит свои файлы сама, правка снаружи её сломает.
  • С project-токеном то же самое делает CI: hangar files put … --link печатает ссылку в stdout.
  • Создание и отзыв ссылок записываются в журнал действий workspace.

Бэкапы баз без остановки#

PostgreSQL, MySQL/MariaDB и MongoDB бэкапятся в режиме dump: pg_dump, mysqldump или mongodump снимают консистентную копию с работающей базы — база не останавливается ни на секунду. Дамп запускается рядом с базой на её же образе (версии утилит совпадают с сервером) и сразу уходит в хранилище бэкапов, без временных файлов на диске. Восстановление тоже идёт в работающую базу.

Хранится один последний бэкап по расписанию (за сутки при ежедневных; число можно поднять в настройках диска, до 90). Ручные бэкапы и неудачные попытки удаляются через сутки. Самый свежий удачный бэкап не удаляется никогда.

  • dump — для баз: копия с работающего сервера, без простоя (по умолчанию для новых и существующих баз)
  • online — копия файлов диска без остановки (подходит для файлов приложения, Redis)
  • stop — консистентная копия файлов с короткой остановкой сервиса

Внешние бэкапы: копия проекта у вас#

Бэкапы на платформе защищают от ошибки в данных. Внешние бэкапы — от всего остального: копия проекта целиком лежит в хранилище, которое принадлежит вам, в обычных форматах. Восстановить её можно где угодно, Hangar для этого не нужен.

Внешние бэкапы проекта
Настройки проекта → «Внешние бэкапы»: хранилище, расписание и последняя копия.
  1. Добавьте хранилище

    Проект → «Настройки» → «Внешние бэкапы» → «Добавить хранилище». Подойдёт бакет S3 (AWS, Backblaze B2, Cloudflare R2, Yandex Cloud, Selectel, MinIO) или любой сервер с доступом по SSH.

  2. Дайте доступ

    Для S3 — адрес, бакет и пара ключей. Для сервера — адрес, пользователь и папка: Hangar сам создаст ключ и покажет команду, которой его добавить на сервер. Пароль вводить не нужно, хотя можно и по паролю, и своим ключом.

  3. Выберите расписание

    Каждый день, раз в неделю или только по кнопке; сколько копий хранить — более старые удаляются из хранилища сами.

  4. Проверьте

    Перед сохранением Hangar записывает в хранилище пробный файл. «Копия сейчас» делает первую копию сразу; ход и история — там же.

Что лежит в копии#

Каждая копия — отдельная папка с датой. Опись пишется последней: если она есть, копия дошла целиком.

папка копии
magazin-01a1696f/2026-11-20_03-00-07/
  README.txt                 как восстановить
  hangar-backup.json         опись: файлы, размеры, контрольные суммы SHA-256
  project.json               окружения, сервисы и их настройки, домены, диски
  environments/production/
    shared.env               общие переменные
    web/service.env          переменные сервиса, с комментариями
    web/config/…             конфиг-файлы
    postgres/database/
      globals.sql            роли
      app.dump               по файлу на базу, формат pg_dump
    uploads/volume.tar.gz    файлы диска
Терминал
# PostgreSQL
createdb app && pg_restore --no-owner -d app app.dump
# MySQL / MariaDB
gunzip -c all-databases.sql.gz | mysql -u root -p
# MongoDB
mongorestore --gzip --archive=all-databases.archive.gz
# файлы диска
tar -xzf volume.tar.gz -C /куда/распаковать
  • Базы копируются дампом с работающего сервера, без остановки. Если последнему бэкапу диска меньше трёх часов, в копию идёт он — второй раз данные не снимаются.
  • Диск в режиме «С остановкой» копируется так же, как при обычном бэкапе: сервис ненадолго останавливается, не чаще раза в сутки.
  • Переменные и конфиг-файлы можно не копировать — переключатель в настройках хранилища. Имена переменных в project.json останутся.
  • Файлы из S3-бакетов проекта в копию не входят: они доступны по S3 API, их синхронизируют rclone или aws s3 sync.

О неудачной копии придёт письмо и пуш (настройка «Бэкапы»), события backup.external.success и backup.external.failed уходят в вебхуки. Копию можно запускать из CI перед деплоем — токену проекта это разрешено:

Терминал
hangar backup external add b2 --s3 --endpoint s3.eu-central-003.backblazeb2.com --bucket my-backups --access-key KEY
hangar backup external add nas --sftp --host backup.example.com --user backup --path hangar
hangar backup external run            # ждёт окончания, код 1 при ошибке
hangar backup external list
hangar backup external history

Пулер соединений PgBouncer#

Когда приложение открывает много соединений (реплики, воркеры, всплески трафика), PostgreSQL упирается в лимит и отвечает «too many connections». В кабинете: база → «Данные» → «Панель управления» → «Пулер соединений PgBouncer». Он ставится отдельным сервисом <база>-pooler и держит до 1000 клиентов на 20 соединениях к базе. Сама база не меняется.

env
# в переменных приложения
DATABASE_URL=${{ Postgres-pooler.DATABASE_POOL_URL }}

Режим transaction (по умолчанию) даёт больше всего соединений; Prisma — добавьте ?pgbouncer=true. Если приложению нужны prepared statements или настройки сессии, выберите режим session. Миграции запускайте напрямую через DATABASE_URL базы.

HTTP / JSON
POST /v1/services/<postgres>/instances/<environment>/database/pooler   {"pool_mode": "transaction"}

S3-бакеты#

Для файлов приложения: hangar bucket create uploads, доступы — через ${{ uploads.ACCESS_KEY_ID }} и т.п.

В панели: проект → «Настройки» → «S3-бакеты» → «Создать бакет». У каждого бакета свои ключи; сервисы получают их ссылками на переменные, например ${{ media.S3_ENDPOINT }}.

S3-бакеты проекта
S3-бакеты окружения production.