Установка и настройка Portainer

Установка Portainer
Веб-интерфейс Portainer
Создание пользовательских контейнеров
Подключение внешних реестров образов
Portainer Agent
Стеки в Portainer
Шаблоны в Portainer

Окружение

• Версия ОС: 8
• Конфигурация ОС: Рабочая станция, Сервер графический
• Редакция ОС: Стандартная
• Версия ПО: portainer-ce-2.33.6-1, portainer-ce-agent-2.33.6-1, docker-ce-4:28.1.1-3, docker-ce-cli-4:28.1.1-3

Portainer — веб-интерфейс для управления контейнерами Docker и Kubernetes. Управление контейнерами и сервисами производится напрямую через браузер (без использования командной строки).

К основным возможностям Portainer относятся:

• создание, запуск, остановка, перезапуск и удаление контейнеров;

• просмотр журналов событий, метрик производительности и состояния контейнеров;

• подключение и управление публичными (например, Docker Hub) и приватными реестрами для хранения и развертывания образов;

• управление стеками Docker Compose, а также поддержка Docker Swarm и Kubernetes для оркестрации контейнеров;

• подключение к нескольким серверам или кластерам через Portainer Agent, что позволяет контролировать всю инфраструктуру из одного интерфейса.

Установка Portainer

Для установки portainer из репозитория РЕД ОС выполните команду (потребуются права администратора):

sudo dnf install portainer-ce

Запустите и добавьте в автозагрузку службу portainer:

sudo systemctl enable --now portainer.service

Убедитесь, что служба активна, проверив ее статус:

sudo systemctl status portainer.service

В статусе должно отображаться active(running).

Веб-интерфейс Portainer

Получить доступ к Portainer можно через веб-интерфейс на порту 9443. Для этого в адресной строке браузера пропишите https://<IP-адрес_сервера_Portainer>:9443.

Будет открыта страница с веб-интерфейсом Portainer и формой для создания нового пользователя, под которым будет производиться вход в веб-интерфейс. Задайте имя пользователя и пароль. Пароль должен быть сложным и содержать не менее 12 символов.

sudo systemctl restart portainer.service

Нажмите «Create user».

После создания пользователя будет открыта приветственная страница.

Кнопка «Get Started» подразумевает локальную работу с Portainer — все контейнеры будут запускаться локально (на текущей машине). Информация по локальной работе с Portainer приведена в пункте «Создание пользовательских контейнеров».

Кнопка «Add Environments» подразумевает добавление новых (удаленных) окружений (агентов) для управления через единый интерфейс Portainer. Информация по работе с агентами приведена в пункте «Portainer Agent».

Создание пользовательских контейнеров

Portainer позволяет запускать контейнеры локально — на текущей машине с установленным сервером Portainer.

По нажатии кнопки «Get Started» на приветственной странице будет открыта страница с доступными окружениями Portainer – в текущем примере доступно окружение local — текущая машина, с установленным сервером Portainer.

Для отображения более подробной информации о среде Portainer нажмите на имя окружения — local. На вкладке «Dashboard» доступна общая информация об окружении, такая как количество docker-образов, контейнеров, сетей, томов данных и пр. 

Для создания собственного контейнера перейдите во вкладку «Containers» и нажмите «Add container».

Будет открыта форма создания контейнера, в которой необходимо указать имя контейнера и docker-образ, из которого контейнер будет развернут, настроить сеть и доступ. Для создания контейнера нажмите «Deploy the container».

В качестве примера будет развернут веб-сервер nginx.

При успешном создании контейнера будет выведено соответствующее информационное сообщение, а также в списке контейнеров будет отображен его статус. При успешном запуске контейнера в статусе должно отображаться running.

Для проверки корректности работы контейнера в поисковой строке браузера введите IP-адрес локальной машины и порт, который получил контейнер (в примере 32768).

Подключение внешних реестров образов

Реестр образов — это специализированное хранилище (registry) для Docker-образов, которое используется Portainer для извлечения (pull) и развертывания контейнеров.

Для добавления внешнего реестра необходимо в разделе «Administration» открыть вкладку «Registries» и нажать «Add registry».

В форме добавления реестров выберите тип реестра и укажите имя и адрес реестра. Например, для добавления реестра docker-образов РЕД СОФТ выберите:

• тип реестра – Custom registry;

• имя – registry.red-soft.ru;

• адрес – https://registry.red-soft.ru/.

