Установка Portainer для управления Docker на Ubuntu 24.04
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:
- VPS/VDS серверы — для небольших и средних проектов
- Выделенные серверы — для высоконагруженных проектов