Ваш образ, ваш реестр

Образ сайта в Docker Hub

Вы сами собираете сайт в образ и храните его в закрытом репозитории Docker Hub. Образ — запечатанная упаковка: готовые страницы плюс небольшой веб-сервер nginx, готовые к запуску на любой машине с Docker.

Порядок всегда один: аккаунт и токен, вход на своём компьютере и на сервере, сборка и отправка образа, затем скачивание и запуск на сервере. Этот путь подходит, когда образы должны жить в вашем собственном реестре или GitHub не вариант.

Как это проходит

1
Аккаунт

Зарегистрируйтесь на hub.docker.com и создайте закрытый репозиторий для сайта.
2
Токен

Создайте токен доступа: это пароль для docker login.
3
Вход

Один раз на компьютере, где собираете, и один раз на сервере.
4
Сборка

Строгая сборка делает папку dist/ с готовыми страницами.
5
Упаковка и отправка

docker build упаковывает dist/ в образ nginx, docker push отправляет его в Docker Hub.
6
Скачать и запустить

Сервер скачивает новый образ и запускает его вместо старого. С HERON Агентом этот шаг идёт сам.
7
Проверка

Откройте сайт и страницу, которую меняли.

Настройка один раз

1. Создайте репозиторий в Docker Hub

Зарегистрируйтесь на hub.docker.com и создайте закрытый репозиторий, например my-site. В Docker Hub репозиторий — это полка, на которой хранятся версии одного образа.

Бесплатный тариф: На момент написания бесплатный тариф Personal включает один закрытый репозиторий; больше — на платном тарифе.
Имя: Образ называется you/my-site, где you — ваше имя в Docker Hub.
Куда нажимать: Repositories → Create a repository → имя → Visibility: Private → Create.
Один репозиторий на сайт: Десять сайтов — десять репозиториев, у каждого свои версии.; Docker ещё нет? Установите до шага 3: Docker на macOS, Windows и Linux.

2. Создайте два токена

Account settings → Personal access tokens → Generate. Сделайте два: один для сборки, второй для сервера.

Для сборки: Чтение и запись: им можно отправлять новые образы.
Для сервера: Только чтение: сервер только скачивает. Если токен утечёт, подменить ваш образ им нельзя.
Где хранить: В менеджере паролей или в конфигураторе, который хранит их вне папки сайта. Никогда в папке сайта и в git.
Показывается один раз: Docker Hub показывает токен только сразу после создания. Скопируйте сразу; потеряли — отзовите и создайте новый.
Называйте понятно: laptop-build и server-read: потом сразу видно, какой отзывать.

3. Войдите на обеих машинах

На компьютере — с токеном на чтение и запись, на сервере — с токеном только на чтение. Docker запоминает вход.

docker login -u you

Запрос пароля: Вставьте токен, а не пароль от аккаунта.
При вставке ничего не видно: Это нормально: терминал прячет пароли. Вставьте и нажмите Enter.
Успех: Docker ответит Login Succeeded. Вход запоминается до docker logout.
На сервере: Сначала подключитесь по SSH, затем та же команда с токеном только на чтение.

Собрать, упаковать, отправить

Соберите образ

Выполните в папке сайта, подставив своё имя в Docker Hub вместо you.

heron build . --env prod --strict && curl -fsSL https://raw.githubusercontent.com/FMSTM/HERON/prod/Dockerfile.site | docker build -t you/my-site:prod -f - dist

Сборка: Строгая сборка делает dist/ и останавливается на любой битой ссылке или пустом описании.
Упаковка: docker build упаковывает в nginx только dist/, по рецепту образа из стабильной версии HERON. Исходники, .git и токены попасть в образ не могут.
Конфигуратор: Если выбрать Docker Hub и включить помощник, он запишет эти команды в .heron/scripts/publish.sh. Конфигуратор
Сколько длится: Несколько секунд сборка, первая упаковка — до минуты; дальше работает кэш.
Если остановилось: Сборка называет файл и строку, которые нужно исправить. Частые ошибки