Нажмите «Add registry».

При успешном добавлении реестра будет выведено соответствующее информационное сообщение, а также обновлен список доступных реестров.

Portainer Agent

Portainer Agent — легковесный сервисный компонент Portainer, который устанавливается на удаленные серверы (или узлы) для обеспечения взаимодействия с Portainer Server. Portainer Agent позволяет безопасно и эффективно управлять удаленными Docker-окружениями через основной интерфейс Portainer.

Для обеспечения централизованного управления на каждый удаленный сервер (или узел) необходимо установить пакет portainer-ce-agent.

Добавление агентов в основной интерфейс Portainer доступно в двух вариантах — Agent и Edge Agent. Основное различие заключается в способе подключения.

При использовании стандартного агента  (Agent) для подключения к серверу Portainer необходимо открыть порт на стороне агента.

При использовании Edge-агента (Edge Agent) подключение осуществляется в обратном направлении — Edge-агент инициирует соединение с сервером Portainer, поэтому открывать порты на стороне Edge-агента не требуется.

Установка Portainer Agent

Для развертывания Portainer в режиме Agent на каждый удаленный сервер (или узел) необходимо установить пакет portainer-ce-agent (потребуются права администратора):

sudo dnf install portainer-ce-agent

Затем запустить службу portainer-agent:

sudo systemctl enable  --now portainer-agent.service

После этого агент необходимо добавить в основной интерфейс Portainer.

Установка Portainer Edge Agent

Для развертывания Portainer в режиме Edge Agent на каждый удаленный сервер (или узел) необходимо:

1. Установить пакет portainer-ce-agent (потребуются права администратора):

sudo dnf install portainer-ce-agent

2. Открыть файл /var/lib/portainer-agent/agent.env и изменить значения для параметров EDGE и EDGE_INSECURE_POLL с false на true:

EDGE=true
EDGE_INSECURE_POLL=true

3. Запустить службу portainer-agent:

sudo systemctl enable --now portainer-agent.service

После этого агент необходимо добавить в основной интерфейс Portainer.

Добавление агента в режиме Agent

Для добавления агента в режиме Agent в основном интерфейсе Portainer в разделе «Administration» откройте вкладку «Environment-related» — «Environments». Нажмите «Add environment».

В открывшейся форме выберите окружение – Docker Standalone и нажмите «Start Wizard».

Укажите данные агента:

• тип агента — Agent;

• имя агента — укажите понятное имя агента (в примере agent1);

• IP-адрес агента — укажите данные для подключения агента в формате <IP-адрес_агента>:<порт> (в примере 192.168.114.145:9001). Порт по умолчанию для подключения агента — 9001.

Нажмите «Connect».

При успешном добавлении агента будет выведено соответствующее информационное сообщение.

Для просмотра списка добавленных агентов перейдите на вкладку «Environment-related» — «Environments» или на вкладку «Home».

Добавление агента в режиме Edge Agent

Для добавления агента в режиме Edge Agent в основном интерфейсе Portainer в разделе «Administration» откройте вкладку «Environment-related» — «Environments». Нажмите «Add environment».

В открывшейся форме выберите окружение – Docker Standalone и нажмите «Start Wizard».

Укажите данные агента:

• тип агента — Edge Agent Standart;

• имя агента — укажите понятное имя агента (в примере agent2);

• адрес сервера Portainer — проверьте корректность данных для подключения агента в формате https://<IP-адрес_сервера>:<порт> (в примере https://192.168.114.63:9443).

Нажмите «Create».

Будет открыта дополнительная секция «Join token», в которой будет отображен токен подключения. Скопируйте токен.

Откройте новую вкладку браузера и в адресной строке пропишите IP-адрес добавляемого Edge-агента. Будет открыта страница связки, на которой в текстовое поле нужно вставить скопированный ранее токен и нажать кнопку «Submit».

Если привязка прошла успешно, на странице будет выведено сообщение вида Agent setup OK. You can close this page.

Для просмотра списка добавленных агентов перейдите на вкладку «Environment-related» — «Environments» или на вкладку «Home».

Стеки в Portainer

Стеки в Portainer являются инструментами для управления группами взаимосвязанных контейнеров и сервисов как единым целым. Они основаны на технологии Docker Compose и позволяют развертывать сложные приложения, состоящие из нескольких контейнеров, с помощью одного файла конфигурации — docker-compose.yml.

