Управление Docker через удобный веб-интерфейс Portainer

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

Что такое Portainer?

Portainer — это легковесное универсальное решение для управления контейнерами Docker, Swarm, Kubernetes и Azure ACI. Он позволяет легко разворачивать приложения, управлять стеками, образами, сетями и томами через визуальный интерфейс, не запоминая сложные команды.

Предварительные требования

  • Сервер с операционной системой Linux (например, Ubuntu, Debian, CentOS).
  • Права доступа sudo или root.
  • Стабильное интернет-соединение для загрузки образов.

Пошаговая инструкция по установке Portainer

Шаг 1: Установка Docker и Docker Compose

Если Docker уже установлен в вашей системе, смело пропускайте этот шаг. Если нет — выполните следующие команды в терминале для автоматической установки последней версии Docker.

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh ./get-docker.sh

Важно: После завершения установки рекомендуется убедиться, что Docker работает корректно. Проверьте версии установленных утилит:

docker -v
docker compose version

Эти команды выведут информацию о версиях, что подтвердит успешность установки.

Шаг 2: Создание рабочего каталога

Для поддержания порядка на сервере рекомендуется создавать отдельные каталоги для каждого приложения. Создадим каталог для Portainer в директории /opt.

cd /opt
sudo mkdir twportainer
cd ./twportainer

Шаг 3: Создание файла конфигурации Docker Compose

Docker Compose позволяет описать конфигурацию вашего приложения в YAML-файле, что упрощает развертывание и управление. Создадим файл docker-compose.yml в нашем новом каталоге.

sudo nano docker-compose.yml

Скопируйте и вставьте следующую конфигурацию в открывшийся редактор:

version: "3.3"
services:
  twportainer:
    image: portainer/portainer-ce:latest
    container_name: twportainer
    environment:
      - TZ=Europe/Moscow
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /opt/twportainer/portainer_data:/data
    ports:
      - "8000:8000"
      - "9443:9443"
    restart: always

Разберем ключевые параметры конфигурации:

  • image: portainer/portainer-ce:latest: Указывает Docker использовать последнюю версию Community Edition Portainer.
  • container_name: twportainer: Присваивает контейнеру понятное имя для удобства управления.
  • environment: TZ=Europe/Moscow: Устанавливает корректную временную зону для контейнера.
  • volumes: Монтирует важные каталоги.
    • /var/run/docker.sock:/var/run/docker.sock: Критически важный параметр, который дает Portainer доступ к API Docker демона на хосте.
    • /opt/twportainer/portainer_data:/data: Сохраняет все данные Portainer (учетные записи, настройки) на хост-машине, чтобы они не были потеряны при пересоздании контейнера.
  • ports: Пробрасывает порты контейнера на хост.
    • 9443:9443: Основной порт для безопасного HTTPS-доступа к веб-интерфейсу.
    • 8000:8000: Дополнительный порт, который может использоваться для туннеля к Edge-агентам.
  • restart: always: Гарантирует, что Portainer автоматически перезапустится после перезагрузки сервера или в случае сбоя.

После вставки сохраните файл и закройте редактор (в nano — Ctrl+X, затем Y и Enter).

Шаг 4: Запуск Portainer

Всё готово для запуска. Из каталога /opt/twportainer выполните команду:

docker compose up -d

Ключ -d (detach) запустит контейнер в фоновом режиме. Docker загрузит образ portainer-ce и запустит контейнер согласно вашей конфигурации

Шаг 5: Доступ к веб-интерфейсу

После успешного запуска Portainer будет доступен через безопасное HTTPS-соединение. Откройте ваш веб-браузер и перейдите по адресу:

https://<IP-ВАШЕГО-СЕРВЕРА>:9443

Замените <IP-ВАШЕГО-СЕРВЕРА> на реальный IP-адрес вашего сервера или используйте localhost, если работаете прямо на нем.

Шаг 6: Первоначальная настройка и создание администратора

При первом входе система попросит вас создать учетную запись администратора.

  1. Введите имя пользователя (например, admin).
  2. Придумайте и подтвердите надежный пароль. Требования к паролю: не менее 12 символов.
  3. Нажмите кнопку «Create user».

После этого вы автоматически войдете в главный интерфейс Portainer. Вам будет предложено подключить среду (ваш локальный Docker), после чего вы получите полный контроль над вашими контейнерами, образами, сетями и т.д.


Поздравляем! Вы успешно установили Portainer и теперь можете управлять вашим Docker-окружением через удобный веб-интерфейс. Это значительно ускорит и упростит такие задачи, как деплой приложений, мониторинг работы контейнеров и управление ресурсами.