🐳
blog.cat.ssl

Автоматический SSL в Docker с Traefik: полная настройка

22.11.2026
← Все статьи

Когда на одном сервере в Docker работает несколько сервисов, получение SSL-сертификата для каждого и его продление быстро превращается в утомительную рутину. Для каждого нового контейнера нужно писать конфигурацию Nginx, вызывать Certbot и не забывать перезагрузку после продления. Traefik полностью автоматизирует этот процесс: он сам следит за контейнерами в Docker, читает из их меток, какой домен относится к какому контейнеру, и сам получает и продлевает сертификаты Let's Encrypt. В этой статье пошагово разберём полную рабочую конфигурацию для Traefik 3.

Как работает Traefik

Traefik — это обратный прокси, то есть сервис, который принимает запросы из интернета и направляет их в нужный контейнер. Главное отличие от Nginx в том, откуда он берёт конфигурацию. Traefik через сокет Docker отслеживает список контейнеров и, как только запускается новый, читает его раздел labels. В метках описывается правило маршрута: какое доменное имя, какая точка входа и какой поставщик сертификатов используются. Поэтому для добавления нового сервиса перенастраивать Traefik не нужно, достаточно задать контейнеру правильные метки.

Для сертификатов в Traefik есть понятие certificate resolver. Это способ получения сертификата по протоколу ACME: какой центр, какой тип проверки и в каком файле хранить сертификаты. Один раз описанный resolver любой контейнер использует по имени.

Подготовка: домен и порты

Перед началом должны выполняться два условия. Во-первых, все имена сервисов, например example.uz и www.example.uz, должны указывать в DNS на IP-адрес вашего сервера. Во-вторых, на сервере должны быть открыты порты 80 и 443, и их не должна занимать другая программа, например ранее установленный Nginx. HTTP-проверка проходит именно через порт 80, поэтому если закрыть его в межсетевом экране, сертификат не выпустится. Для доменов, зарегистрированных в sayt.uz, A-записи можно добавить в разделе DNS личного кабинета.

Полный docker-compose.yml

В файле ниже два сервиса: сам Traefik и контейнер nginx:alpine в роли простого сайта. Traefik открывает две точки входа: web на порту 80 и websecure на порту 443. Все запросы по HTTP автоматически перенаправляются на HTTPS, а resolver с именем le получает сертификаты через HTTP-проверку и хранит их в файле acme.json.

services:
  traefik:
    image: traefik:v3
    command:
      - --providers.docker=true
      - --providers.docker.exposedbydefault=false
      - --entrypoints.web.address=:80
      - --entrypoints.websecure.address=:443
      - --entrypoints.web.http.redirections.entrypoint.to=websecure
      - --entrypoints.web.http.redirections.entrypoint.scheme=https
      - --certificatesresolvers.le.acme.email=admin@example.uz
      - --certificatesresolvers.le.acme.storage=/letsencrypt/acme.json
      - --certificatesresolvers.le.acme.httpchallenge.entrypoint=web
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./letsencrypt:/letsencrypt
    restart: unless-stopped

  site:
    image: nginx:alpine
    labels:
      - traefik.enable=true
      - traefik.http.routers.site.rule=Host(`example.uz`) || Host(`www.example.uz`)
      - traefik.http.routers.site.entrypoints=websecure
      - traefik.http.routers.site.tls.certresolver=le
      - traefik.http.services.site.loadbalancer.server.port=80
    restart: unless-stopped

Обратите внимание на несколько важных деталей. Благодаря параметру exposedbydefault=false Traefik публикует в интернет только контейнеры с меткой traefik.enable=true, и такие сервисы, как внутренняя база данных, случайно не окажутся открытыми. loadbalancer.server.port указывает порт внутри контейнера, пробрасывать его на хост через раздел ports не нужно. Адрес электронной почты используется для регистрации учётной записи Let's Encrypt.

Для запуска создайте папку для сертификатов и запустите Compose. Через несколько секунд после первого запроса сертификат будет получен, процесс можно наблюдать в логах.