Проверьте у себя

Запустите образ и откройте localhost:8080: главную, несуществующую страницу, старый адрес, который должен переадресовать. Это ровно то, что запустит сервер, поэтому вы видите сайт глазами посетителя.

docker run --rm -p 8080:8080 you/my-site:prod

Что посмотреть: Главную, две-три внутренние страницы; localhost:8080/does-not-exist/ должен показать вашу страницу 404.
Остановить: Ctrl+C в терминале.
Много сайтов: В ветке prod у HERON есть scripts/site.sh с шагом smoke, который сам проверяет 200, 404, 301 и 410. Другие способы запуска HERON

Отправьте

Отправьте образ в свой закрытый репозиторий. После этого его может скачать любая машина, на которой выполнен вход с вашим токеном.

docker push you/my-site:prod

Теги: prod всегда указывает на последнюю версию. Добавьте ещё тег с датой, например you/my-site:2026-10-19, и к нему всегда можно вернуться.
Тег с датой одной строкой: docker tag you/my-site:prod you/my-site:2026-10-19 && docker push you/my-site:2026-10-19.
Проверка: Откройте репозиторий на hub.docker.com: новый тег виден со временем.

Запуск на сервере

Первый запуск

Подойдёт любой сервер с Docker, на котором выполнен вход с токеном только на чтение. Внутри образа сайт слушает порт 8080; команда выводит его на порт 80 и поднимает после перезагрузки.

docker run -d --name my-site -p 80:8080 --restart unless-stopped you/my-site:prod

Домен и HTTPS: Направьте запись A домена на сервер и поставьте HTTPS: nginx с certbot, Caddy или Traefik.
Где взять сервер: Небольшой VPS примерно от €5–6 в месяц или бесплатный сервис контейнеров с его подвохами. Где может жить сайт
Проверка: docker ps показывает my-site запущенным; адрес сервера в браузере открывает сайт.
Имя: --name my-site позволяет обращаться к контейнеру в следующих командах.

Каждое обновление

Скачать новый образ, заменить контейнер, запустить. Одна строка на сервере, несколько секунд работы.

docker pull you/my-site:prod && docker rm -f my-site && docker run -d --name my-site -p 80:8080 --restart unless-stopped you/my-site:prod

Откат: Запустите предыдущий тег с датой той же командой.
Уборка: Старые образы занимают место; docker image prune удаляет те, которыми не пользуется ни один контейнер.
Автоматически: Этот шаг за вас делает платный HERON Агент, ниже.

Дополнение: HERON Агент

Платно

HERON Агент

Скачивает каждый новый образ из вашего Docker Hub по вашему ключу и сам обновляет контейнер. Вы отправляете образ, остальное на сервере делает Агент.

Что делает: Видит новый образ, меняет контейнер, проверяет, что сайт открывается, и откатывает, если нет.
Как подключается: Ставите Агента на сервер, генерируете ключ бота, добавляете токен Docker Hub — и Telegram становится панелью управления.
Свой бот или наш: Настройте собственного бота в Telegram или пользуйтесь нашим по подписке.
Ключи остаются у вас: Ключ бота и токен Docker Hub только на чтение лежат на вашем сервере.
Подробнее: HERON Агент

Вопросы

Зачем образ, а не просто файлы?

Образ несёт с собой настройки веб-сервера: настоящие переадресации 301 и 410, кэш, gzip, страницу 404. Сайт ведёт себя одинаково на ноутбуке и на сервере.

Можно другой реестр?

Да. Подойдёт любой реестр, в который умеет отправлять Docker: GitHub Packages, GitLab, свой. Замените имя образа в командах.

Какого размера образ?

Небольшого: nginx на Alpine Linux плюс ваши страницы и картинки. Большую часть веса дают фотографии, уже переведённые в WebP и AVIF.

Нужен ли HERON Агент?

Нет. Без него сервер обновляется одной командой выше. Агент — платное дополнение для тех, кто не хочет заходить на сервер.