RU

Приложения

Traefik как обратный прокси с Docker

Развёртывание Traefik с помощью Docker Compose на Debian или Ubuntu: автоматический HTTPS с Let's Encrypt, публикация через метки, защищённая панель управления, обновления и резервное копирование.

9 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Это руководство объясняет, как поставить Traefik перед вашими контейнерами Docker. Traefik принимает посетителей на портах 80 и 443, получает и продлевает сертификаты Let’s Encrypt, а затем передаёт каждый запрос нужному контейнеру по его меткам.

К концу руководства тестовое приложение будет отвечать по адресу https://app.ваш-домен.com. Панель управления Traefik будет доступна по адресу https://traefik.ваш-домен.com только с вашего IP-адреса и по паролю. Вы также научитесь обновлять и резервировать установку.

Указаны последние стабильные версии на момент написания, в ноябре 2026 года: Traefik v3.7.19 и whoami v1.12.0.

Заказать сервер

Это руководство подходит для серверов, которыми вы управляете самостоятельно:

Предварительные требования

  • Сервер под управлением Debian 12 или 13 либо Ubuntu 22.04 или 24.04
  • Доступ по SSH под пользователем с правами sudo, входящим в группу docker
  • Docker Engine и Docker Compose, установленные по руководству Установка Docker Engine и Docker Compose
  • Доменное имя, DNS-зоной которого вы управляете
  • Отсутствие другого ПО на портах 80 и 443, например Nginx, Apache, Caddy или Nginx Proxy Manager
  • Фиксированный IP-адрес на вашем компьютере для доступа к панели управления либо VPN

Используемые порты

Порт Направление Назначение Нужно ли открывать
80/tcp Входящий Проверка HTTP-01 и перенаправление на HTTPS Да
443/tcp Входящий Сайты по HTTPS и панель управления Да
8080/tcp Нет Небезопасный API Traefik, здесь отключён Нет
2375/tcp Внутренняя сеть Docker Прокси сокета Docker, никогда не публикуется на сервере Нет

Шаг 1: направьте имена на сервер

Создайте две записи A, указывающие на IP_ВАШЕГО_СЕРВЕРА: app.ваш-домен.com и traefik.ваш-домен.com. Если ваш домен обслуживается в HostMyServers, следуйте руководству Создание записи A.

Затем проверьте результат с сервера:

Терминал
sudo apt update
sudo apt install -y bind9-dnsutils
dig +short A app.ваш-домен.com
dig +short A traefik.ваш-домен.com
dig +short AAAA traefik.ваш-домен.com

Первые две команды должны вернуть адрес вашего сервера. Последняя должна остаться пустой: панель управления фильтруется по адресу IPv4, и подключение по IPv6 будет отклонено.

Шаг 2: подготовьте каталоги и сеть

Создайте каталог проекта и файл для сертификатов. Traefik отвергает этот файл, если его могут читать пользователи, кроме владельца.

Терминал
sudo install -d -o "$USER" -g "$USER" /opt/traefik /opt/traefik/letsencrypt
cd /opt/traefik
touch letsencrypt/acme.json
chmod 600 letsencrypt/acme.json

Затем создайте сеть Docker, общую для Traefik и публикуемых приложений:

Терминал
docker network create proxy

Шаг 3: создайте пароль для панели управления

Установите htpasswd, затем сгенерируйте хеш для учётной записи admin. Команда дважды запросит пароль:

Терминал
sudo apt install -y apache2-utils
htpasswd -nB admin > /opt/traefik/dashboard.htpasswd
chmod 600 /opt/traefik/dashboard.htpasswd

Файл содержит хеш bcrypt, а не пароль в открытом виде. Хранение его в файле избавляет от необходимости удваивать символы $ в метках Docker Compose.

Шаг 4: напишите файл Compose

Создайте файл:

Терминал
nano /opt/traefik/compose.yaml

Вставьте это содержимое, заменив домен, адрес электронной почты и ВАШ_IP:

