Docker Compose для Node.js / NestJS + PostgreSQL + Nginx Reverse Proxy
Готовый стек Docker Compose для приложений Node.js, Express и NestJS: мультистейдж сборка, PostgreSQL 16, Nginx Reverse Proxy и healthcheck.
Интерактивный генератор под ваши параметры
Параметры подставляются в код в реальном времени
docker-compose.yml
# docker-compose.yml
version: '3.8'
services:
api:
build:
context: .
dockerfile: Dockerfile
container_name: node_api
restart: always
environment:
NODE_ENV: production
PORT: 3000
DATABASE_URL: postgresql://node_user:NodePassword2026!@postgres:5432/node_api_db
depends_on:
- postgres
networks:
- backend
postgres:
image: postgres:16-alpine
container_name: node_db
restart: always
environment:
POSTGRES_DB: node_api_db
POSTGRES_USER: node_user
POSTGRES_PASSWORD: NodePassword2026!
volumes:
- pgdata:/var/lib/postgresql/data
networks:
- backend
nginx:
image: nginx:alpine
container_name: node_gateway
restart: always
ports:
- "80:80"
- "443:443"
volumes:
- ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
depends_on:
- api
networks:
- backend
networks:
backend:
driver: bridge
volumes:
pgdata:
Разбор ключевых директив конфигурации
Техническое обоснование директив и их прямое влияние на процессор (CPU), оперативную память (RAM) и дисковый ввод-вывод (NVMe I/O).
| Директива / Блок | Рекомендуемое значение | Зачем нужно и системное влияние (CPU / RAM / I-O) |
|---|---|---|
DATABASE_URL: postgresql://... |
Connection String | Формирует стандартную строку подключения для Prisma ORM, TypeORM или Sequelize. |
restart: unless-stopped |
unless-stopped | Обеспечивает автоматический перезапуск контейнеров при сбое демона Docker или перезагрузке VDS. |
logging / max-size: 10m |
max-size: 10m, max-file: 3 | Ограничивает размер логов контейнеров на диске, предотвращая переполнение дискового пространства NVMe (100% Disk Full). |
volumes / app_data |
named volume / local bind | Выносит базу данных и загружаемые файлы в постоянные тома, предотвращая потерю данных при обновлении контейнеров. |
Рекомендуемые системные требования VDS под этот стек
Расчет минимальной и оптимальной конфигурации виртуального сервера для стабильной работы без сбоев.
Оптимальный сайзинг: 2 vCPU, 4 GB RAM, 40 GB NVMe
Расчетная нагрузка: Node.js REST API до 1 000 RPS
2 CPU / 4 GB NVMe
Timeweb Cloud
Рекомендуемые ресурсы
2 vCPU /
4 GB RAM /
40 GB NVMe
2 vCPU / 4 GB RAM
Selectel
Рекомендуемые ресурсы
2 vCPU /
4 GB RAM /
40 GB NVMe
Turbo 4 GB
Beget
Рекомендуемые ресурсы
2 vCPU /
4 GB RAM /
40 GB NVMe
Онлайн-утилиты SysKit для проверки этого сервера
Протестируйте корректность применения конфигурации прямо сейчас в один клик.
Частые ошибки при настройке и их решение (FAQ)
Типовые проблемы вебмастеров и сисадминов при внедрении данной конфигурации.
Как передать переменные окружения из .env файла?
В секцию сервиса добавьте `env_file: .env`, и Docker Compose автоматически загрузит все ключи.
Как запустить и остановить стек в фоновом режиме?
Запуск: `docker compose up -d`. Остановка: `docker compose down`. Просмотр логов: `docker compose logs -f`.
Ошибка: Port already allocated (порт 80/443 занят)
Проверьте, не запущен ли локальный Nginx или Apache: `systemctl stop apache2` или `systemctl stop nginx`, либо измените внешний порт в `ports: ["8080:80"]`.
Рекомендуемые смежные конфигурации
Дополнительные рецепты и калькуляторы для полной оптимизации данного серверного стека.