Caddy как обратный прокси с автоматическим HTTPS
Установка Caddy на Debian или Ubuntu из официального репозитория, публикация приложения с автоматическим HTTPS, защита интерфейса администрирования, обновление и резервное копирование.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Это руководство объясняет, как поставить Caddy перед приложением, размещённым на вашем сервере. Caddy принимает посетителей на портах 80 и 443, самостоятельно получает и продлевает TLS-сертификат, а затем передаёт запросы приложению, которое остаётся доступным только локально.
К концу руководства ваше приложение будет отвечать по адресу https://app.ваш-домен.com, HTTP-трафик будет перенаправляться на HTTPS, а вы научитесь защищать интерфейс администрирования, обновлять Caddy и резервировать его данные.
Заказать сервер
Это руководство подходит для серверов, которыми вы управляете самостоятельно:
Предварительные требования
- Сервер под управлением Debian 12 или 13 либо Ubuntu 22.04 или 24.04
- Доступ по SSH под пользователем с правами
sudo - Доменное имя, DNS-зоной которого вы управляете
- Приложение, которое слушает локально, например на
127.0.0.1:3000 - Отсутствие другого ПО, занимающего порты 80 и 443, например Nginx или Apache
Используемые порты
| Порт | Направление | Назначение | Нужно ли открывать |
|---|---|---|---|
| 80/tcp | Входящий | Проверка HTTP-01 и перенаправление на HTTPS | Да |
| 443/tcp | Входящий | HTTPS (HTTP/1.1 и HTTP/2) и проверка TLS-ALPN-01 | Да |
| 443/udp | Входящий | HTTP/3 | Рекомендуется |
| 2019/tcp | Локальный | API администрирования Caddy на localhost |
Нет |
| 3000/tcp | Локальный | Приложение из примера | Нет |
Шаг 1: направьте домен на сервер
Создайте запись A для app.ваш-домен.com, указывающую на IP_ВАШЕГО_СЕРВЕРА. Если ваш домен обслуживается в HostMyServers, следуйте руководству Создание записи A.
Затем проверьте результат с сервера:
sudo apt update
sudo apt install -y bind9-dnsutils
dig +short A app.ваш-домен.com
dig +short AAAA app.ваш-домен.comПервая команда должна вернуть адрес вашего сервера. Если вторая возвращает адрес IPv6, он тоже должен принадлежать этому серверу: центр сертификации может использовать его для проверки домена. В противном случае удалите эту запись AAAA.
Шаг 2: установите Caddy из официального репозитория
Добавьте стабильный репозиторий, который публикует проект Caddy, и установите пакет:
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl gnupg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install -y caddyПакет создаёт системного пользователя caddy и запускает одноимённую службу. Проверьте установку:
caddy version
systemctl status caddy --no-pagerШаг 3: откройте брандмауэр
Если вы используете UFW, разрешите веб-порты:
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 443/udp
sudo ufw statusУбедитесь, что приложение отвечает локально:
curl -I http://127.0.0.1:3000Если оно работает в Docker, публикуйте его порт только на локальном интерфейсе: 127.0.0.1:3000:3000. Порт, опубликованный в виде 3000:3000, остаётся доступным из Интернета, потому что Docker добавляет собственные правила брандмауэра, а UFW их не фильтрует.
Шаг 4: напишите Caddyfile
Сохраните поставляемый файл и откройте его:
sudo cp /etc/caddy/Caddyfile /etc/caddy/Caddyfile.orig
sudo nano /etc/caddy/CaddyfileЗамените его содержимое на следующее:
{
email admin@ваш-домен.com
}
app.ваш-домен.com {
encode zstd gzip
reverse_proxy 127.0.0.1:3000
}| Элемент | Назначение |
|---|---|
email |
Адрес, связанный с учётной записью ACME; пригодится при проблемах с сертификатом |
app.ваш-домен.com |
Публичное имя: его наличие включает автоматический HTTPS |
encode zstd gzip |
Сжатие ответов |
reverse_proxy |
Передача запросов приложению |
Caddy самостоятельно перенаправляет HTTP на HTTPS и поддерживает WebSocket. Он также заполняет заголовки X-Forwarded-For, X-Forwarded-Proto и X-Forwarded-Host и передаёт исходный Host приложению, работающему по HTTP.
Шаг 5: проверьте и примените конфигурацию
sudo caddy fmt --overwrite /etc/caddy/Caddyfile
sudo -u caddy caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
sudo systemctl reload caddyПерезагрузка конфигурации не разрывает текущие соединения. Если новая конфигурация отклонена, Caddy продолжает работать с предыдущей.
Проверка результата
Просмотрите журналы, затем проверьте оба протокола:
sudo journalctl -u caddy --no-pager -n 50
curl -I http://app.ваш-домен.com
curl -I https://app.ваш-домен.comHTTP-запрос должен вернуть перенаправление 308 на HTTPS, а HTTPS-запрос — ответ вашего приложения. В журналах должна быть строка certificate obtained successfully.
Затем проверьте издателя и даты сертификата, а также прослушиваемые порты:
echo | openssl s_client -connect app.ваш-домен.com:443 -servername app.ваш-домен.com 2>/dev/null | openssl x509 -noout -issuer -dates
sudo ss -tulpn | grep caddyПорт 2019 должен быть виден только на 127.0.0.1. С вашего компьютера адрес http://IP_ВАШЕГО_СЕРВЕРА:3000 не должен отвечать.
Публикация нескольких сайтов
Чтобы хранить по одному файлу на сайт, создайте отдельный каталог:
sudo mkdir -p /etc/caddy/sites
sudo nano /etc/caddy/sites/app.caddyПоместите блок сайта в /etc/caddy/sites/app.caddy:
app.ваш-домен.com {
encode zstd gzip
reverse_proxy 127.0.0.1:3000
}Файл /etc/caddy/Caddyfile теперь содержит только глобальные параметры и импорт:
{
email admin@ваш-домен.com
}
import sites/*.caddyСнова проверьте и перезагрузите конфигурацию, как на шаге 5.
Защита интерфейса администрирования
Интерфейс администрирования не должен быть открыт для всех. В следующем примере совмещены две защиты: принимается только ваш IP-адрес, после чего запрашивается пароль.
Сначала сгенерируйте хеш пароля. Команда дважды запросит пароль и выведет результат:
caddy hash-passwordЗатем добавьте этот сайт, заменив BCRYPT_HASH полученным хешем:
admin.ваш-домен.com {
@allowed client_ip ВАШ_IP
handle @allowed {
basic_auth {
admin BCRYPT_HASH
}
reverse_proxy 127.0.0.1:9000
}
handle {
abort
}
}Соединения с других адресов обрываются без ответа. Если ваш IP-адрес часто меняется, лучше ограничьте этот интерфейс частной сетью с помощью WireGuard или Tailscale.
Типичные настройки
Распределение нагрузки между несколькими экземплярами
app.ваш-домен.com {
reverse_proxy 127.0.0.1:3001 127.0.0.1:3002 {
lb_policy round_robin
health_uri /health
health_interval 10s
}
}URL /health должен существовать в вашем приложении и отвечать кодом 2xx. Экземпляр, не прошедший эту проверку, исключается из ротации до восстановления.
Подключение к приложению по HTTPS
app.ваш-домен.com {
reverse_proxy https://127.0.0.1:8443 {
header_up Host {host}
transport http {
tls_server_name backend.ваш-домен.com
}
}
}Caddy проверяет сертификат приложения. tls_server_name должно совпадать с именем, указанным в этом сертификате. Начиная с Caddy 2.11, Host, отправляемый на HTTPS-цель, по умолчанию совпадает с именем самой цели: header_up Host {host} сохраняет публичное имя для приложений, которым оно необходимо.
Запись журнала доступа в файл
app.ваш-домен.com {
log {
output file /var/log/caddy/app.log
}
reverse_proxy 127.0.0.1:3000
}Пакет создаёт /var/log/caddy для пользователя caddy. Храните журналы в этом каталоге, чтобы избежать ошибок прав доступа.
Caddy за другим прокси
Если посетителей принимает другой прокси, расположенный перед Caddy, укажите его адрес в глобальных параметрах. Без этого Caddy не учитывает адрес клиента, который передаёт ему этот прокси.
{
email admin@ваш-домен.com
servers {
trusted_proxies static 203.0.113.10/32
}
}Обновление Caddy
Поскольку Caddy установлен из пакета, обновляйте его через APT:
sudo apt update
sudo apt install --only-upgrade caddy
caddy version
systemctl status caddy --no-pagerНе используйте caddy upgrade для такой установки: эта экспериментальная команда напрямую заменяет двоичный файл, которым управляет пакет.
Резервное копирование и восстановление
Нужно сохранять два расположения:
| Путь | Содержимое |
|---|---|
/etc/caddy/ |
Caddyfile и импортируемые файлы |
/var/lib/caddy/.local/share/caddy/ |
Сертификаты, закрытые ключи и учётные записи ACME |
sudo tar -czf /root/caddy-$(date +%F).tar.gz /etc/caddy /var/lib/caddy/.local/share/caddy
sudo chmod 600 /root/caddy-$(date +%F).tar.gzЭтот архив содержит закрытые ключи: скопируйте его за пределы сервера в зашифрованное хранилище. Каталог данных — это не кэш. Если сохранить его, не придётся заново запрашивать все сертификаты и упираться в лимиты центра сертификации.
Чтобы восстановить архив на сервере, где установлен Caddy, подставьте вместо ГГГГ-ММ-ДД его дату:
sudo systemctl stop caddy
sudo tar -xzf /root/caddy-ГГГГ-ММ-ДД.tar.gz -C /
sudo chown -R caddy:caddy /var/lib/caddy
sudo systemctl start caddyЕсли что-то пошло не так
listen tcp :80: bind: address already in use
Другая служба занимает порт 80 или 443:
sudo ss -ltnp | grep -E ':(80|443) 'Остановите и отключите эту службу, если она больше не нужна, например командой sudo systemctl disable --now nginx.
urn:ietf:params:acme:error:dns или NXDOMAIN
Имя ещё не существует в DNS, либо распространение записей не завершено. Проверьте это командой dig +short A app.ваш-домен.com. Caddy повторяет попытки самостоятельно: перезапускать его в цикле не нужно.
urn:ietf:params:acme:error:unauthorized или urn:ietf:params:acme:error:connection
Центр сертификации не смог подключиться к этому серверу. Проверьте записи A и AAAA, а затем правила брандмауэра для портов 80 и 443. Если на сервере всё настроено верно, а порт остаётся недоступным извне, обратитесь в поддержку из вашего личного кабинета.
urn:ietf:params:acme:error:caa
Запись CAA домена запрещает используемый центр сертификации. Добавьте в неё нужный центр: letsencrypt.org для Let’s Encrypt, либо удалите это ограничение.
urn:ietf:params:acme:error:rateLimited
Для этого домена отправлено слишком много запросов. Дождитесь окончания периода, указанного в сообщении. Для тестов используйте тестовое окружение Let’s Encrypt, сертификаты которого не распознаются браузерами, и затем удалите эту строку:
{
acme_ca https://acme-staging-v02.api.letsencrypt.org/directory
}tlsv1 alert internal error в браузере или в curl
У Caddy ещё нет сертификата для этого имени. Найдите причину в журналах:
sudo journalctl -u caddy --no-pager -n 100 | grep -iE 'error|acme|challenge'Ошибка 502 и connect: connection refused
Caddy не может подключиться к приложению. Убедитесь, что оно работает и слушает адрес, указанный в reverse_proxy:
curl -I http://127.0.0.1:3000
sudo ss -ltnp | grep 3000Цикл перенаправлений
Приложение принудительно включает HTTPS, не распознавая заголовок X-Forwarded-Proto. Включите в приложении параметр «trust proxy» или его аналог. Если домен также работает через прокси Cloudflare, установите режим SSL/TLS Full (strict): режим Flexible вызывает такой цикл.
localhost:2019 и connection refused при перезагрузке
Служба остановлена, либо API администрирования отключён. Проверьте её состояние, устраните указанную ошибку и запустите службу:
systemctl status caddy --no-pager
sudo systemctl start caddyopen /var/log/...: permission denied
Caddy работает от имени пользователя caddy и не может писать куда угодно. Записывайте журналы в /var/log/caddy/.