YAML
services:
  socket-proxy:
    image: tecnativa/docker-socket-proxy:3.4
    container_name: traefik-socket-proxy
    restart: unless-stopped
    environment:
      CONTAINERS: "1"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    networks:
      - socket

  traefik:
    image: traefik:v3.7.19
    container_name: traefik
    restart: unless-stopped
    depends_on:
      - socket-proxy
    security_opt:
      - no-new-privileges:true
    ports:
      - "80:80"
      - "443:443"
    command:
      - "--entrypoints.web.address=:80"
      - "--entrypoints.web.http.redirections.entrypoint.to=websecure"
      - "--entrypoints.web.http.redirections.entrypoint.scheme=https"
      - "--entrypoints.web.http.redirections.entrypoint.permanent=true"
      - "--entrypoints.websecure.address=:443"
      - "--entrypoints.websecure.http.tls=true"
      - "--entrypoints.websecure.http.tls.certresolver=le"
      - "--providers.docker=true"
      - "--providers.docker.endpoint=tcp://socket-proxy:2375"
      - "--providers.docker.exposedbydefault=false"
      - "--providers.docker.network=proxy"
      - "--api.dashboard=true"
      - "--api.insecure=false"
      - "--certificatesresolvers.le.acme.email=admin@ваш-домен.com"
      - "--certificatesresolvers.le.acme.storage=/letsencrypt/acme.json"
      - "--certificatesresolvers.le.acme.httpchallenge.entrypoint=web"
      - "--log.level=INFO"
      - "--accesslog=true"
    volumes:
      - ./letsencrypt:/letsencrypt
      - ./dashboard.htpasswd:/etc/traefik/dashboard.htpasswd:ro
    networks:
      - proxy
      - socket
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.dashboard.rule=Host(`traefik.ваш-домен.com`)"
      - "traefik.http.routers.dashboard.entrypoints=websecure"
      - "traefik.http.routers.dashboard.service=api@internal"
      - "traefik.http.routers.dashboard.middlewares=dashboard-ip,dashboard-auth"
      - "traefik.http.middlewares.dashboard-ip.ipallowlist.sourcerange=ВАШ_IP/32"
      - "traefik.http.middlewares.dashboard-auth.basicauth.usersfile=/etc/traefik/dashboard.htpasswd"

networks:
  proxy:
    external: true
  socket:
    internal: true
Элемент Назначение
socket-proxy Фильтрует доступ к API Docker: Traefik может читать контейнеры, но не создавать и не изменять их
CONTAINERS: "1" Разрешает чтение контейнеров, а запросы на запись по умолчанию остаются заблокированными
socket Внутренняя сеть без доступа в Интернет, предназначенная только для Traefik и прокси
exposedbydefault=false Публикуются только контейнеры с меткой traefik.enable=true
network=proxy Traefik обращается к приложениям через эту сеть
httpchallenge Let’s Encrypt проверяет каждое имя на порту 80
certresolver=le Все сайты на точке входа HTTPS получают сертификат
api@internal Внутренний сервис, обеспечивающий работу панели управления
dashboard-ip, затем dashboard-auth Фильтрует IP-адрес, затем запрашивает пароль

Traefik не монтирует сокет Docker напрямую: если контейнер, доступный из Интернета, будет скомпрометирован, злоумышленник не получит контроль над Docker. Это одна из защит, рекомендуемых в документации Traefik.

Шаг 5: запустите Traefik

Проверьте файл, затем запустите контейнеры:

Терминал
cd /opt/traefik
docker compose config --quiet
docker compose up -d
docker compose ps

Обе службы должны находиться в состоянии running. Проследите за запуском по журналам, затем выйдите сочетанием Ctrl+C:

Терминал
docker compose logs -f traefik

Шаг 6: проверьте брандмауэр

Docker публикует порты 80 и 443 по собственным правилам, которые применяются раньше правил UFW. Поэтому эти два порта доступны даже без ufw allow, и UFW не может их ограничить. Подробнее это описано в руководстве Настройка брандмауэра UFW.

Из этого следуют два правила:

  • Не публикуйте порты ваших приложений: они остаются в сети proxy, без раздела ports.
  • Если вы используете встроенный брандмауэр вашего экземпляра, разрешите порты 80 и 443 также в личном кабинете.

Шаг 7: опубликуйте приложение

Создайте тестовое приложение в отдельном каталоге:

Терминал
sudo install -d -o "$USER" -g "$USER" /opt/whoami
nano /opt/whoami/compose.yaml
YAML
services:
  whoami:
    image: traefik/whoami:v1.12.0
    restart: unless-stopped
    networks:
      - proxy
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.whoami.rule=Host(`app.ваш-домен.com`)"
      - "traefik.http.routers.whoami.entrypoints=websecure"
      - "traefik.http.services.whoami.loadbalancer.server.port=80"

