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

Portainer install: установка и запуск в Docker на Ubuntu 24.04

Portainer это веб-панель для управления Docker. На Ubuntu 24.04 её запускают отдельным контейнером с томом для данных и публикацией порта 9443. После первого входа панель попросит задать пароль администратора.

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

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

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

bash
docker --version

02Создайте том для данных Portainer

Данные панели, включая пользователей и настройки, хранятся в именованном томе. Создайте его заранее, чтобы том не потерялся при пересоздании контейнера. Том переживает удаление контейнера.

bash
docker volume create portainer_data

03Запустите контейнер Portainer

Запустите официальный образ Portainer CE с публикацией порта 9443 для веб-интерфейса и порта 8000 для edge-агентов. Порт 9443 работает по HTTPS. Ключ --restart always поднимает контейнер после перезагрузки сервера.

bash
docker run -d -p 9443:9443 -p 8000:8000 --name portainer --restart always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest

04Проверьте, что контейнер работает

Убедитесь, что контейнер находится в состоянии running и не перезапускается. Если статус отличается, посмотрите логи контейнера. Порт 9443 должен быть занят процессом Docker.

bash
docker ps --filter name=portainer
sudo ss -ltnp | grep 9443

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

Откройте в браузере https://203.0.113.10:9443. Сертификат самоподписанный, поэтому браузер покажет предупреждение, его нужно принять. При первом входе Portainer попросит задать пароль администратора: укажите логин admin и пароль не короче 12 символов. Сохраните пароль, восстановить его через панель нельзя.

06Подключите локальное окружение Docker

После входа выберите окружение local, оно указывает на сокет /var/run/docker.sock самого сервера. Нажмите Connect. Панель покажет список контейнеров, образов и томов. Если список пуст, проверьте, что сокет смонтирован в контейнер Portainer.

07Проверьте работу панели

Создайте тестовый контейнер через панель или откройте раздел Containers и убедитесь, что виден контейнер portainer. Затем перезагрузите сервер и проверьте, что панель снова доступна по тому же адресу. Это подтверждает, что --restart always и том с данными настроены верно.

bash
sudo reboot

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

  • Порт 9443 уже занят другим процессом, и контейнер Portainer не запускается.

    Проверьте, кто держит порт: sudo ss -ltnp | grep 9443. Остановите лишний процесс или опубликуйте Portainer на другом порту, например -p 9444:9443.

  • При открытии https://203.0.113.10:9443 браузер выдаёт ошибку сертификата, и пользователь закрывает страницу.

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

  • После перезагрузки сервера панель недоступна, контейнер не поднялся.

    Проверьте, что контейнер запускался с --restart always. Если флаг забыли, пересоздайте контейнер с ним, том portainer_data сохранит данные.

  • Панель открывается, но список контейнеров пуст или окружение local не подключается.

    Убедитесь, что в контейнер смонтирован сокет -v /var/run/docker.sock:/var/run/docker.sock. Без него Portainer не видит Docker на сервере.

Deploykin

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

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

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

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

Нужно ли устанавливать Docker отдельно перед Portainer?

Да, Portainer это контейнер, который управляет Docker через сокет. Сначала установите Docker Engine на Ubuntu 24.04, затем запускайте Portainer.

Какой порт использует Portainer по умолчанию?

Веб-интерфейс Portainer CE слушает порт 9443 по HTTPS. Порт 8000 нужен для edge-агентов и при обычной работе панели не используется.

Что будет с данными Portainer при удалении контейнера?

Данные хранятся в томе portainer_data. При удалении контейнера том остаётся, поэтому после повторного запуска с тем же томом настройки и пользователи сохранятся.

Чем Portainer отличается от docker compose?

Portainer даёт веб-интерфейс для контейнеров, образов, томов и стеков. docker compose управляет теми же объектами из файла и командной строки. Многие используют оба инструмента вместе.

Ещё по теме

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

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