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

Если вы занимаетесь self-hosting’ом, держите домашнюю лабораторию или управляете небольшим VPS, то наверняка знакомы с Portainer. Это де-факто стандарт: мощный, всеобъемлющий «швейцарский нож» для Docker.

Но давайте будем честны: иногда швейцарский нож слишком тяжёлый, когда нужно просто почистить яблоко.

Недавно я открыл для себя Dockge — инструмент от того же разработчика, что и популярный Uptime Kuma. Он заставил меня полностью пересмотреть подход к управлению контейнерами. В этой статье расскажу, почему Dockge может стать идеальной заменой Portainer для многих сценариев.

Проблема с Portainer

Я люблю Portainer. Он умеет всё: Kubernetes, Swarm, управление образами, сетями и томами. Но есть одна фундаментальная особенность, которая часто раздражает: он прячет конфигурацию.

Когда вы создаёте «Stack» в Portainer, ваш docker-compose.yaml живёт в его внутренней базе данных. Если Portainer упадёт или база повредится — конфиги под угрозой. Конечно, можно подключить Git-репозиторий, но это добавляет лишний шаг в простой процесс.

Что такое Dockge?

Dockge (произносится как «Додж» — от Docker + Dodge) — это реактивный, современный и невероятно лёгкий менеджер для docker-compose.yaml.

Его главная философия: Ваши файлы — источник истины.

В отличие от Portainer, Dockge не прячет конфиги в своей БД. Он просто читает и управляет папками с compose.yaml на диске. Удалите Dockge — контейнеры и конфиги останутся на месте, аккуратно разложенные по папкам.

5 причин перейти на Dockge

Вот ключевые фичи, которые заставили меня мигрировать:

1. Файловая структура — основа всего
   Dockge работает напрямую с файловой системой.

   • Создаёте папку /opt/stacks.
   • Dockge сканирует её.
   • Вручную создаёте /opt/stacks/my-app с compose.yaml внутри — Dockge мгновенно видит новый стек.
   • Редактируете файл в терминале (vim/nano) — изменения сразу отражаются в UI.

2. Конвертер docker run → Compose
   Киллер-фича! Сколько раз вы находили проект на GitHub с огромной командой docker run ...?
   В Dockge вставляете эту команду в специальное поле — и получаете готовый валидный YAML. Никакой ручной конвертации.

3. Интерактивный редактор
   Гибридный подход: слева — чистый YAML-код, справа — визуальные поля (порты, volumes, env). Меняете одно — синхронизируется другое. Работает невероятно плавно.

4. Лёгкость и скорость (Reactive UI)
   Если вы использовали Uptime Kuma, то знаете этот приятный интерфейс. Dockge построен на тех же технологиях: мгновенный отклик, минимум кликов, никаких задержек.

5. Поддержка нескольких серверов (агенты)
   Dockge позволяет управлять множеством Docker-хостов из одного интерфейса, сохраняя при этом простоту настройки.

Сравнение: Dockge vs Portainer

Как установить Dockge?

Установка — яркая демонстрация философии проекта: минимум шагов.

# 1. Создаём директории
mkdir -p /opt/stacks /opt/dockge
cd /opt/dockge

# 2. Скачиваем официальный compose.yaml
curl https://raw.githubusercontent.com/louislam/dockge/master/compose.yaml --output compose.yaml

# 3. Запускаем
docker compose up -d

Открываете http://ip-вашего-сервера:5001 — и всё готово!

Совет: Если мигрируете с Portainer и ваши compose-файлы уже лежат на диске — просто укажите Dockge путь к этой папке, и он сразу подхватит стеки.

Итог: Стоит ли переходить?

Оставайтесь на Portainer, если:

• Управляете кластерами Kubernetes или Docker Swarm.
• Нужна сложная RBAC (роли и права доступа).
• Требуется детальный GUI-контроль над отдельными образами и томами.

Переходите на Dockge, если:

• У вас один или несколько VPS/домашних серверов.
• Любите порядок в файловой системе.
• Хотите, чтобы интерфейс помогал, а не мешал.
• Устали от «тяжеловесности» Portainer для запуска десятка контейнеров.

Dockge вернул мне радость от настройки контейнеров. Это инструмент, который делает одну вещь, но делает её идеально — управляет docker-compose файлами. Попробуйте сами — возможно, ваш Portainer тоже отправится на заслуженный отдых.

🛠 Гайд: Безболезненная миграция с Portainer на Dockge

Многих останавливает страх сломать работающие сервисы. Спокойно! Контейнеры изолированы от инструмента управления, миграция проходит гладко.

Шаг 0: Подготовка и бэкап Убедитесь, где хранятся данные контейнеров (volumes).

• Bind mounts (/path/on/host:/path/in/container) — данные на диске, в безопасности.
• Named volumes — внутри Docker, не исчезнут при пересоздании.

Сделайте бэкап важных данных или снапшот сервера.

Шаг 1: Экспорт конфигурации из Portainer

1. Зайдите в Stacks → выберите стек → Editor.
2. Скопируйте весь YAML в буфер.

Шаг 2: Остановка в Portainer

1. Stop the stack.
2. Опционально: удалите стек позже, когда убедитесь, что всё работает в Dockge (не удаляйте volumes!).

Шаг 3: Развёртывание в Dockge

1. Откройте Dockge (http://ip:5001).

2. Нажмите + Compose → введите имя стека.

3. Вставьте скопированный YAML.

4. Проверьте пути к volumes:

   • Относительные пути (./data) будут относительно папки стека в Dockge (/opt/stacks/<name>/).
   • Рекомендую использовать абсолютные пути или переместить данные.

5. Save → Deploy.

Одиночные контейнеры (не из стеков)?

1. • Compose → вставьте команду docker run ... в поле конвертера.
2. Dockge создаст YAML автоматически → Deploy.

Готово! Теперь ваши конфиги — в обычных текстовых файлах, а не в «чёрном ящике» базы данных.

Удачи с миграцией!