basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN
    МануалDockerСети Docker

    Сети Docker: соседи по имени, общая сеть с Traefik и база без выхода наружу

    Контейнеры находят друг друга по имени только в своей сети: в сети bridge по умолчанию имён нет. Сервису за прокси хватает двух сетей — общей proxy, через которую к нему ходит Traefik, и внутренней с internal: true, где база видна соседям, а сама наружу не выходит.

    Как контейнеры находят друг друга

    Сеть Docker с драйвером bridge — это мост на хосте (docker0 у сети по умолчанию, br-<id> у остальных) и своя подсеть: 172.17.0.0/16, 172.18.0.0/16 и дальше по порядку. Контейнер получает в ней адрес, и после пересоздания адрес может быть другим. Поэтому к соседям ходят по имени.

    На имена отвечает DNS, встроенный в Docker: в каждом контейнере своей сети он слушает 127.0.0.11 (nameserver 127.0.0.11 в /etc/resolv.conf контейнера). Он знает имя контейнера, имя сервиса compose и алиасы — но только соседей по сети: из другой сети имя db не найдётся. В сети bridge по умолчанию, куда попадает docker run без --network, встроенного DNS нет вовсе: там соседа видно только по адресу.

    Compose для каждого стека создаёт сеть <проект>_default и кладёт туда все сервисы, у которых нет своего списка networks:. Имя проекта — имя каталога стека («Имя проекта compose»), поэтому стек в /opt/umami получает сеть umami_default.

    Порты между соседями публиковать не нужно: в одной сети контейнеру видны все порты другого. ports: нужен только для доступа с хоста и снаружи, и его Docker открывает мимо фаервола («Порты Docker идут мимо цепочки input»).

    Какая сеть для чего

    Сеть Что даёт Когда берём
    bridge по умолчанию адрес и выход в интернет; имён нет разовый docker run --rm
    сеть стека <проект>_default соседи по имени сервиса; compose создаёт и удаляет её вместе со стеком всё внутри одного стека
    своя общая, в compose — external: true соседи из разных стеков; стек её не создаёт и не удаляет прокси и сервисы за ним — сеть proxy
    internal: true соседи по имени, выхода наружу нет база, кэш — всё, что ходит только к своим
    network_mode: host сеть хоста целиком, ports: не нужен; фаервол хоста действует как на обычную программу сервису нужна сеть хоста: обнаружение устройств по mDNS, сотни портов

    На сервере с Traefik у стека выходит такая раскладка:

    сеть proxy — общая на сервер, создаём один раз
    ├── traefik        порты 80 и 443 опубликованы на хосте
    ├── umami          в двух сетях: сюда к нему ходит Traefik
    └── memos
    
    сеть umami_internal — internal: true, только стек umami
    ├── umami          DATABASE_URL=…@db:5432
    └── db             портов на хосте нет, выхода в интернет нет

    Настройка

    Пример — стек Umami с Postgres в /opt/umami на сервере, где Traefik уже стоит («Сервис по HTTPS»). В compose ниже — только то, что касается сетей.

    1. Смотрим, какие сети уже есть

      docker network ls --format '{{.Name}}\t{{.Driver}}'
      # bridge	bridge
      # host	host
      # none	null

      Эти три есть у Docker всегда. host — сеть самого хоста, none — контейнер без сети, только с lo. Всё остальное в списке создали мы или compose.

    2. Создаём общую сеть для прокси

      sudo docker network create proxy

      Один раз на сервер. Compose такую сеть не создаёт и не удаляет: docker compose down у любого стека, даже у Traefik, её не трогает, и остальные сервисы в ней остаются на месте.

    3. Подключаем сервис к общей сети

      services:
        umami:
          networks: [proxy, internal]
          labels:
            - "traefik.enable=true"
            - "traefik.docker.network=proxy"
      
      networks:
        proxy:
          external: true

      external: true — compose ищет готовую сеть с этим именем и не добавляет к нему префикс проекта.

      traefik.docker.network нужен, как только у сервиса больше одной сети. Без него Traefik берёт адрес контейнера из любой из них — и если взял адрес во внутренней сети, где самого Traefik нет, запрос висит до Gateway Timeout. В лейбле — имя сети в Docker, как в docker network ls. Если в compose ключ другой (traefik_proxy: с name: proxy), в лейбле всё равно proxy.

    4. Закрываем базу во внутренней сети

      services:
        umami:
          environment:
            - DATABASE_URL=postgresql://umami:${DB_PASSWORD}@db:5432/umami
          networks: [proxy, internal]
      
        db:
          image: postgres:16-alpine
          networks: [internal]
      
      networks:
        proxy:
          external: true
        internal:
          internal: true

      У сети с internal: true нет выхода наружу: umami ходит к базе по имени db, а из самой базы пакет в интернет не уйдёт — ей он и не нужен. ports: у базы нет: соседу по сети её порт 5432 виден и так.

      Compose назовёт сеть umami_internal: к ключу из файла он добавляет имя проекта.

      Список networks: у сервиса заменяет сеть default, а не дополняет её. Поэтому у каждого сервиса перечисляем все сети, где он должен быть («networks заменяет default»).

    5. Поднимаем стек и проверяем имена изнутри сети

      cd /opt/umami
      docker compose up -d
      docker run --rm --network umami_internal alpine ping -c1 -W2 db
      # PING db (172.19.0.2): 56 data bytes
      # 64 bytes from 172.19.0.2: seq=0 ttl=64 time=0.104 ms

      Разовый контейнер в той же сети находит db по имени сервиса: имя действует для всей сети, а не только внутри стека. Подсеть у нас будет своя — Docker раздаёт их по порядку.

    Сервис на самом хосте

    Бывает, что программа стоит на хосте, а ходит к ней контейнер: Ollama на хосте и веб-интерфейс к ней в контейнере. 127.0.0.1 внутри контейнера — сам контейнер, поэтому даём ему имя хоста:

    services:
      open-webui:
        extra_hosts:
          - "host.docker.internal:host-gateway"

    Вместо host-gateway Docker подставляет адрес моста docker0, обычно 172.17.0.1, и контейнер ходит на http://host.docker.internal:11434. Сервис, который слушает только 127.0.0.1, на этот адрес не ответит: Ollama по умолчанию так и делает, ей нужен OLLAMA_HOST=0.0.0.0.

    Наружу такой порт закрывает фаервол хоста: программа на самом хосте, в отличие от опубликованного порта Docker, получает пакеты через input. Запрос из контейнера к хосту для фаервола тоже входящий, поэтому ufw с default deny incoming режет и его, пока нет правила sudo ufw allow from 172.16.0.0/12 to any port 11434. 172.16.0.0/12 покрывает подсети Docker по умолчанию, 172.17–172.31. Что порт снаружи закрыт, проверяем с другого компьютера («Модель на своём железе», «Как проверить»).

    Если не работает

    Контейнер не находит соседа: could not translate host name "db" to address или getaddrinfo ENOTFOUND db

    Причина
    Они в разных сетях. Часто — потому что сервису перечислили networks:, и он вышел из сети default, где осталась база («networks заменяет default»).
    Делаем
    Смотрим, кто в сети: docker network inspect umami_internal --format '{{range .Containers}}{{.Name}} {{end}}'. Кладём оба сервиса в одну сеть.

    Контейнеры запущены docker run, сосед отвечает по IP, а по имени — bad address

    Причина
    Без --network контейнер попадает в сеть bridge по умолчанию, а в ней встроенного DNS нет.
    Делаем
    Создаём свою сеть и запускаем с --network, или переносим запуск в compose: он создаёт сеть стека сам.

    network proxy declared as external, but could not be found

    Причина
    Сеть с external: true compose не создаёт: её создают один раз на сервер.
    Делаем
    sudo docker network create proxy и снова docker compose up -d.

    Сервис в двух сетях, и Traefik отвечает Gateway Timeout — всегда или после пересоздания

    Причина
    Без лейбла traefik.docker.network Traefik берёт адрес контейнера из любой его сети и может взять адрес во внутренней, куда сам не подключён.
    Делаем
    Лейбл traefik.docker.network=proxy. Значение — имя сети в docker network ls, а не ключ из compose.

    Из контейнера не открывается сервис хоста по 127.0.0.1

    Причина
    127.0.0.1 в контейнере — сам контейнер: у него своя сеть и свой lo.
    Делаем
    extra_hosts: ["host.docker.internal:host-gateway"] и адрес host.docker.internal. Сервис на хосте слушает 0.0.0.0, ufw закрывает его снаружи и пускает подсети Docker.

    Подняли новый стек, и сервер пропал для машин в домашней или офисной сети

    Причина
    Новой сети Docker досталась подсеть из 192.168.0.0/16, и она совпала с сетью, откуда к серверу ходят.
    Делаем
    Задаём свой пул адресов в daemon.json («Подсеть Docker совпала с домашней»).

    Как проверить

    В каких сетях контейнер и с какими адресами:

    docker inspect umami-umami-1 --format '{{range $k, $v := .NetworkSettings.Networks}}{{$k}} {{$v.IPAddress}}{{"\n"}}{{end}}'
    # proxy 172.18.0.5
    # umami_internal 172.19.0.3

    Кто в общей сети — Traefik и все сервисы за ним:

    docker network inspect proxy --format '{{range .Containers}}{{.Name}} {{end}}'

    База наружу не выходит:

    docker compose exec db wget -T 5 -q -O /dev/null https://example.org && echo "есть выход" || echo "выхода нет"
    # выхода нет