В Portainer доступно четыре режима создания стека:

• напрямую из Portainer в редакторе;
• загрузка из файла;
• загрузка из репозитория;
• создание шаблона.

В рамках текущей инструкции в качестве примера будет развернута база данных PostgreSQL с графическим интерфейсом PgAdmin напрямую из Portainer.

Для работы со стеками выберите любое доступное окружение и перейдите на вкладку «Stacks». Будет открыт список доступных стеков (изначально список пуст). Для добавления нового стека нажмите «Add stack».

Будет открыта форма создания стека, в которой необходимо:

• задать имя стека – например, stack1;

• выбрать режим создания стека – Web editor;

• в поле редактора вставить содержимое compose-файла, описывающего стек.

services:
  postgresdb:
    image: registry.red-soft.ru/ubi8/postgresql-17 
    environment:
      - POSTGRESQL_USER=test_user 
      - POSTGRESQL_PASSWORD=test_password 
      - POSTGRESQL_DATABASE=test_db_1 
      - PGDATA=/var/lib/postgresql/data
    ports:
      - 5432:5432
    volumes:
       - ./postgresdb:/var/lib/postgresql/data
    networks:
      - postgres_stack
  
  pgadmin:
    image: registry.red-soft.ru/ubi8/pgadmin 
    environment:
      - PGADMIN_DEFAULT_EMAIL=test@mail.ru 
      - PGADMIN_DEFAULT_PASSWORD=password 
    ports:
      - 8080:80
    depends_on:
      - postgresdb
    volumes:
       - ./pgadmin:/root/.pgadmin
    networks:
      - postgres_stack

networks:
  postgres_stack:

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

После определения всех необходимых параметров нажмите «Deploy the stack». Процесс развертывания стека займет некоторое время. По завершении процесса развертывания будет отображен список доступных стеков.

Также во вкладке «Containers» будут отображены созданные контейнеры.

Для проверки корректности работы стека в поисковой строке браузера введите IP-адрес машины, на которой был запущен стек (в примере local), и порт, который получил контейнер pgadmin (в примере 8080).

Откроется форма авторизации, в которой необходимо указать данные для входа — значения параметров PGADMIN_DEFAULT_EMAIL и PGADMIN_DEFAULT_PASSWORD из compose-файла. При необходимости выберите язык интерфейса — Russian. Нажмите «Login».

После авторизации будет открыта главная страница pgAdmin. Нажмите «Add New Server» для создания нового подключения к серверу.

В форме регистрации сервера:

• на вкладке «General» — введите имя сервера — например, server1;

  




• на вкладке «Connection» — введите имя хоста и информацию о базе данных. Все введенные данные должны совпадать с соответствующими параметрами из compose-файла.

  




• нажмите кнопку «Save».

Если данные были заданы корректно, на вкладке «Servers» появится новое подключение.

Для завершения подключения к БД разверните содержимое базы данных test_db_1.

Подключение к базе данных завершилось успешно.

Шаблоны в Portainer

Шаблоны в Portainer — это предопределенные конфигурации для быстрого развертывания контейнеров, стеков или приложений. Шаблоны позволяют пользователям создавать стандартные окружения без необходимости вручную писать файлы docker-compose.yml или использовать команды docker.

Portainer позволяет создавать пользовательские шаблоны или использовать уже готовые.

В рамках текущей инструкции в качестве примера будет использован готовый шаблон WordPress.

Для работы с шаблонами выберите любое доступное окружение и перейдите на вкладку «Templates» — «Application». В поле «Category» выберите CMS. Будет выведен список доступных шаблонов. Из списка выберите WordPress.

Будет открыта форма развертывания шаблона, в которой необходимо:

• задать имя стека – например, wp_local;

• здать пароль базы данных – например, wp_password.

Нажмите «Deploy the stack».

По завершении процесса развертывания на вкладке «Containers» будет отображен список созданных контейнеров.

Когда контейнеры будут иметь статус Running, в поисковой строке браузера введите IP-адрес машины, на которой был запущен шаблон (в примере local), и порт, который получил контейнер wordpress (в примере 32770). Будет открыта панель настройки WordPress. Подробнее о первоначальной настройке WordPress см. в нашей инструкции «WordPress - инструмент управления сайтами».

Дата последнего изменения: 04.02.2026

Если вы нашли ошибку, пожалуйста, выделите текст и нажмите Ctrl+Enter.