Установка Portainer для управления Docker на Ubuntu 24.04: различия между версиями

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску
Новая статья: установка Portainer для управления Docker (проверено на Ubuntu 24.04, со снимками экрана)
 
Статья исправлена по результатам проверки: уточнён расход памяти
 
Строка 5: Строка 5:


* VDS с '''Ubuntu 24.04 LTS''' и установленным Docker — [[Установка и настройка Docker]]. В той же статье разобраны основы Docker Compose: что такое файл <code>compose.yaml</code> и команды для работы с ним.
* VDS с '''Ubuntu 24.04 LTS''' и установленным Docker — [[Установка и настройка Docker]]. В той же статье разобраны основы Docker Compose: что такое файл <code>compose.yaml</code> и команды для работы с ним.
* Сам Portainer занимает около 100 МБ памяти. Память и диск нужны контейнерам, которыми вы будете управлять: считайте по ним и берите [https://ark-hoster.ru/vpsgame/ тариф VDS] с запасом.
* Сам Portainer занимает совсем немного — при проверке около 20 МБ памяти. Память и диск нужны контейнерам, которыми вы будете управлять: считайте по ним и берите [https://ark-hoster.ru/vpsgame/ тариф VDS] с запасом.


Интерфейс Portainer — на английском языке, русского перевода у него нет; в статье названия разделов и кнопок приведены как на экране.
Интерфейс Portainer — на английском языке, русского перевода у него нет; в статье названия разделов и кнопок приведены как на экране.

Текущая версия от 10:45, 17 ноября 2026

Portainer — панель управления Docker в браузере. Всё, что обычно делают командами, — запуск и остановка контейнеров, просмотр журналов, обновление, наборы контейнеров Docker Compose — в ней делается мышью, а состояние всех контейнеров видно на одной странице. Бесплатной версии Community Edition хватает для одного сервера и для нескольких. В статье — установка Portainer на VDS с Ubuntu 24.04, первый вход и развёртывание набора контейнеров из файла Compose. Всё проверено 17 ноября 2026 года на Ubuntu 24.04.4 с Portainer 2.45.3 LTS; снимки экрана сняты с настоящего сервера.

Что понадобится

  • VDS с Ubuntu 24.04 LTS и установленным Docker — Установка и настройка Docker. В той же статье разобраны основы Docker Compose: что такое файл compose.yaml и команды для работы с ним.
  • Сам Portainer занимает совсем немного — при проверке около 20 МБ памяти. Память и диск нужны контейнерам, которыми вы будете управлять: считайте по ним и берите тариф VDS с запасом.

Интерфейс Portainer — на английском языке, русского перевода у него нет; в статье названия разделов и кнопок приведены как на экране.

1. Установка

Portainer сам работает в контейнере. Создайте для него каталог и файл Compose:

sudo mkdir -p /opt/portainer && cd /opt/portainer
sudo nano compose.yaml
services:
  portainer:
    image: portainer/portainer-ce:lts
    container_name: portainer
    restart: unless-stopped
    ports:
      - "9443:9443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/data
sudo docker compose up -d
sudo docker ps --format "table {{.Names}}\t{{.Image}}\t{{.Status}}"

Строка Что означает
image: portainer/portainer-ce:lts Бесплатная версия, ветка с долгой поддержкой
"9443:9443" Порт панели. Панель работает по HTTPS
/var/run/docker.sock:/var/run/docker.sock Доступ Portainer к Docker этого сервера. Через него панель и управляет контейнерами
./data:/data Настройки и учётные записи Portainer — в каталоге /opt/portainer/data

На снимке, кроме Portainer, видны два контейнера примера из шага 3.

Откройте порт панели — только для своего адреса (свой адрес можно узнать на сайте 2ip.ru):

sudo ufw allow OpenSSH
sudo ufw allow from ВАШ_IP to any port 9443 proto tcp
sudo ufw enable

Это важно: тот, кто попал в Portainer, получает полную власть над сервером — доступ к Docker равносилен правам root. Не открывайте порт 9443 всем.

2. Первый вход

Откройте в браузере https://203.0.113.10:9443, подставив адрес своего VDS. Браузер предупредит о сертификате — он самоподписанный; согласитесь продолжить.

Portainer попросит создать администратора и ввести токен первой настройки (Setup token). Это защита: пока администратор не создан, панель видна всем, кто знает адрес, а токен есть только у того, кто имеет доступ к серверу. Токен записан в журнале контейнера:

sudo docker logs portainer 2>&1 | grep -A 2 "setup_token"

Скопируйте значение после знака равенства (на снимке оно скрыто) в поле «Setup token», придумайте имя и пароль не короче 12 знаков и нажмите «Create user»:

Не откладывайте этот шаг: если администратор не создан в первые минуты после запуска, Portainer из соображений безопасности перестаёт принимать настройку — тогда перезапустите контейнер командой sudo docker compose restart и возьмите новый токен.

После входа выберите подключение к локальному Docker («Get Started» на странице мастера). На главной странице появится окружение local — это Docker вашего VDS:

Нажмите на него — откроется обзор: сколько на сервере контейнеров, образов, томов и сетей.

3. Набор контейнеров из файла Compose

Набор контейнеров, описанный одним файлом Compose, в Portainer называется стек (Stack). Откройте «Stacks» → «Add stack»:

1. В поле «Name» введите имя стека — латиницей, без пробелов.

2. В редактор «Web editor» вставьте содержимое файла Compose. Пример — веб-сервер и служебная страничка на двух портах:

services:
  web:
    image: nginx:alpine
    restart: unless-stopped
    ports:
      - "8080:80"
  whoami:
    image: traefik/whoami
    restart: unless-stopped
    ports:
      - "8081:80"

3. Нажмите «Deploy the stack» внизу страницы. Portainer скачает образы и запустит контейнеры — на это уходит от нескольких секунд до нескольких минут.

Готовый стек открывается из списка «Stacks»: видны его контейнеры и их состояние, а на вкладке «Editor» файл Compose можно поправить и применить заново кнопкой «Update the stack».

Проверка с самого сервера — оба контейнера отвечают:

curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8080/
curl -s http://127.0.0.1:8081/ | head -n 3
sudo docker compose -p demo-site ps --format "table {{.Name}}\t{{.Status}}\t{{.Ports}}" | cut -c1-100

Так же, одним файлом, разворачиваются готовые программы: в их документации обычно есть раздел «Docker Compose» с готовым текстом — его и вставляют в редактор. Пример из этой базы знаний — Мониторинг игровых серверов и сайтов в Uptime Kuma.

Помните про файрвол: порты, которые контейнер публикует наружу (8080:80), Docker открывает в обход правил ufw. Если служба должна быть доступна только с самого сервера, пишите "127.0.0.1:8080:80". Подробности — в разделе «Docker обходит файрвол» статьи Установка и настройка Docker.

4. Повседневная работа

Раздел «Containers» — список всех контейнеров сервера:

Что нужно Где
Запустить, остановить, перезапустить Отметьте контейнер и нажмите Start, Stop или Restart над списком
Посмотреть журнал Первый значок в столбце «Quick Actions» (лист бумаги)
Сведения о контейнере: переменные, тома, сеть Второй значок (i)
Нагрузка: процессор, память, сеть Третий значок (график)
Командная строка внутри контейнера Четвёртый значок (>_), затем «Connect»
Обновить контейнер до свежего образа Откройте контейнер → «Recreate» с отметкой «Re-pull image»; для стека — «Update the stack» с такой же отметкой
Удалить неиспользуемые образы «Images» → отметить образы с пометкой «Unused» → «Remove»

Контейнеры, запущенные вне Portainer — командой docker run или docker compose из терминала, — в списке тоже видны и управляются так же. Но стек, созданный в терминале, Portainer показывает с пометкой «Limited»: его файл Compose лежит не у Portainer, поэтому редактировать его из панели нельзя.

5. Резервная копия и обновление

Настройки Portainer, учётные записи и файлы стеков лежат в каталоге /opt/portainer/data. Копия снимается при остановленном контейнере:

cd /opt/portainer
sudo docker compose stop
sudo tar -czf /root/portainer-backup-$(date +%F).tar.gz -C /opt/portainer data compose.yaml
sudo docker compose start
ls -lh /root/portainer-backup-*.tar.gz

Обновление самого Portainer — две команды:

sudo docker compose pull
sudo docker compose up -d

Остановка Portainer не затрагивает остальные контейнеры: они продолжают работать, пока панель выключена. Данные самих контейнеров (тома) в эту копию не входят — их сохраняют отдельно: Настройка автоматических резервных копий.

Что не проверено

Проверены: установка, получение токена и создание администратора, подключение локального Docker, развёртывание стека из двух контейнеров, страницы панели, резервная копия и команды обновления. Стек при проверке создавался не через редактор в браузере, а тем же действием через программный интерфейс Portainer; кнопки из таблицы «Повседневная работа» названы по интерфейсу, но по одной не нажимались. Не проверены: восстановление из копии и подключение к Portainer второго сервера.

Если что-то пошло не так

Что видите Причина и решение
Страница не открывается Адрес должен начинаться с https://; порт 9443 должен быть разрешён для вашего адреса; контейнер должен работать: sudo docker ps
Нет поля для создания администратора, сообщение о тайм-ауте Настройка не была сделана вовремя. sudo docker compose restart в каталоге /opt/portainer, затем заново возьмите токен из журнала
Токен не подходит Взят токен от прошлого запуска. После каждого перезапуска до создания администратора токен новый — берите последний в журнале
Стек не разворачивается, ошибка «port is already allocated» Порт слева от двоеточия уже занят другим контейнером или программой. Поменяйте его: "8082:80"
Ошибка в файле Compose при развёртывании Формат YAML строг к отступам: только пробелы, по два на уровень, без табуляции
Забыт пароль администратора Остановите Portainer и воспользуйтесь официальным средством сброса пароля — образ portainer/helper-reset-password; порядок описан в документации Portainer

Для размещения ваших проектов рекомендуем услуги ARK-HOSTER.RU: