Portainer install: установка и запуск в Docker на Ubuntu 24.04
Portainer это веб-панель для управления Docker. На Ubuntu 24.04 её запускают отдельным контейнером с томом для данных и публикацией порта 9443. После первого входа панель попросит задать пароль администратора.
01Проверьте, что Docker установлен
Portainer работает поверх Docker, поэтому на сервере уже должен быть установлен Docker Engine. Проверьте это одной командой. Если команда не найдена, установите Docker по инструкции для Ubuntu 24.04 и вернитесь к этому шагу.
docker --version
02Создайте том для данных Portainer
Данные панели, включая пользователей и настройки, хранятся в именованном томе. Создайте его заранее, чтобы том не потерялся при пересоздании контейнера. Том переживает удаление контейнера.
docker volume create portainer_data
03Запустите контейнер Portainer
Запустите официальный образ Portainer CE с публикацией порта 9443 для веб-интерфейса и порта 8000 для edge-агентов. Порт 9443 работает по HTTPS. Ключ --restart always поднимает контейнер после перезагрузки сервера.
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.
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 и том с данными настроены верно.
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 docker images: работа с образами Docker на Ubuntu 24.04 Как работать с docker images на Ubuntu 24.04: проверить демон, скачать образ через docker pull, посмотреть список, запустить контейнер и проверить результат.
- Руководство · Docker Установка Docker и Docker Compose на Ubuntu 24.04 Пошаговая установка Docker и Docker Compose на Ubuntu 24.04: команды, настройка compose.yaml, проверка работы и разбор частых ошибок.
- Руководство · Docker Как запустить Docker container на Ubuntu 24.04: пошаговая инструкция Запустите контейнер через docker compose up -d, проверьте статус, посмотрите логи, войдите в контейнер через exec и остановите проект. Команды и проверка.
- Руководство · Docker Установка Portainer на Ubuntu 24.04: пошаговая настройка Установите Portainer в Docker Compose на Ubuntu 24.04: проверка Docker, compose-файл, запуск, доступ к панели и проверка через curl и docker compose ps.
- Руководство · Docker Docker volumes: настройка и проверка на Ubuntu 24.04 Пошаговая настройка docker volumes на Ubuntu 24.04: создание тома, подключение к контейнеру, проверка сохранности данных после перезапуска и типичные ошибки.
- Руководство · Docker Установка GitLab в Docker на Ubuntu 24.04 Установите GitLab в Docker на Ubuntu 24.04: подготовка, compose-файл, запуск, проверка и типичные ошибки с командами.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы