Диск и резервные копии#
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…Файлы диска и ссылки на них#
Диск сервиса открывается в панели как обычная папка: файл можно загрузить, скачать, переименовать, удалить и дать на него публичную ссылку. Сервис видит изменения сразу, без перезапуска; работает и когда сервис остановлен.

- Откройте диск
Сервис → вкладка «Файлы» → «Диск». Первое открытие занимает несколько секунд: Hangar запускает рядом с диском его файловый сервис, а через 15 минут без запросов он уходит сам.
- Загрузите файл
Кнопка «Загрузить» или перетащите файлы и папки в окно. Файл получает владельца папки, в которую лёг, поэтому приложение может читать и менять его.
- Получите ссылку
Выберите файл → «Поделиться». Будет две ссылки: страница файла и прямая ссылка, которая отдаёт сам файл.
- Ограничьте, если нужно
У ссылки можно задать срок действия, пароль и лимит скачиваний. Отозвать — на вкладке «Ссылки».
Прямая ссылка#
Прямая ссылка вида 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 для этого не нужен.

- Добавьте хранилище
Проект → «Настройки» → «Внешние бэкапы» → «Добавить хранилище». Подойдёт бакет S3 (AWS, Backblaze B2, Cloudflare R2, Yandex Cloud, Selectel, MinIO) или любой сервер с доступом по SSH.
- Дайте доступ
Для S3 — адрес, бакет и пара ключей. Для сервера — адрес, пользователь и папка: Hangar сам создаст ключ и покажет команду, которой его добавить на сервер. Пароль вводить не нужно, хотя можно и по паролю, и своим ключом.
- Выберите расписание
Каждый день, раз в неделю или только по кнопке; сколько копий хранить — более старые удаляются из хранилища сами.
- Проверьте
Перед сохранением 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 соединениях к базе. Сама база не меняется.
# в переменных приложения
DATABASE_URL=${{ Postgres-pooler.DATABASE_POOL_URL }}Режим transaction (по умолчанию) даёт больше всего соединений; Prisma — добавьте ?pgbouncer=true. Если приложению нужны prepared statements или настройки сессии, выберите режим session. Миграции запускайте напрямую через DATABASE_URL базы.
POST /v1/services/<postgres>/instances/<environment>/database/pooler {"pool_mode": "transaction"}S3-бакеты#
Для файлов приложения: hangar bucket create uploads, доступы — через ${{ uploads.ACCESS_KEY_ID }} и т.п.
В панели: проект → «Настройки» → «S3-бакеты» → «Создать бакет». У каждого бакета свои ключи; сервисы получают их ссылками на переменные, например ${{ media.S3_ENDPOINT }}.


