Установка Portainer CE и защита доступа к нему
Установите Portainer Community Edition с помощью Docker Compose на Debian или Ubuntu: доступ через SSH-туннель или ограниченный HTTPS, риски сокета Docker, обновления и резервное копирование.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Portainer Community Edition (CE) — это веб-интерфейс для управления контейнерами, образами, томами, сетями и стеками сервера Docker. Это руководство объясняет, как установить его с помощью Docker Compose, не открывая интерфейс в Интернет.
К концу руководства Portainer будет слушать только локальный адрес сервера. Вы будете подключаться к нему через SSH-туннель или, при желании, по HTTPS только со своего IP-адреса. Вы также научитесь оценивать риск, связанный с сокетом Docker, обновлять Portainer и создавать резервные копии его данных.
Заказать сервер
Это руководство подходит для серверов, которыми вы управляете самостоятельно:
Предварительные требования
- Сервер под управлением Debian 12 или 13 либо Ubuntu 22.04 или 24.04
- Доступ по SSH под пользователем с правами
sudo - Docker Engine и Docker Compose, установленные из официального репозитория, как описано в руководстве Установка Docker Engine и Docker Compose. Не используйте snap-пакет Docker
- SSH-клиент на вашем компьютере
Команды docker предполагают, что ваш пользователь входит в группу docker. В противном случае добавляйте перед ними sudo.
В этом руководстве используется версия 2.45.3 — самая свежая LTS-версия на момент написания. Актуальную версию проверяйте на странице выпусков Portainer и в списке поддерживаемых версий Docker.
Используемые порты
| Порт | Назначение | Публикация в этом руководстве | Нужно ли открывать в брандмауэре |
|---|---|---|---|
| 22/tcp | SSH и туннель к Portainer | Служба SSH сервера | Да, если он ещё не открыт |
| 9443/tcp | HTTPS-интерфейс Portainer | Только 127.0.0.1 |
Нет |
| 9000/tcp | HTTP-интерфейс для локального обратного прокси | 127.0.0.1, только в варианте с Caddy |
Нет |
| 8000/tcp | Туннель для Edge Agents | Не публикуется | Нет |
| 80 и 443/tcp | Caddy | Только в варианте с Caddy | Только в варианте с Caddy |
Чем опасен сокет Docker
Portainer управляет Docker через сокет /var/run/docker.sock, смонтированный в его контейнер. Этот сокет даёт доступ ко всему API Docker, а демон Docker работает от имени root.
Учётная запись, управляющая Docker, может, например, запустить привилегированный контейнер или смонтировать в контейнер корень / сервера, а затем читать и изменять любые файлы. Документация Docker напоминает, что управлять демоном должны только доверенные пользователи.
Практические выводы:
- Монтирование сокета с
:roвас не защищает: оно относится к самому файлу, а не к действиям, отправляемым в API Docker - Оставляйте роль администратора только тем, кто и так мог бы быть
rootна сервере - Своевременно устанавливайте обновления Portainer
- Отдавайте предпочтение SSH-туннелю: он позволяет не открывать интерфейс
Шаг 1: создайте проект Compose
Создайте каталог для Portainer:
sudo mkdir -p /opt/portainer
sudo chown "$USER": /opt/portainer
cd /opt/portainer
nano compose.yamlВставьте эту конфигурацию:
services:
portainer:
image: portainer/portainer-ce:2.45.3
container_name: portainer
restart: unless-stopped
ports:
- "127.0.0.1:9443:9443"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- portainer_data:/data
volumes:
portainer_data:
name: portainer_dataПорт 8000 не публикуется, так как он нужен только для Edge Agents. Проверьте файл и загрузите образ:
docker compose config --quiet
docker compose pullШаг 2: откройте SSH-туннель
После запуска Portainer даёт 5 минут на создание первого администратора. Поэтому подготовьте туннель до запуска контейнера.
В терминале на вашем компьютере выполните:
ssh -N -L 9443:127.0.0.1:9443 ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРАКоманда ничего не выводит и остаётся активной: это нормально. Не закрывайте этот терминал, пока работаете с Portainer, а затем завершите туннель сочетанием Ctrl+C. Если порт 9443 на вашем компьютере уже занят, используйте, например, -L 19443:127.0.0.1:9443 и адрес https://localhost:19443.
Шаг 3: запустите Portainer
На сервере запустите контейнер и получите токен установки:
cd /opt/portainer
docker compose up -d
docker compose ps
docker logs portainer 2>&1 | grep setup_token | tail -n 1Последняя команда выводит строку setup_token=.... Этот одноразовый токен, обязательный начиная с версий 2.39.4 и 2.43, не позволяет постороннему завладеть новым экземпляром. Он создаётся заново при каждом запуске, пока не существует ни одного администратора.
Шаг 4: создайте учётную запись администратора
- Откройте
https://localhost:9443в браузере. - Примите предупреждение о безопасности: по умолчанию Portainer использует самоподписанный сертификат. Трафик проходит через SSH-туннель.
- Выберите имя пользователя и уникальный пароль длиной не менее 12 символов.
- Вставьте значение токена в поле Setup token и подтвердите.
- На экране Edge Compute выберите Skip, если вы не управляете Edge Agents.
- В мастере нажмите Get Started: локальное окружение определяется автоматически.
Сохраните этот пароль в менеджере паролей.
Проверка результата
В Portainer откройте окружение local: контейнер portainer должен присутствовать в списке Containers.
Затем на сервере проверьте адрес прослушивания:
docker ps --filter name=portainer --format '{{.Names}} {{.Ports}}'
curl -kI https://127.0.0.1:9443Вывод должен содержать 127.0.0.1:9443->9443/tcp, а curl должен вернуть HTTP-ответ. Наконец, с другого компьютера, без туннеля, убедитесь, что ничего не доступно:
nmap -Pn -p 8000,9000,9443 IP_ВАШЕГО_СЕРВЕРАНи один из этих портов не должен отображаться как open.
Ограничение прав в Portainer
Несколько настроек снижают риски, если интерфейсом пользуются несколько человек:
| Настройка | Расположение | Рекомендация |
|---|---|---|
| Индивидуальные учётные записи | User-related > Users | Отдельная учётная запись для каждого человека, без роли администратора, если она не нужна |
| Длительность сеанса | Settings > Authentication | При необходимости уменьшите значение по умолчанию (8 часов) |
| Ограничения Docker | Окружение local > Host > Setup > Docker Security Settings |
В частности, включите Hide bind mounts for non-administrators и Hide privileged mode for non-administrators |
Эти ограничения касаются только учётных записей без прав администратора. Они не ограничивают возможности администратора.
Вариант: публикация Portainer по HTTPS через Caddy
В большинстве случаев достаточно SSH-туннеля. Если вам нужен веб-адрес, разместите Portainer за обратным прокси и ограничьте доступ своим IP-адресом.
Для этого нужно выполнить руководство Caddy как обратный прокси с автоматическим HTTPS и создать запись A для portainer.ваш-домен.com, указывающую на IP_ВАШЕГО_СЕРВЕРА.
Добавьте локальный HTTP-порт в /opt/portainer/compose.yaml:
ports:
- "127.0.0.1:9443:9443"
- "127.0.0.1:9000:9000"Примените изменение:
cd /opt/portainer
docker compose up -dЗатем добавьте этот сайт в /etc/caddy/Caddyfile:
portainer.ваш-домен.com {
@allowed client_ip ВАШ_IP
handle @allowed {
reverse_proxy 127.0.0.1:9000
}
handle {
abort
}
}Поскольку Caddy установлен на сервере, а не в Docker, на его порты распространяются правила UFW. Откройте их и перезагрузите конфигурацию:
sudo ufw allow 80,443/tcp comment 'Caddy'
sudo -u caddy caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
sudo systemctl reload caddyОткройте https://portainer.ваш-домен.com с разрешённого адреса: должна появиться страница входа. С другого подключения, например с телефона через мобильный интернет, соединение должно обрываться.
Если ваш IP-адрес часто меняется, лучше ограничьте доступ частной сетью с помощью WireGuard или Tailscale.
Обновление Portainer
Сначала создайте резервную копию Portainer, затем прочитайте примечания к выпуску. Замените тег образа в compose.yaml на новую версию и выполните:
cd /opt/portainer
nano compose.yaml
docker compose pull
docker compose up -d
docker compose imagesДругие ваши контейнеры не останавливаются. Затем войдите снова и убедитесь, что окружение local отвечает. Данные остаются в томе portainer_data.
Существует также плавающий тег lts, но конкретная версия позволяет самостоятельно выбирать момент обновления и точно знать, что у вас запущено.
Резервное копирование и восстановление
Резервная копия Portainer содержит его базу данных и файлы стеков, развёрнутых из Portainer. В ней нет ни ваших контейнеров, ни образов, ни данных их томов: сохраняйте их отдельно, как описано в руководстве Docker.
Из интерфейса
- Откройте Settings и прокрутите страницу до раздела Back up Portainer.
- Включите Password protect и введите пароль.
- Нажмите Download backup.
В редакции CE такое резервное копирование запускается вручную. Копирование по расписанию и отправка в S3 доступны только в редакции Business.
С сервера
Этот способ можно запускать по расписанию. Он ненадолго останавливает Portainer, не затрагивая другие ваши контейнеры:
cd /opt/portainer
mkdir -p backups
docker compose stop portainer
docker run --rm -v portainer_data:/data:ro -v "$PWD/backups":/backup alpine:3 tar czf "/backup/portainer-$(date +%F).tar.gz" -C /data .
docker compose start portainer
sudo chmod 600 backups/*.tar.gzАрхив содержит учётные данные и ключи API. Скопируйте его вместе с compose.yaml за пределы сервера в зашифрованное хранилище.
Восстановление архива на сервере
Замените ГГГГ-ММ-ДД датой архива. Текущее содержимое тома будет удалено:
cd /opt/portainer
docker compose down
docker run --rm -v portainer_data:/data -v "$PWD/backups":/backup:ro alpine:3 sh -c 'find /data -mindepth 1 -delete && tar xzf /backup/portainer-ГГГГ-ММ-ДД.tar.gz -C /data'
docker compose up -dИспользуйте ту же версию Portainer, что и при создании резервной копии, или более новую.
Восстановление из загруженного файла
Такое восстановление возможно только на новом экземпляре с пустым томом. На экране инициализации откройте Restore Portainer from backup, выберите файл, введите его пароль и токен setup_token, затем нажмите Restore Portainer.
Если что-то пошло не так
the Portainer instance timed out for security purposes
Первый администратор не был создан в течение 5 минут. Перезапустите контейнер и получите новый токен:
cd /opt/portainer
docker compose restart portainer
docker logs portainer 2>&1 | grep setup_token | tail -n 1Если это сообщение появляется на уже настроенном экземпляре, убедитесь, что том portainer_data действительно смонтирован: без своих данных Portainer ведёт себя как новая установка.
Токен установки отклоняется
Токен меняется при каждом запуске. Используйте последнее значение, выведенное предыдущей командой, и копируйте его без пробелов.
open failed: connect failed: Connection refused
Это сообщение появляется в терминале туннеля. Туннель работает, но на нужном порту сервера ничего не слушает. Проверьте состояние контейнера командой docker compose ps и его журналы командой docker compose logs --tail=50 portainer.
bind [127.0.0.1]:9443: Address already in use
Порт уже занят на вашем компьютере, часто старым туннелем. Закройте его или выберите другой локальный порт, как на шаге 2.
Client sent an HTTP request to an HTTPS server
Вы используете http:// на порту 9443. Откройте https://localhost:9443.
Порт 9443 отвечает из Интернета
Вероятно, порт был опубликован без локального адреса. Проверьте вывод docker ps: если в нём есть 0.0.0.0:9443, исправьте compose.yaml и снова выполните docker compose up -d.
403 Forbidden и CSRF check failed за обратным прокси
Вероятно, прокси изменяет имя хоста, которое получает Portainer. С блоком Caddy из этого руководства исходное имя сохраняется. Если перед ним стоит другой прокси, укажите публичный адрес в виде полного URL:
command: --trusted-origins https://portainer.ваш-домен.comИмя без https:// вызывает ошибку invalid url for trusted origin при запуске.
Ошибка 502 при работе с Caddy
Caddy не может подключиться к порту 9000. Проверьте с помощью docker ps, что он опубликован, затем выполните curl -I http://127.0.0.1:9000. Если включён Force HTTPS only, отключите его через SSH-туннель.
Утерян пароль администратора
Его может сбросить другой администратор. В противном случае используйте официальный инструмент, который выведет новый пароль:
cd /opt/portainer
docker compose stop portainer
docker pull portainer/helper-reset-password
docker run --rm -v portainer_data:/data portainer/helper-reset-password
docker compose start portainer