Конфигурация Caddy для on-demand-сертификатов и wildcard-доменов с поддержкой Cloudflare

Встала тут одна задача, сделать reverse proxy, который будет проксировать трафик и для определённых доменов выпускать новые сертификаты налету, а для некоторых нужно просто автоматически выпустить сертификат.

Для такой задачи идеально подходит Caddy

Caddy - веб-сервер с открытым исходным кодом и автоматическим HTTPS, написанный на Go

Конфигурация Caddy для on-demand-сертификатов и wildcard-доменов с поддержкой Cloudflare

Для работы с Caddy нужно создать Caddyfile

{ # Укажите email для уведомлений по SSL-сертификатам email caddy@email.com }

Это минимальный набор, который нужен для того, что бы Caddy вообще запустился, продолжим. Сначала разберемся со статичными доменами. Для того что бы Caddy запросил сертификат для такого домена, нужно просто добавить его в конфиг.

{ email caddy@email.com } # Указываем домен my-site.com { # Указываем куда проксировать reverse_proxy http://localhost:3000 { header_up Host {upstream_hostport} } }

Вот и все, при старте, Caddy прочитает конфиг и запустит выпуск сертификата для этого домена через Let'sEncrypt посредством http челленджа.

Тут тоже все просто (особенно если у вас cloudflare). Нам нужно просто добавить wildcard домен в Caddyfile, но есть один нюанс. Вот так выглядит обновленный конфиг:

{ email caddy@email.com } # Указываем wildcard домен *.my-site.com { tls { # даем доступ Caddy к Cloudflare DNS dns cloudflare {env.CLOUDFLARE_API_TOKEN} } reverse_proxy http://localhost:3000 { header_up Host {upstream_hostport} } }

Когда мы используем wildcard домен в конфиге, мы обязаны использовать DNS challenge вместо http, а для этого нам нужно дать разрешение Caddy на добавление записи в DNS. В данном случае я использую Cloudflare DNS и плагин для работы с ним.

Вот и все, теперь у вас есть рабочий Reverse Proxy, который выпишет сертификат для my-site.com и wildcard *.my-site.com!

{ email caddy@email.com # Включает получение TLS-сертификатов по запросу. # Можно удалить блок, если не требуется проверка доменов # перед выдачей сертификатов on_demand_tls { # Проверка разрешения на выдачу сертификата для домена ask https://your-api.com/check-domain } } # Это позволит обрабатывать все входящие запросы по https https:// { # Включаем on-demand выдачу сертификатов tls { on_demand } # пример, выдавать сертификаты для всех доменов, которые начинаются # с test, то есть для таких test.* @test { header_regexp Host ^test\..*$ } reverse_proxy @test http://localhost:3000 { header_up Host {upstream_hostport} } }

Вот такой небольшой конфиг позволит автоматически выдавать сертификаты для test.* доменов.

{ email caddy@email.com on_demand_tls { # Небольшая хитрость, сделаем запрос на этот же сервер ask http://localhost:8080/check-domain } } # Это как раз то, что мы указали в on_demand_tls.ask http://localhost:8080 { handle_path /check-domain* { # endpoint в вашем API rewrite * /check-domain{uri.query} reverse_proxy https://your-api.com { transport http { tls tls_server_name your-api.com } header_up Host your-api.com # И вот как пример можно прокинуть Header и в API проверить этот ключ header_up X-Api-Key rjiw89wuruwriwiruwoirjw header_up User-Agent {>User-Agent} } } }

А для самых терпеливых у меня есть приятный бонус, пользуйтесь! Dockerfile с помощью которого можно это все запустить.

FROM caddy:2.8.4-builder AS builder # Собираем Caddy и устанавливаем cloudflare плагин RUN xcaddy build \ --with github.com/caddy-dns/cloudflare FROM caddy:2.8.4 COPY --from=builder /usr/bin/caddy /usr/bin/caddy # Рядом с Dockerfile должен лежать Caddyfile COPY Caddyfile /etc/caddy/Caddyfile RUN mkdir -p /var/www/html WORKDIR /var/www/html EXPOSE 80 443 # Запускаем Caddy CMD ["caddy", "run", "--config", "/etc/caddy/Caddyfile", "--adapter", "caddyfile"]

Вот и все, жду вашего отклика :)

Заглядывайте в мой Telegram-канал @devdrafts_rss, где я делюсь материалами по IT, которые сам употребляю 🙂

5 комментариев

Алексей

04.11.2024

Недавно услышал про Caddy, но еще не пользовался. Сам использую Traefik как реверс-прокси для Docker контейнеров.
Там очень удобно, что реверс-прокси сам конфигурируется в зависимости от меток контейнеров, то есть можно просто поднять docker compose и на него автоматически будет направляться трафик и выдаваться сертификаты.

Есть ли что-то подобное в Caddy? По сути это service discovery

Ответить

Алексей Зикрацкий: DevDrafts

Автор

Traefik я не использовал, мне Caddy показался более простым в настройке для моей задачи :) Но на сколько я читал, в Caddy есть аналог для решения этой задачи, через плагин https://github.com/lucaslorentz/caddy-docker-proxyю. Он тоже на основе меток может автоматически настроить маршрутизацию контейнеров :)
Спасибо за коммент, хорошая тема для следующей статьи, записал :)

github.com

Конфигурация Caddy для on-demand-сертификатов и wildcard-доменов с поддержкой Cloudflare

Что такое Caddy?

Сертификат для статичных доменов

Как быть с wildcard?

Теперь о on-demand (по требованию) сертификатах

А что если наш https://your-api.com/check-domain требует авторизации?

Бонус для тех кто дочитал