70 lines
2.1 KiB
Markdown
70 lines
2.1 KiB
Markdown
---
|
|
title: "Portainer: развертывание и решение ошибок подключения к Docker"
|
|
date: 2025-11-22T19:00:00+03:00
|
|
draft: false
|
|
tags: ["portainer", "docker", "selfhosting"]
|
|
categories: ["selfhosting"]
|
|
cover:
|
|
image: "hero.svg"
|
|
---
|
|
|
|
Поделюсь опытом настройки Portainer — удобного веб-интерфейса для управления Docker. Столкнулся с типичными ошибками и нашел рабочие решения.
|
|
|
|
## Типичные проблемы при запуске
|
|
|
|
```shell
|
|
“The environment named Docker is unreachable”
|
|
|
|
“client version 1.42 is too old. Minimum supported API version is 1.44”
|
|
```
|
|
|
|
## Решения ошибки
|
|
|
|
### Проверяем права доступа к Docker socket
|
|
|
|
```shell
|
|
ls -l /var/run/docker.sock
|
|
# Если не хватает прав:
|
|
sudo chmod 666 /var/run/docker.sock
|
|
# ИЛИ добавляем пользователя в группу docker
|
|
sudo usermod -aG docker $USER
|
|
# Перезагружаем сессию
|
|
newgrp docker
|
|
```
|
|
|
|
### Основная проблема
|
|
|
|
Основная проблема — несовместимость новых версий Docker Engine 29+ с некоторыми версиями Portainer.
|
|
|
|
Рабочий docker-compose.yml:
|
|
|
|
```shell
|
|
services:
|
|
portainer:
|
|
image: portainer/portainer-ce:2.20.2 # Проверенная версия
|
|
container_name: portainer
|
|
restart: unless-stopped
|
|
volumes:
|
|
- /var/run/docker.sock:/var/run/docker.sock:ro
|
|
- ./portainer-data:/data
|
|
ports:
|
|
- "9080:9080"
|
|
- "9443:9443"
|
|
```
|
|
|
|
## Важные моменты
|
|
|
|
Версия 2.20.2 стабильно работает с Docker 29+
|
|
Логи можно посмотреть: ```shell docker logs portainer```
|
|
|
|
Проверка работоспособности:
|
|
|
|
```shell
|
|
docker ps
|
|
docker logs portainer
|
|
```
|
|
|
|
В браузере: <https://сервер:9443>
|
|
|
|
Мне пришлось поменять версию чтобы Portainer заработал.
|