Dockge: Почему я променял Portainer на этот лёгкий инструмент (и вам советую)

Dockge — лёгкий веб-интерфейс для управления стеками Docker Compose. Он не хранит конфигурацию в своей базе: каждый стек — это обычная папка с файлом compose.yaml на диске, а Dockge позволяет создавать, редактировать, запускать и останавливать эти стеки из браузера. Его написал автор Uptime Kuma, проект распространяется под лицензией MIT.

Я долго пользовался Portainer и перешёл на Dockge для своих серверов. Ниже — почему, что при этом теряешь и как перенести стеки без простоя.

Чем меня не устраивал Portainer

Portainer умеет многое: Kubernetes, Swarm, образы, сети, тома, роли пользователей. Но у него есть особенность, которая мешает при небольших установках: стеки, созданные через интерфейс, живут внутри Portainer. Файл docker-compose.yaml не лежит в понятном месте на диске, его нельзя просто открыть в редакторе или положить в Git без дополнительной настройки.

Для одного-трёх серверов с десятком сервисов мне нужна была обратная схема: файлы — главный источник правды, интерфейс — удобство поверх них.

Как устроен Dockge

• Файлы на диске. По умолчанию стеки лежат в /opt/stacks (путь задаётся переменной DOCKGE_STACKS_DIR). Создали вручную /opt/stacks/myapp/compose.yaml — Dockge увидит новый стек. Поправили файл в терминале — изменения видны в интерфейсе.
• Удаление Dockge ничего не ломает. Контейнеры и файлы остаются на месте, управлять ими можно обычным docker compose.
• Редактор compose.yaml с подсказками и веб-терминал.
• Конвертер docker run → compose.yaml: вставляете команду из README проекта и получаете готовый файл.
• Несколько хостов. С версии 1.4.0 Dockge умеет подключать агенты и управлять стеками на нескольких Docker-хостах из одного окна.

Честно о развитии проекта

Dockge развивается медленно: последний выпуск — 1.5.0 от марта 2025 года, изменения в репозитории появляются редко. Для инструмента, который лишь управляет файлами Compose, это не критично — стеки останутся рабочими при любой судьбе проекта. Но если нужны новые функции и активная поддержка, это стоит учитывать.

Установка

Требования по README: Docker 20+ (или Podman), Linux — Ubuntu, Debian Bullseye и новее, CentOS, Fedora, Arch; архитектуры amd64, arm64, armv7. Windows не поддерживается.

mkdir -p /opt/stacks /opt/dockge
cd /opt/dockge
curl https://raw.githubusercontent.com/louislam/dockge/master/compose.yaml --output compose.yaml
docker compose up -d

Интерфейс открывается на порту 5001: http://адрес-сервера:5001. При первом входе создаётся учётная запись администратора.

Обновление — из того же каталога:

cd /opt/dockge
docker compose pull && docker compose up -d

Порт 5001 не стоит открывать в интернет: через Dockge можно запускать любые контейнеры, то есть фактически управлять сервером. Доступ — через VPN, SSH-туннель или обратный прокси с авторизацией.

Dockge или Portainer

Что вы теряете при переходе: управление Kubernetes и Swarm, роли пользователей, подробную работу с образами, сетями и томами из интерфейса. Если это нужно — оставайтесь на Portainer.

Когда Dockge лучше: несколько VPS или домашний сервер, всё описано в Compose, вы хотите держать файлы в понятных каталогах и править их как в интерфейсе, так и в терминале.

Перенос стеков из Portainer

Контейнеры не зависят от того, чем вы ими управляете, поэтому переезд проходит без потери данных — при аккуратности с томами.

1. Проверьте, где лежат данные. Привязанные каталоги (/путь/на/хосте:/путь/в/контейнере) остаются на диске. Именованные тома Docker тоже сохраняются при пересоздании контейнера. Перед переездом сделайте резервную копию важных данных или снимок сервера.
2. Скопируйте YAML стека в Portainer: Stacks → стек → Editor.
3. Остановите стек в Portainer. Не удаляйте его вместе с томами, пока не убедитесь, что в Dockge всё работает.
4. Создайте стек в Dockge: «+ Compose», имя стека, вставить YAML, Save и Deploy.
5. Проверьте пути. Относительные пути вида ./data теперь считаются от каталога стека /opt/stacks/<имя>/. Надёжнее указать абсолютные пути к прежним данным или перенести каталог.
6. Одиночные контейнеры без стека переносятся через конвертер: вставьте команду docker run в поле конвертера, получите compose.yaml и разверните его.

Если ваши файлы Compose уже лежат на диске, достаточно разложить их по папкам внутри каталога стеков — Dockge подхватит их сам.

Итог

Dockge делает одну вещь — управляет файлами Docker Compose — и делает её удобно, не забирая у вас конфигурацию. Мне этого хватает для своих серверов. Для кластеров, команд с разграничением прав и подробного управления ресурсами Docker по-прежнему нужен Portainer, а медленное развитие Dockge стоит держать в голове.