networks:
  proxy:
    external: true

Запустите его:

Терминал
cd /opt/whoami
docker compose up -d

Traefik обнаруживает контейнер самостоятельно, без перезапуска. Метка loadbalancer.server.port указывает порт, который слушается внутри контейнера. Для своих приложений возьмите эти четыре метки, изменив имя маршрутизатора, домен и порт.

Проверка результата

Проверьте оба протокола, затем сертификат:

Терминал
curl -I http://app.ваш-домен.com
curl -I https://app.ваш-домен.com
echo | openssl s_client -connect app.ваш-домен.com:443 -servername app.ваш-домен.com 2>/dev/null | openssl x509 -noout -issuer -dates

HTTP-запрос должен вернуть перенаправление 308 на HTTPS, а HTTPS-запрос — код 200. Издателем сертификата должен быть Let’s Encrypt. Получение первого сертификата может занять некоторое время.

Затем убедитесь, что прокси сокета блокирует всё неразрешённое:

Терминал
cd /opt/traefik
docker compose exec traefik wget -S -O- http://socket-proxy:2375/images/json

Ожидаемый ответ: 403 Forbidden.

С вашего компьютера проверьте панель управления. Первый вызов должен вернуть 401, второй — версию Traefik, а третий не должен отвечать:

Терминал
curl -I https://traefik.ваш-домен.com/dashboard/
curl -u admin https://traefik.ваш-домен.com/api/version
curl -m 5 http://IP_ВАШЕГО_СЕРВЕРА:8080

Наконец, откройте https://traefik.ваш-домен.com/dashboard/ в браузере. Завершающая косая черта обязательна. С другого IP-адреса эта же страница должна вернуть 403.

Управление доступом к панели управления

Чтобы изменить пароль, заново создайте файл и перезапустите Traefik:

Терминал
cd /opt/traefik
htpasswd -nB admin > dashboard.htpasswd
docker compose restart traefik

Если ваш IP-адрес изменился, измените метку dashboard-ip в compose.yaml, затем выполните docker compose up -d. Если он меняется часто, лучше ограничьте панель управления частной сетью с помощью WireGuard или Tailscale.

Типичные настройки

Ответ сразу на несколько имён

YAML
- "traefik.http.routers.whoami.rule=Host(`app.ваш-домен.com`) || Host(`www.ваш-домен.com`)"

Каждое имя должно указывать на сервер, иначе сертификат не будет выдан.

Защита приложения теми же правилами

Промежуточные обработчики (middleware), объявленные на контейнере Traefik, можно использовать в других контейнерах, добавив суффикс @docker:

YAML
- "traefik.http.routers.whoami.middlewares=dashboard-ip@docker,dashboard-auth@docker"

Обновление

Сначала прочитайте примечания к выпуску, а при смене минорной или мажорной версии — руководство по миграции. Затем создайте резервную копию установки, измените тег traefik:v3.7.19 в compose.yaml и выполните:

Терминал
cd /opt/traefik
docker compose pull
docker compose up -d
docker compose exec traefik traefik version
docker compose logs --tail 50 traefik

Образ tecnativa/docker-socket-proxy:3.4 остаётся на ветке HAProxy 3.4, а его издатель пересобирает его каждую неделю: docker compose pull загружает эти обновления. Действуйте так же в /opt/whoami и в каталогах ваших приложений.

Резервное копирование и восстановление

Каталог /opt/traefik содержит всё, что нужно сохранить:

Путь Содержимое
compose.yaml Конфигурация Traefik и прокси сокета
dashboard.htpasswd Хеш пароля панели управления
letsencrypt/acme.json Сертификаты, закрытые ключи и учётная запись ACME
Терминал
sudo tar -czf /root/traefik-$(date +%F).tar.gz -C /opt traefik
sudo chmod 600 /root/traefik-$(date +%F).tar.gz

Этот архив содержит закрытые ключи: скопируйте его за пределы сервера в зашифрованное хранилище. Сохраняйте также файлы Compose и данные ваших приложений.

Чтобы восстановить архив, подставьте вместо ГГГГ-ММ-ДД его дату и создайте сеть, если её ещё нет на этом сервере:

Терминал
cd /opt/traefik 2>/dev/null && docker compose down
sudo tar -xzf /root/traefik-ГГГГ-ММ-ДД.tar.gz -C /opt
docker network create proxy
cd /opt/traefik
docker compose up -d

