Перейти к содержимому

Статья 64 из 141

Гайды

Portainer CE на VPS: установка в Docker, первый администратор и управление контейнерами через веб

Portainer CE — веб-панель для Docker. В ней видно все контейнеры, образы, тома и сети сервера. Можно смотреть логи, открыть консоль контейнера, перезапустить сервис и развернуть стек из файла Compose прямо в браузере. Подойдёт тем, кто держит на VPS несколько приложений в Docker и не хочет каждый раз заходить по SSH.

Статья проверена на Portainer CE 2.45.3 LTS (ноябрь 2026).

Ресурс Минимум
RAM 512 МБ свободной памяти (сам Portainer занимает 50–100 МБ)
vCPU 1
Диск 1 ГБ под образ и данные
ПО Docker и Docker Compose

Для доступа по домену нужен поддомен, например portainer.example.com, с A-записью на IP сервера (DNS).

Окно терминала
mkdir -p /opt/portainer && cd /opt/portainer
nano docker-compose.yml
services:
portainer:
image: portainer/portainer-ce:lts
container_name: portainer
restart: always
ports:
- "127.0.0.1:9443:9443"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- portainer_data:/data
volumes:
portainer_data:
Окно терминала
docker compose up -d

Тег lts даёт ветку с долгой поддержкой. Порт 9443 отдаёт интерфейс по HTTPS с самоподписанным сертификатом. Порт 8000 из официального примера нужен только для Edge-агентов на удалённых машинах, для одного сервера его можно не публиковать.

Мы привязали порт к 127.0.0.1, поэтому из интернета панель пока не видна. Открыть её можно через SSH-туннель или через Nginx (ниже).

Через туннель с вашего компьютера:

Окно терминала
ssh -L 9443:127.0.0.1:9443 root@IP_СЕРВЕРА

После этого откройте в браузере https://localhost:9443 и примите предупреждение о самоподписанном сертификате.

У новой установки есть два ограничения:

  1. Токен настройки. Начиная с версий 2.43 и 2.39.4 форма создания администратора требует токен из логов контейнера. Так посторонний не перехватит свежую панель.
  2. Пять минут. Если за 5 минут после запуска администратор не создан, Portainer перестаёт принимать запросы. Тогда перезапустите контейнер: docker compose restart.

Найдите токен:

Окно терминала
docker logs portainer 2>&1 | grep setup_token

В логе будет строка вида setup_token=a0bb... и подсказка «Paste it into the setup screen».

На экране New Portainer installation введите имя пользователя (по умолчанию admin), пароль не короче 12 символов, повторите его, вставьте токен в поле Setup token и нажмите Create user.

Форма создания первого администратора Portainer с полем Setup token

Дальше Portainer предложит включить Edge Compute. Для одного сервера нажмите Skip. На экране Environment Wizard выберите Get Started: панель подключится к локальному Docker через /var/run/docker.sock, окружение будет называться local.

На главной странице (Home) нажмите на окружение local. Откроется Dashboard со счётчиками стеков, контейнеров, образов, томов и сетей.

Dashboard окружения local в Portainer

Основные разделы в левом меню:

Раздел Что там делать
Containers список контейнеров, запуск, остановка, перезапуск, удаление
Stacks стеки Docker Compose, в том числе созданные из Portainer
Images образы, загрузка новых, удаление неиспользуемых
Volumes тома с данными
Networks сети Docker
Events журнал событий Docker

В строке контейнера есть колонка Quick Actions с иконками: логи (Logs), подробности (Inspect), статистика (Stats), консоль (Console) и подключение (Attach). В логах можно включить автообновление и фильтр по тексту. Консоль открывает sh или bash внутри контейнера.

Стеки, которые вы запускали через docker compose в консоли сервера, Portainer тоже покажет, но с пометкой о том, что ими управляют извне. Редактировать их файл через панель нельзя.

  1. Откройте Stacks и нажмите Add stack.
  2. Введите имя в поле Name: только строчные латинские буквы, цифры, - и _.
  3. В Build method оставьте Web editor и вставьте содержимое docker-compose.yml. Для проверки подойдёт тестовый сервис:
services:
whoami:
image: traefik/whoami
restart: unless-stopped
ports:
- "127.0.0.1:8085:80"

Создание стека в Portainer через Web editor

  1. Внизу страницы нажмите Deploy the stack.

Через несколько секунд откроется Stack details со списком контейнеров стека и их состоянием.

Стек развёрнут: контейнер в состоянии running

Здесь же есть кнопки Stop this stack и Delete this stack, а на вкладке Editor можно поменять файл и нажать Update the stack. Файлы таких стеков Portainer хранит у себя в томе, в каталоге /data/compose/<номер>/.

Помимо веб-редактора стек можно загрузить файлом (Upload) или взять из Git-репозитория (Repository).

Не открывайте порт 9443 в интернет напрямую: панель с доступом к docker.sock даёт полный контроль над сервером. Поставьте перед ней Nginx с сертификатом Let’s Encrypt.

Конфиг /etc/nginx/sites-available/portainer:

server {
listen 80;
server_name portainer.example.com;
location / {
proxy_pass https://127.0.0.1:9443;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Окно терминала
ln -s /etc/nginx/sites-available/portainer /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d portainer.example.com

Заголовки Upgrade и Connection нужны для консоли контейнера: она работает через WebSocket. Подробнее: Nginx, Let’s Encrypt.

  • Порт 9443 держите на 127.0.0.1. В файрволе оставьте открытыми только 22, 80 и 443.
  • Используйте длинный пароль администратора. Для дополнительной защиты можно ограничить доступ к домену по IP директивами allow и deny в Nginx.
  • Создавайте отдельных пользователей в Administration → User-related → Users вместо общего аккаунта admin.
  • Помните, что доступ к Portainer равен доступу root к серверу.

Если пароль администратора утерян, остановите Portainer и сбросьте его официальной утилитой. Она выведет новый пароль:

Окно терминала
docker compose stop
docker run --rm -v portainer_portainer_data:/data portainer/helper-reset-password
docker compose start

Имя тома смотрите в docker volume ls: Compose добавляет к нему имя проекта, здесь это portainer_portainer_data.

Окно терминала
cd /opt/portainer
docker compose pull
docker compose up -d

Перед обновлением сделайте бэкап тома. Portainer хранит в нём базу и при новой версии может её мигрировать.

Все настройки, пользователи и файлы стеков лежат в томе portainer_data. Копия с короткой остановкой:

Окно терминала
cd /opt/portainer
docker compose stop
docker run --rm -v portainer_portainer_data:/data -v /root:/backup alpine \
tar czf /backup/portainer-$(date +%F).tar.gz -C /data .
docker compose start

Сами контейнеры и их данные в этот архив не входят. Их тома нужно копировать отдельно. Храните копии за пределами сервера: бэкапы.

Симптом Причина и решение
Вместо формы администратора ошибка или пустая страница Прошло больше 5 минут после запуска. Выполните docker compose restart и создайте пользователя сразу
Форма не принимает данные, ошибка про токен Токен не указан или устарел. После перезапуска контейнера возьмите новый из docker logs portainer
Кнопка Create user неактивна Пароль короче 12 символов или не совпадает с подтверждением
Консоль контейнера не подключается через домен В Nginx нет заголовков Upgrade и Connection
Браузер ругается на сертификат на порту 9443 Это самоподписанный сертификат Portainer. Используйте домен с Let’s Encrypt через Nginx
Стек не создаётся, ошибка про имя В имени есть заглавные буквы или пробелы

Похожие инструменты: Dockge для работы только со стеками Compose и Nginx Proxy Manager для настройки прокси через веб.