Skip to main content

Конфликт адресов Docker при установке

Симптомы

  • После установки системы Принтум происходит разрыв соединения с сервером.
  • Подключение по SSH становится недоступным сразу после установки или при первом запуске контейнеров.

Возможные причины

Конфликт IP-адресов между внутренней сетью Docker и реальной локальной сетью. Для работы Принтум используется внутренняя сеть Docker с пулом адресов:

10.28.32.0/26

Если данный диапазон пересекается с адресным пространством инфраструктуры — необходимо выделить другой пул адресов для Docker.

Когда может возникнуть проблема

  • Во время установки системы.
  • Сразу после установки.
  • При первом запуске контейнеров.

Диагностика

Если подключение по SSH недоступно — подключитесь к серверу через консоль гипервизора (vSphere / Proxmox / Hyper-V и т.д.).

Логи и диагностические данные

Где смотреть логи

  • printum_nginx — Nginx Мониторинга — если конфликт возник при установке Мониторинга
    cd /opt/printum && docker-compose logs -f --tail=200 printum_nginx
  • printmanager_web — Nginx ПринтМенеджера — если конфликт возник при установке ПМ
    cd /opt/printmanager && docker-compose logs -f --tail=200 printmanager_web

Что искать в логах

  • Выявить ошибки запуска контейнеров после изменения пула адресов.
  • Проверить, что контейнеры успешно запустились после перенастройки сети Docker.

Что приложить к обращению в поддержку

  • Вывод команды bash /opt/printum/logs.sh (Мониторинг) или bash /opt/printmanager/logs.sh (ПринтМенеджер)
  • Версию: cat /opt/printum/.version или cat /opt/printmanager/.version
  • Описание сценария и шагов воспроизведения
  • ОС сервера

Решение

  1. Остановите контейнеры Принтум

Если установлен Мониторинг:

cd /opt/printum
docker-compose down

Если установлен ПринтМенеджер:

cd /opt/printmanager
docker-compose down
  1. Проверьте наличие файла конфигурации Docker

Проверьте, существует ли файл /etc/docker/daemon.json. Если файла нет — создайте его:

sudo nano /etc/docker/daemon.json
  1. Укажите новый пул IP-адресов Docker

Добавьте или отредактируйте содержимое файла:

{
  "default-address-pools": [
    {
      "base": "x.x.x.x/x",
      "size": 26
    }
  ]
}
  • "base" — выделенный диапазон IP-адресов, который не пересекается с локальной сетью.
  • "size": 26 — размер подсети (изменять не требуется).

Используйте только свободный диапазон, согласованный с сетевым администратором. Сохраните файл и выйдите из редактора.

  1. Перезапустите службу Docker
sudo systemctl restart docker
  1. Запустите контейнеры Принтум

Если установлен Мониторинг:

cd /opt/printum
docker-compose up -d

Если установлен ПринтМенеджер:

cd /opt/printmanager
docker-compose up -d
  1. Проверьте адреса контейнеров
sudo docker ps -q | sudo xargs -n 1 docker inspect -f '{{ .Name }}: {{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}'

Ошибка при запуске контейнеров

ERROR: could not find an available, non-overlapping IPv4 address pool among the defaults to assign to the network

Причина: выбранный диапазон адресов также пересекается с существующими сетями.
Решение: вернитесь к шагу 3 и укажите другой диапазон IP-адресов.

Если конфликт известен до установки

Если известно, что адресное пространство 10.28.32.0/26 конфликтует с вашей сетью до установки системы — выполните инструкцию, игнорируя шаги 1 и 5 (остановку и повторный запуск контейнеров). Настройка пула выполняется до первого запуска системы.

Что проверить перед эскалацией

  • Выбранный диапазон не пересекается с другими подсетями (проверить с сетевым администратором).
  • Файл /etc/docker/daemon.json сохранён корректно (валидный JSON).
  • Служба Docker перезапущена после изменения конфигурации.
  • IP-адреса контейнеров принадлежат новому пулу (шаг 6).
Back to top