К содержимому

Установка Portainer на Ubuntu 24.04: пошаговая настройка

Portainer это веб-панель для управления Docker. На Ubuntu 24.04 её запускают контейнером через Docker Compose, а панель слушает порт 9443.

Руководство Docker 3 мин чтения

01Проверьте, что Docker и Compose установлены

Portainer работает поверх Docker, поэтому на сервере нужны Docker Engine и плагин Compose v2. Проверьте обе команды. Если Docker не установлен, поставьте его по инструкции для Ubuntu 24.04 и вернитесь к этому шагу.

bash
docker --version
docker compose version

02Создайте каталог и compose-файл

Создайте отдельный каталог для Portainer и файл compose.yaml. В файле один сервис portainer с образом portainer/portainer-ce:latest. Порт публикуется только на localhost: 127.0.0.1:9443:9443. Так панель не открыта всему интернету, а доступ к ней идёт через SSH-туннель или обратный прокси.

bash
mkdir -p /opt/portainer
cd /opt/portainer
nano compose.yaml

03Заполните compose-файл

Вставьте в compose.yaml сервис Portainer. Именованный том portainer_data хранит базу панели и переживает перезапуск контейнера. Порт 9443 публикуется только на 127.0.0.1, поэтому снаружи он недоступен. Ключ version: не нужен, в Compose v2 он устарел.

yaml
services:
  portainer:
    image: portainer/portainer-ce:latest
    container_name: portainer
    restart: unless-stopped
    ports:
      - "127.0.0.1:9443:9443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data

volumes:
  portainer_data:

04Проверьте compose-файл

Команда docker compose config проверяет YAML и печатает итоговый конфиг. Если в файле ошибка отступов, вы увидите сообщение вида yaml: line 12: did not find expected key. Отступы делайте пробелами, не табуляцией.

bash
docker compose config

05Запустите Portainer

Запустите сервис в фоне. Docker скачает образ portainer/portainer-ce и создаст контейнер. Если порт 9443 уже занят, появится ошибка Bind for 0.0.0.0:9443 failed: port is already allocated, и тогда проверьте, кто держит порт.

bash
docker compose up -d

06Проверьте, что Portainer работает

Убедитесь, что контейнер в состоянии running, и проверьте ответ панели по HTTPS на localhost. Команда curl должна вернуть HTTP-код 200 или 302. Если код 000, контейнер не слушает порт или упал.

bash
docker compose ps
curl -k -s -o /dev/null -w "%{http_code}\n" https://127.0.0.1:9443/

07Откройте панель и создайте администратора

Панель слушает только 127.0.0.1:9443, поэтому откройте её через SSH-туннель с рабочей машины: ssh -L 9443:127.0.0.1:9443 user@203.0.113.10. Затем зайдите в браузере на https://127.0.0.1:9443/ и задайте пароль администратора. После входа Portainer покажет локальное окружение Docker.

bash
ssh -L 9443:127.0.0.1:9443 user@203.0.113.10

Частые ошибки

  • Порт 9443 публикуют как 9443:9443, и панель с доступом к docker.sock открывается всему интернету. UFW такой порт не закрывает, потому что опубликованные порты Docker обходят UFW.

    Публикуйте порт только на localhost: 127.0.0.1:9443:9443. Доступ к панели держите через SSH-туннель или обратный прокси с авторизацией.

  • После docker compose up -d появляется Bind for 0.0.0.0:9443 failed: port is already allocated.

    Порт 9443 уже занят другим контейнером или процессом. Найдите его командой sudo ss -ltnp и остановите лишний процесс или смените публикуемый порт в compose.yaml.

  • docker compose up -d завершается с permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.

    Пользователь не в группе docker или не перелогинился после sudo usermod -aG docker $USER. Выйдите из сессии и войдите снова.

  • docker compose up -d пишет no configuration file provided: not found.

    Команда запущена не из каталога с compose.yaml. Перейдите в /opt/portainer или укажите путь через -f.

Deploykin

Как это делается в Deploykin

В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

На каком порту работает Portainer?

Панель Portainer слушает порт 9443 по HTTPS. В примере он опубликован как 127.0.0.1:9443:9443, поэтому доступен только с самого сервера.

Как открыть Portainer, если порт закрыт на localhost?

Используйте SSH-туннель: ssh -L 9443:127.0.0.1:9443 user@203.0.113.10, затем откройте https://127.0.0.1:9443/ в браузере. Другой вариант: поставить перед Portainer обратный прокси с авторизацией.

Где Portainer хранит данные?

В именованном томе portainer_data, который подключён к /data в контейнере. Том переживает docker compose down, а удаляет его docker compose down -v.

Можно ли запустить Portainer без Docker Compose?

Да, командой docker run, но в примере используется Compose: так проще обновлять образ и хранить настройки в файле. Для обновления выполните docker compose pull и docker compose up -d.

Ещё по теме

Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.