Прод на одном VPS с Docker Compose: минимально, но надёжно
Раньше я писал про production-деплой на VPS: SSH, файрвол, systemd, nginx, HTTPS и бэкапы. Тогда на вопрос «нужен ли Docker?» я ответил «на старте не обязательно».
Теперь перехожу ко второй половине этого вопроса: если вы всё же решили перейти на Docker, как сделать это правильно на одном сервере.
Потому что запустить через docker compose up -d легко, но это ещё не production. Production — это когда упавший контейнер поднимается сам, логи не забивают диск, при деплое сайт не отваливается, а базу можно восстановить.
Когда Docker оправдан
Сначала честный ответ: если у вас один язык, один сервис и одна база — Docker даст немного. Юнит systemd проще и быстрее.
Docker оправдан в двух случаях.
Первый — несколько сервисов. Бэкенд, фронтенд, база, кэш, воркер для фоновых задач. Управлять каждым через отдельный файл systemd быстро становится путаницей.
Второй — воспроизводимость окружения. Ваша локальная машина и сервер используют один и тот же образ. Проблема «у меня работает» исчезает.
Если ни то, ни другое к вам не относится, добавьте статью в закладки и идите простым путём.
Стартовый compose-файл
Вот минимальный, но полный стек, работающий на одном сервере:
services:
db:
image: postgres:17-alpine
restart: unless-stopped
environment:
POSTGRES_PASSWORD_FILE: /run/secrets/db_password
POSTGRES_DB: app
volumes:
- db-data:/var/lib/postgresql/data
secrets:
- db_password
healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres"]
interval: 10s
timeout: 5s
retries: 5
api:
image: ghcr.io/madrimovdev/app-api:${TAG}
restart: unless-stopped
depends_on:
db:
condition: service_healthy
environment:
DATABASE_URL: postgres://postgres@db:5432/app
healthcheck:
test: ["CMD", "curl", "-fsS", "http://localhost:3000/health"]
interval: 15s
timeout: 3s
retries: 3
start_period: 20s
volumes:
db-data:
secrets:
db_password:
file: ./secrets/db_passwordВ этом файле три важные вещи, разберём их по очереди.
Healthcheck — то, что чаще всего пропускают
restart: unless-stopped поднимает контейнер, когда тот умер. Но худшая неисправность — не смерть контейнера, а состояние, когда он жив, но не работает.
Процесс запущен, порт открыт, но соединение с базой оборвалось и каждый запрос возвращает ошибку. Для Docker всё в порядке: процесс-то жив.
Именно это ловит healthcheck. А эндпоинт /health должен делать реальную проверку — хотя бы один лёгкий запрос к базе:
app.get('/health', async (c) => {
await db.execute(sql`select 1`)
return c.json({ ok: true })
})Если /health просто возвращает { ok: true }, он проверяет только то, что жив HTTP-сервер — а это почти ни о чём не говорит.
Второй важный момент — depends_on с condition: service_healthy. Без него API стартует раньше, чем база готова, миграция падает, и контейнер уходит в цикл перезапусков.
start_period тоже нужен: приложению требуется время на старт, и в этот период ошибки healthcheck не должны учитываться.
Логи забивают диск
Это самая частая и самая неожиданная поломка: через несколько месяцев сервер встаёт, а причина в том, что лог-файлы забили диск.
По умолчанию Docker не ограничивает объём логов. Это нужно добавить каждому сервису:
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"Максимум 30 МБ на сервис. Не записать это — значит запланировать себе ночной телефонный звонок в будущем.
Не храните секреты в environment
Пароль внутри environment виден через docker inspect и сохраняется в метаданных контейнера.
В Compose есть файловые секреты, и в примере выше они используются. Многие образы понимают переменные с суффиксом _FILE — например, POSTGRES_PASSWORD_FILE.
В своём приложении этот паттерн повторить легко:
const dbPassword = process.env.DB_PASSWORD_FILE
? await readFile(process.env.DB_PASSWORD_FILE, 'utf8')
: process.env.DB_PASSWORDФайлы секретов должны лежать на сервере с правами 600 и никогда не попадать в git.
Деплой без простоя
Самый простой деплой такой: docker compose pull && docker compose up -d. Проблема в том, что старый контейнер гасится, новый поднимается, и в промежутке сайт несколько секунд не работает.
Чтобы на одном сервере свести это к нулю, впереди нужен обратный прокси. Я использую Traefik — он сам видит контейнеры и направляет трафик на новый только после того, как тот стал здоровым.
Минимальная схема:
api:
labels:
- traefik.enable=true
- traefik.http.routers.api.rule=Host(`api.example.com`)
- traefik.http.services.api.loadbalancer.server.port=3000Когда прокси и healthcheck работают вместе, деплой идёт так: поднимается новый контейнер, проходит healthcheck, прокси переводит на него трафик, старый гасится. Пользователь ничего не замечает.
Если Traefik кажется лишним, есть путь попроще: оставить nginx вне контейнеров и по очереди переключать два порта. Но это ручная работа с высокой вероятностью ошибки.
Где запускать миграции
Самая частая ошибка — запускать миграции при старте приложения. Если поднимутся две копии, обе начнут миграцию одновременно.
Правильный путь — отдельный одноразовый шаг:
docker compose run --rm api bun run db:migrate
docker compose up -dЕсли миграция прошла, деплой продолжается; если нет — останавливается, и старая версия продолжает работать. Это ровно то поведение, которое нужно.
Бэкап — самая важная часть
Сделать всё остальное правильно и забыть про бэкап — самая дорогая ошибка.
Минимальное решение: ежедневный дамп, копия во внешнее место и проверка восстановления.
#!/bin/bash
set -euo pipefail
STAMP=$(date +%F)
docker compose exec -T db pg_dump -U postgres app | gzip > "/backup/app-$STAMP.sql.gz"
find /backup -name 'app-*.sql.gz' -mtime +14 -deleteТретий пункт — самый важный и самый пропускаемый. Непроверенный бэкап — не бэкап, а надежда. Хотя бы раз восстановите его в пустую базу и сверьте цифры.
Чего делать не стоит
Есть несколько соблазнительных вещей, которые на одном сервере приносят вред.
Держать базу в контейнере — но без volume. Забыли volume — и первый же docker compose down -v стирает все данные.
Подключать код через volume. Удобно локально, а в проде делает неясным, что вообще содержит образ. В проде должен использоваться только образ.
Тег `latest`. Вы не знаете, какая версия работает, и не можете откатиться. Ставьте на каждый деплой конкретный тег.
Запихивать всё в один контейнер. База, приложение и nginx в одном образе — это не использование Docker, а его неправильное использование.
Финальный чеклист
Прежде чем называть стек продовым, проверьте:
- У каждого сервиса есть
restart: unless-stopped? - У каждого сервиса есть настоящий
healthcheck, а не просто проверка порта? - Ограничен ли объём логов?
- Секреты хранятся в файлах, а не в
environment? - Миграции идут отдельным шагом?
- Бэкап автоматический и восстановление проверено?
- После перезагрузки сервера всё поднимается само? (Проверить легко:
sudo reboot.)
Последний пункт обязательно проверьте хотя бы раз. Жить с убеждением, что теоретически всё должно работать, — значит рано или поздно провести неожиданную ночь.