Как работает NginxForge
NginxForge — это не «рандомный генератор», а воспроизводимый pipeline с фиксированными шаблонами под каждый стек.
Pipeline генерации конфига
1
Выбираешь сценарий
FastAPI, Django, WordPress, WebSocket — 16 готовых сценариев под разные стеки. Или
custom для ручной сборки.2
Заполняешь параметры
Домен, порт, SSL, путь к сертификатам, upstream-адрес, Worker-процессы и другие настройки — зависит от сценария.
3
Нажимаешь «Сгенерировать»
Backend рендерит
nginx.conf через Jinja2-шаблон, специфичный для сценария. Конфиг возвращается в ответе API — на сервере не сохраняется.4
Получаешь nginx.conf + предупреждения
Валидатор автоматически проверяет конфиг на 10 типов проблем и прогоняет через реальный nginx -t в изолированном контейнере. Предупреждения показываются с объяснениями.
5
Включаешь аннотации — читаешь объяснения
Переключатель «Аннотации к директивам» показывает русскоязычные пояснения к каждой строке конфига.
6
Копируешь / скачиваешь ZIP / делишься ссылкой
Три варианта экспорта: копировать конфиг, скачать ZIP с
docker-compose.yml, создать публичную share-ссылку.Сценарии (16 штук)
| Сценарий | Для чего | Ключевые настройки |
|---|---|---|
| fastapi / django / nodejs / gunicorn | Python/Node backend | proxy_pass, upstream, timeout |
| laravel / wordpress / php-fpm | PHP стек | PHP-FPM socket, static cache, PHP version |
| websocket | Real-time приложения | Upgrade, Connection headers |
| minio | S3-совместимое хранилище | client_max_body_size, proxy settings |
| static | Статический сайт | root, try_files, cache headers |
| reverse_proxy | Универсальный reverse proxy | proxy_pass, headers, buffering |
| load-balancer | Балансировка нагрузки | upstream pool, least_conn / round_robin |
| nextjs | Next.js SSR приложение | Node upstream, static assets |
| microservices | Маршрутизация микросервисов | Multiple location blocks, upstream |
| custom | Ручная сборка | Все параметры, без preset |
Аннотации директив
- info — информационное пояснение. Что делает директива, почему она здесь и какие значения типичны.
- warning — потенциальная проблема. На что обратить внимание перед деплоем.
- danger — риск безопасности. Рекомендуется исправить перед выходом в продакшен.
В базе 75 директив с аннотациями. Включить: переключатель «Аннотации к директивам» в панели вывода.
Валидатор конфига
Двухуровневая проверка: статический анализ текста (10 типов проблем) плюс реальный
nginx -t
в изолированном Docker-контейнере. Запускается автоматически после генерации.
| Тип | Уровень | Пример |
|---|---|---|
| unbalanced_braces | error | Незакрытый блок server { |
| missing_semicolon | error | keepalive_timeout 65 без ; |
| empty_server_name | error | server_name ; |
| server_tokens_on | warning | Раскрывает версию nginx |
| deprecated_tls | warning | TLSv1.0 / TLSv1.1 |
| weak_ssl_ciphers | warning | Без !aNULL !MD5 |
| unlimited_body_size | warning | client_max_body_size 0 |
| proxy_pass_trailing_slash | info | Поведение при проксировании |
| root_trailing_slash | info | Дублирование / в пути |
| high_worker_processes | info | Больше CPU на хосте |
✅ NginxForge автоматически проверяет ваш конфиг через реальный
nginx -t в изолированном Docker-контейнере — ещё до того, как вы скопируете его на сервер. Всё равно рекомендуем повторно запустить nginx -t в своём окружении перед деплоем — версия nginx и layout файлов могут отличаться.
Экспорт ZIP
Кнопка «Скачать ZIP» создаёт архив со всем необходимым для запуска:
nginxforge-export/
├── nginx/nginx.conf — готовый конфиг
├── docker-compose.yml — docker compose для вашего стека
├── .env.example — переменные окружения
└── README.md — инструкция по запуску
├── nginx/nginx.conf — готовый конфиг
├── docker-compose.yml — docker compose для вашего стека
├── .env.example — переменные окружения
└── README.md — инструкция по запуску