mkdir -p letsencrypt
docker compose up -d
docker compose logs -f traefik

Сначала проверьте на тестовом сервере

У Let's Encrypt есть ограничения на неудачные попытки, и повторные попытки подряд при ошибке DNS или порта могут временно вас заблокировать. Поэтому новую конфигурацию принято сначала проверять на staging, то есть тестовом сервере. Для этого в команды Traefik добавляется одна строка:

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

Тестовый сертификат браузер показывает как недоверенный, это нормально. Убедившись, что всё работает, удалите эту строку, удалите файл letsencrypt/acme.json и перезапустите контейнер. Иначе Traefik продолжит использовать сохранённые тестовые сертификаты.

Практический пример: сайт и CRM учебного центра

Частный учебный центр в Намангане держит на VPS в Docker два сервиса: публичный сайт misol.uz и внутреннюю систему учёта учеников crm.misol.uz. Раньше для каждого сервиса были написаны отдельная конфигурация Nginx и команда Certbot, и однажды сертификат CRM не продлился, так что утром менеджеры не смогли войти в систему. После перехода на Traefik для CRM написали только следующий блок, и сертификат был получен автоматически при первом же запуске контейнера:

  crm:
    image: misol/crm:latest
    labels:
      - traefik.enable=true
      - traefik.http.routers.crm.rule=Host(`crm.misol.uz`)
      - traefik.http.routers.crm.entrypoints=websecure
      - traefik.http.routers.crm.tls.certresolver=le
      - traefik.http.services.crm.loadbalancer.server.port=3000
    restart: unless-stopped

С тех пор добавление нового сервиса занимает пять минут: контейнеру прописываются четыре метки и выполняется docker compose up -d. За продлением Traefik следит сам и перевыпускает сертификат задолго до окончания срока.

Wildcard-сертификат и DNS-проверка

Если для системы с множеством поддоменов нужен wildcard-сертификат вида *.example.uz, HTTP-проверки недостаточно: Let's Encrypt выдаёт wildcard только через DNS-01. Traefik поддерживает DNS-проверку, но для этого у вашего DNS-провайдера должен быть API, и он должен входить в список провайдеров, поддерживаемых Traefik. Список и нужные переменные окружения для каждого провайдера приведены в документации Traefik.

Безопасность: сокет Docker и acme.json

Чтобы Traefik видел контейнеры, к нему подключается сокет Docker, и это серьёзная ответственность. Процесс с доступом к сокету фактически получает контроль над сервером на уровне root, а пометка :ro не ограничивает запросы к API. Поэтому не открывайте панель Traefik, то есть dashboard, в интернет без пароля и по возможности подключайтесь не к сокету напрямую, а через socket-proxy, пропускающий только запросы на чтение. В файле acme.json хранятся закрытые ключи всех сертификатов: включите его в резервные копии, но никогда не размещайте в открытом репозитории.

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

Если сертификат не выпускается, первым делом прочитайте сообщения, связанные с ACME, в логах Traefik: обычно они прямо указывают на неверный DNS, закрытый порт 80 или превышенный лимит. После получения сертификата проверьте издателя и срок действия через openssl.

docker compose logs traefik 2>&1 | grep -i acme
openssl s_client -connect example.uz:443 -servername example.uz </dev/null 2>/dev/null \
  | openssl x509 -noout -subject -issuer -dates

Похожие статьи

🔑 Закрытый ключ SSL потерян или утёк: что делать 🔍 CT-логи раскрывают ваши поддомены: риск «скрытых» тестовых сайтов ✳️ Wildcard SSL через DNS-01 с автопродлением: руководство по Certbot и acme.sh 🪪 Вход по клиентскому сертификату: дополнительная защита админ-панели
🌐 Язык
🇺🇿 O⁠'zbek 🇺🇿 Özbek (yangi) 🇺🇿 Ўзбек 🇷🇺 Русский ✓ 🇬🇧 English