Docker очень мощен в командной строке, но каждый день набирать docker ps, docker logs и длинные compose-команды удобно не всем. Особенно если в команде есть сотрудники, мало работавшие с Linux: им приходится ждать администратора даже ради перезапуска контейнера или просмотра логов. Portainer решает эту проблему: он показывает Docker в понятном веб-интерфейсе и позволяет им управлять.
Что умеет Portainer
Portainer — это веб-приложение, которое само работает как контейнер. Оно подключается к демону Docker и показывает список всех контейнеров, образов, томов (volume) и сетей на сервере. Состояние каждого контейнера, потребление памяти и процессора, открытые порты видны на одной странице. Одной кнопкой можно остановить или перезапустить контейнер, прочитать его логи или войти внутрь через консоль.
Одна из самых полезных возможностей — раздел стеков. Вы вставляете туда файл Docker Compose, запускаете весь проект разом и затем редактируете его там же. Кроме того, в Portainer есть готовые шаблоны, пользователи и команды, а также возможность управлять несколькими Docker-серверами из одного окна. Бесплатной Community Edition (CE) достаточно для небольших и средних проектов, а расширенные права доступа и корпоративные функции есть в платной Business Edition.
Установка на VPS
Для установки Portainer на сервере уже должен работать Docker. Способ из официальной документации сводится к созданию одного тома и одного контейнера. В примере ниже интерфейс управления привязан только к локальному адресу сервера — это важно для безопасности, причину объясним дальше.
docker volume create portainer_data
docker run -d --name portainer --restart=always -p 127.0.0.1:9443:9443 -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:lts
После запуска учётную запись администратора нужно создать в течение нескольких минут. Если это время истечёт, Portainer из соображений безопасности закроет страницу настройки, и контейнер придётся перезапустить:
docker restart portainer
Безопасный доступ к интерфейсу
Portainer подключается к файлу /var/run/docker.sock. Доступ к этому сокету фактически равен правам root на сервере: тот, у кого он есть, может запустить любой контейнер с полным доступом к файловой системе сервера. Поэтому оставлять интерфейс Portainer открытым в интернет, тем более с простым паролем, — серьёзный риск.
Самый простой и надёжный способ — заходить через SSH-туннель. Порт на сервере привязан только к 127.0.0.1, а вы открываете туннель со своего компьютера и заходите в браузере на локальный адрес:
# на своём компьютере
ssh -L 9443:localhost:9443 admin@server.example.uz
# затем в браузере
https://localhost:9443
По умолчанию Portainer использует самоподписанный сертификат, поэтому браузер покажет предупреждение; при работе через туннель это допустимо. Если команде нужен постоянный веб-адрес, разместите Portainer за reverse proxy вроде Caddy или Nginx, например на домене portainer.example.uz с сертификатом Let's Encrypt, задайте надёжный пароль и по возможности ограничьте доступ по IP.
Повседневная работа в интерфейсе
Открыв Portainer, вы выбираете окружение «local» и видите основные разделы. В повседневной работе чаще всего нужны:
- Containers — состояние контейнеров, перезапуск, логи и консоль.
- Stacks — размещение, редактирование и обновление compose-файлов.
- Images — очистка старых неиспользуемых образов для освобождения диска.
- Volumes — какой том к какому контейнеру подключён.
При создании стека вы пишете обычный compose-текст. Например, для небольшого внутреннего инструмента:
services:
app:
image: nginx:stable
restart: unless-stopped
ports:
- "127.0.0.1:8080:80"
volumes:
- ./html:/usr/share/nginx/html:ro
Пример из практики: сервер учебного центра
Учебный центр в Намангане держит на одном VPS свой сайт, систему онлайн-тестирования и Telegram-бота в контейнерах Docker. Систему настроил сторонний разработчик, а сотрудник центра в Linux разбирается слабо. Раньше, если бот останавливался, сотрудник звонил разработчику и ждал его. После установки Portainer сотруднику выдали права только на просмотр и перезапуск нужных контейнеров. Теперь он открывает логи бота в браузере и пересылает текст ошибки разработчику или решает проблему простым перезапуском. А разработчик хранит compose-файлы в виде стеков и управляет обновлениями из одного места.
Ограничения и меры предосторожности
Portainer — удобная надстройка над Docker, но не система резервного копирования. Удалить в интерфейсе контейнер так же легко, как случайно удалить том, поэтому копии баз данных и загруженных файлов делайте отдельно. Собственные данные Portainer хранятся в томе portainer_data — включите его в резервное копирование.
Регулярно обновляйте Portainer, как и другие образы. Для обновления достаточно удалить контейнер и создать его заново с новым образом, настройки сохранятся в томе:
docker pull portainer/portainer-ce:lts
docker stop portainer && docker rm portainer
docker run -d --name portainer --restart=always -p 127.0.0.1:9443:9443 -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:lts
Если ваш проект работает на VPS в sayt.uz, Portainer заметно упростит управление, но решение о том, кому давать доступ к серверу, принимайте обдуманно. Правильно настроенный Portainer даёт каждому в команде права по его задачам, экономит время администратора и помогает быстрее устранять мелкие неполадки.