Перейти к содержимому

Статья 65 из 141

Гайды

Dockge на VPS: веб-панель для стеков Docker Compose от автора Uptime Kuma

Dockge — лёгкая веб-панель для стеков Docker Compose. Её написал автор Uptime Kuma. Dockge не прячет compose-файлы в свою базу: каждый стек лежит обычной папкой с compose.yaml на диске. Вы можете править его в панели или по SSH, а запускать через панель или через docker compose. Подойдёт тем, кому Portainer кажется слишком тяжёлым и нужен только удобный редактор стеков.

Статья проверена на Dockge 1.5.0 (ноябрь 2026).

Ресурс Минимум
RAM 256 МБ свободной памяти под саму панель
vCPU 1
Диск 1 ГБ плюс место под ваши стеки
ПО Docker и Docker Compose версии 20 и новее

Dockge хранит свои данные в /opt/dockge, а стеки в /opt/stacks. Создайте каталоги и скачайте официальный compose.yaml:

Окно терминала
mkdir -p /opt/stacks /opt/dockge
cd /opt/dockge
curl https://raw.githubusercontent.com/louislam/dockge/master/compose.yaml --output compose.yaml

Откройте файл и привяжите порт к 127.0.0.1, чтобы панель не была видна из интернета:

Окно терминала
nano compose.yaml
services:
dockge:
image: louislam/dockge:1
restart: unless-stopped
ports:
- 127.0.0.1:5001:5001
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- ./data:/app/data
- /opt/stacks:/opt/stacks
environment:
- DOCKGE_STACKS_DIR=/opt/stacks
Окно терминала
docker compose up -d
docker compose logs

В логе должна появиться строка Listening on 5001.

Путь к стекам. Слева и справа от двоеточия в строке /opt/stacks:/opt/stacks должен быть один и тот же полный путь, и он же указывается в DOCKGE_STACKS_DIR. Если пути не совпадут, Dockge будет создавать файлы не там, где их ищет Docker. Хотите другой каталог, поменяйте все три места сразу.

Пока домен не настроен, откройте панель через SSH-туннель с вашего компьютера:

Окно терминала
ssh -L 5001:127.0.0.1:5001 root@IP_СЕРВЕРА

и перейдите на http://localhost:5001.

При первом открытии Dockge показывает форму Создайте учетную запись администратора. Выберите Язык (русский есть), задайте Имя пользователя и пароль, нажмите Создать.

Форма создания администратора Dockge

Откроется Главная. Слева список стеков с отметкой состояния (акт. означает запущен), в центре счётчики и блок Docker Run: вставьте туда команду docker run ... и нажмите Преобразовать в Compose, панель сама сделает из неё compose-файл.

Главная страница Dockge со списком стеков

В списке будут и стеки, которые вы запускали раньше через docker compose из других папок. Dockge их видит, но полноценно управляет только теми, что лежат в /opt/stacks. Перенесите туда папку проекта, если хотите редактировать его из панели.

  1. Нажмите + Compose вверху слева.
  2. В поле Имя стека введите имя: только строчные буквы, цифры и -. Так будет называться папка в /opt/stacks.
  3. Вставьте compose-файл в редактор справа. Например, тестовый сервис:
services:
whoami:
image: traefik/whoami
restart: unless-stopped
ports:
- "127.0.0.1:8085:80"
  1. Переменные окружения можно вынести в поле .env под редактором. Блок Сети позволяет подключить стек к уже существующей сети Docker.

Создание стека в Dockge: имя и compose.yaml

  1. Нажмите Развернуть. Кнопка Сохранить только записывает файлы, не запуская контейнеры.

Dockge скачает образ, запустит контейнеры и откроет страницу стека.

Страница стека: контейнер running и вывод логов

На диске появится обычная папка:

/opt/stacks/whoami/
├── compose.yaml
└── .env

На странице стека:

Элемент Что делает
Изменить открыть compose-файл на редактирование, затем Развернуть
Перезапустить docker compose restart
Обновить скачать новые образы и пересоздать контейнеры
Остановить остановить стек, в меню рядом есть Остановить и деактивировать
Удалить удалить контейнеры и папку стека
Terminal живой вывод логов всех контейнеров стека
Bash у контейнера открыть шелл внутри контейнера

Если в образе нет bash, терминал покажет ошибку executable file not found. Нажмите Switch to sh вверху терминала.

Пункт Консоль в верхнем меню по умолчанию выключен. Он даёт шелл внутри контейнера Dockge с доступом к Docker сервера. Включается переменной DOCKGE_ENABLE_CONSOLE=true, но без необходимости не включайте его.

Dockge работает через WebSocket, поэтому в конфиге нужны заголовки Upgrade и Connection. Файл /etc/nginx/sites-available/dockge:

server {
listen 80;
server_name dockge.example.com;
location / {
proxy_pass http://127.0.0.1:5001;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Окно терминала
ln -s /etc/nginx/sites-available/dockge /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d dockge.example.com

Подробнее: Nginx, Let’s Encrypt, DNS.

  • Dockge подключён к docker.sock, поэтому доступ к панели равен доступу root к серверу. Используйте длинный пароль.
  • Не открывайте порт 5001 наружу. В файрволе оставьте 22, 80 и 443.
  • Для лишней защиты ограничьте домен панели по IP в Nginx (allow ВАШ_IP; deny all; внутри location).
  • Пароль меняется в меню профиля: Настройки → Безопасность.
Окно терминала
cd /opt/dockge
docker compose pull && docker compose up -d

Текущую версию видно в Настройки → О продукте.

Сохраняйте два каталога:

Каталог Что там
/opt/dockge/data база Dockge: пользователь и настройки
/opt/stacks compose-файлы и .env всех стеков
Окно терминала
tar -czf /root/dockge-$(date +%F).tar.gz /opt/dockge/data /opt/stacks

Данные самих приложений (тома Docker или папки, подключённые в стеках) копируйте отдельно. Храните архивы вне сервера: бэкапы.

Симптом Причина и решение
Стек создан, но файлы не там, где ожидали Пути стеков слева и справа в volumes и в DOCKGE_STACKS_DIR не совпадают
Через домен панель грузится, но не обновляется В Nginx нет заголовков Upgrade и Connection
executable file not found в терминале контейнера В образе нет bash. Нажмите Switch to sh
Старый стек виден, но не редактируется Его папка не в /opt/stacks. Перенесите её и нажмите Сканировать папку стеков в меню профиля
Ошибка при развёртывании про порт Порт уже занят другим контейнером. Поменяйте его в ports

Для настройки HTTPS через веб-интерфейс можно поставить рядом Nginx Proxy Manager. Про сам формат compose-файлов: стек Docker Compose.