Проблема «вечных» контейнеров
В средах self-hosted (домашних серверах) часто возникает конфликт между доступностью сервисов и эффективностью использования ресурсов. Традиционный подход требует, чтобы все контейнеры (Nextcloud, Immich, Jellyfin и др.) работали постоянно, потребляя память и процессорное время даже в часы пиковой нагрузки. Docker Wake Up решает эту задачу, внедряя модель «on-demand» (по требованию): контейнер запускается только тогда, когда к нему обращается пользователь, и выключается, когда становится неактивным.
Ключевые технические возможности
Проект представляет собой легковесный прокси-сервер, который интегрируется с любым обратным прокси (NGINX, Caddy, Traefik или Cloudflare Tunnel). Основные функции включают:
- On-Demand Startup: Автоматический запуск контейнера при получении HTTP-запроса.
- Intelligent Idle Management: Остановка контейнера после заданного периода бездействия (по умолчанию 3 дня, но настраивается).
- Live Startup Page: Пользователь видит страницу загрузки с трансляцией логов
docker composeв реальном времени. Страница автоматически перезагружается, как только сервис готов. - TCP Wake-on-Connect: Поддержка не-HTTP сервисов, таких как игровые серверы (например, Minecraft), которые запускаются при подключении клиента.
- Start/Stop Hooks: Возможность запускать произвольные команды до старта и после остановки контейнера.
Поддержка прокси-серверов и конфигурация
Система использует единый JSON-файл конфигурации для описания всех сервисов. Генератор конфигураций (proxy-generator) автоматически создает файлы для NGINX, Caddy или Traefik, подставляя правильные хосты и пути. Для HTTPS поддерживается автоматическое получение wildcard-сертификатов через Certbot (с поддержкой DNS-плагинов для Cloudflare, DigitalOcean, Route53 и др.).
| Компонент | Описание | Требования |
|---|---|---|
| NGINX | Генерация site-configs, symlink в sites-enabled, автоперезагрузка | Отсутствует Node.js (конфиги генерируются во временном контейнере) |
| Caddy | Генерация Caddyfile или меток для caddy-docker-proxy | Node.js 16+ (для хост-развертывания) или Docker |
| Traefik | Запись file-provider конфига с hot-reload | Node.js 16+ или Docker |
| Развертывание | Docker Container или SystemD/PM2 | Docker Compose для контейнерного варианта |
Почему это важно для self-hosted сообщества
Docker Wake Up снижает порог входа для владельцев слабых серверов (например, Raspberry Pi или старых ПК), позволяя запускать тяжелые приложения (видеотранскодинг, базы данных) без риска исчерпания ресурсов. Отсутствие необходимости в cron-задачах для управления жизненным циклом контейнеров делает архитектуру более надежной и простой в поддержке. Установка осуществляется одной командой ./setup-service.sh, что минимизирует время на настройку.
Источник: Github ↗
