Как контейнеры находят друг друга
Сеть 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 ниже — только то, что касается сетей.
Смотрим, какие сети уже есть
docker network ls --format '{{.Name}}\t{{.Driver}}' # bridge bridge # host host # none nullЭти три есть у Docker всегда.
host— сеть самого хоста,none— контейнер без сети, только сlo. Всё остальное в списке создали мы или compose.Создаём общую сеть для прокси
sudo docker network create proxyОдин раз на сервер. Compose такую сеть не создаёт и не удаляет:
docker compose downу любого стека, даже у Traefik, её не трогает, и остальные сервисы в ней остаются на месте.Подключаем сервис к общей сети
services: umami: networks: [proxy, internal] labels: - "traefik.enable=true" - "traefik.docker.network=proxy" networks: proxy: external: trueexternal: true— compose ищет готовую сеть с этим именем и не добавляет к нему префикс проекта.traefik.docker.networkнужен, как только у сервиса больше одной сети. Без него Traefik берёт адрес контейнера из любой из них — и если взял адрес во внутренней сети, где самого Traefik нет, запрос висит доGateway Timeout. В лейбле — имя сети в Docker, как вdocker network ls. Если в compose ключ другой (traefik_proxy:сname: proxy), в лейбле всё равноproxy.Закрываем базу во внутренней сети
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»).Поднимаем стек и проверяем имена изнутри сети
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: truecompose не создаёт: её создают один раз на сервер. - Делаем
sudo docker network create proxyи сноваdocker compose up -d.
Сервис в двух сетях, и Traefik отвечает Gateway Timeout — всегда или после пересоздания
- Причина
- Без лейбла
traefik.docker.networkTraefik берёт адрес контейнера из любой его сети и может взять адрес во внутренней, куда сам не подключён. - Делаем
- Лейбл
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 "выхода нет"
# выхода нет