Если что-то пошло не так

Начните с просмотра журналов:

Терминал
cd /opt/traefik
docker compose logs --tail 100 traefik
docker compose logs --tail 50 socket-proxy

port is already allocated или address already in use

Другая служба занимает порт 80 или 443:

Терминал
sudo ss -ltnp | grep -E ':(80|443) '
docker ps --format '{{.Names}} {{.Ports}}'

Остановите эту службу, если она больше не нужна, например командой sudo systemctl disable --now nginx.

permissions 644 for /letsencrypt/acme.json are too open, please use 600

Исправьте права, затем перезапустите Traefik:

Терминал
chmod 600 /opt/traefik/letsencrypt/acme.json
cd /opt/traefik
docker compose restart traefik

Failed to retrieve information of the docker client and server host

Traefik не может подключиться к прокси сокета. Убедитесь, что socket-proxy работает и что обе службы находятся в общей сети socket. В зависимости от причины, указанной в его журналах:

  • Если на сервере нет IPv6 и прокси не запускается, добавьте DISABLE_IPV6: "1" в его переменные окружения.
  • Если CONTAINERS отсутствует, Traefik получает 403 Forbidden при перечислении контейнеров.
  • Если у прокси нет права открывать сокет, его издатель сообщает, что при некоторых профилях SELinux или AppArmor может потребоваться privileged: true. Добавляйте эту опцию только в крайнем случае.

404 page not found

Ни один маршрутизатор не соответствует запросу. Убедитесь, что контейнер запущен, что у него есть метка traefik.enable=true, что имя в Host() указано точно и что он подключён к сети proxy:

Терминал
docker network inspect proxy --format '{{range .Containers}}{{.Name}} {{end}}'

Bad Gateway или Gateway Timeout

Traefik находит маршрутизатор, но не может подключиться к приложению. Проверьте порт, указанный в loadbalancer.server.port, затем выполните проверку из Traefik:

Терминал
cd /opt/traefik
docker compose exec traefik wget -qO- http://whoami:80

Приложение должно слушать 0.0.0.0 внутри своего контейнера. Если оно слушает только 127.0.0.1, Traefik не сможет до него достучаться.

Браузер показывает TRAEFIK DEFAULT CERT

У Traefik пока нет действительного сертификата для этого имени, и он предъявляет свой сертификат по умолчанию. Найдите причину в журналах:

Терминал
cd /opt/traefik
docker compose logs traefik | grep -iE 'acme|certificate'

Unable to obtain ACME certificate for domains

Сообщение содержит причину отказа:

  • urn:ietf:params:acme:error:dns: имя ещё не существует в DNS или записи не распространились.
  • urn:ietf:params:acme:error:unauthorized или connection: Let’s Encrypt не может подключиться к порту 80. Проверьте записи A и AAAA, затем брандмауэр вашего экземпляра. Если всё верно, обратитесь в поддержку из личного кабинета.
  • urn:ietf:params:acme:error:caa: запись CAA запрещает Let’s Encrypt.
  • urn:ietf:params:acme:error:rateLimited: отправлено слишком много запросов. Дождитесь окончания указанного периода.

Для тестов временно добавьте тестовое окружение Let’s Encrypt, сертификаты которого не распознаются браузерами:

YAML
- "--certificatesresolvers.le.acme.caserver=https://acme-staging-v02.api.letsencrypt.org/directory"

Перед возвратом к рабочему режиму удалите эту строку и очистите acme.json командой truncate -s 0 /opt/traefik/letsencrypt/acme.json, не меняя его права. Затем выполните docker compose up -d.

403 Forbidden на панели управления

Ваш IP-адрес не совпадает с указанным в метке dashboard-ip. Журнал доступа показывает адрес, который видит Traefik, в начале строки:

Терминал
cd /opt/traefik
docker compose logs --no-log-prefix traefik | grep 'dashboard@docker' | tail -n 5

Если это адрес шлюза Docker, вероятно, подключение пришло по IPv6: удалите запись AAAA этого имени.

is a directory для dashboard.htpasswd

При первом запуске файла не было, и Docker создал на его месте каталог. Удалите его, создайте файл заново и перезапустите контейнер:

Терминал
cd /opt/traefik
docker compose down
sudo rmdir dashboard.htpasswd
htpasswd -nB admin > dashboard.htpasswd
chmod 600 dashboard.htpasswd
docker compose up -d

Ссылки