RU

Приложения

Caddy как обратный прокси с автоматическим HTTPS

Установка Caddy на Debian или Ubuntu из официального репозитория, публикация приложения с автоматическим HTTPS, защита интерфейса администрирования, обновление и резервное копирование.

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

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

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

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

Это руководство объясняет, как поставить 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

Замените его содержимое на следующее:

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.ваш-домен.com

HTTP-запрос должен вернуть перенаправление 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:

caddyfile
app.ваш-домен.com {
	encode zstd gzip
	reverse_proxy 127.0.0.1:3000
}

Файл /etc/caddy/Caddyfile теперь содержит только глобальные параметры и импорт:

caddyfile
{
	email admin@ваш-домен.com
}

import sites/*.caddy

Снова проверьте и перезагрузите конфигурацию, как на шаге 5.

Защита интерфейса администрирования

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

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

Терминал
caddy hash-password

Затем добавьте этот сайт, заменив BCRYPT_HASH полученным хешем:

caddyfile
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.

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

Распределение нагрузки между несколькими экземплярами

caddyfile
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

caddyfile
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} сохраняет публичное имя для приложений, которым оно необходимо.

Запись журнала доступа в файл

caddyfile
app.ваш-домен.com {
	log {
		output file /var/log/caddy/app.log
	}
	reverse_proxy 127.0.0.1:3000
}

Пакет создаёт /var/log/caddy для пользователя caddy. Храните журналы в этом каталоге, чтобы избежать ошибок прав доступа.

Caddy за другим прокси

Если посетителей принимает другой прокси, расположенный перед Caddy, укажите его адрес в глобальных параметрах. Без этого Caddy не учитывает адрес клиента, который передаёт ему этот прокси.

caddyfile
{
	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, сертификаты которого не распознаются браузерами, и затем удалите эту строку:

caddyfile
{
	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 caddy

open /var/log/...: permission denied

Caddy работает от имени пользователя caddy и не может писать куда угодно. Записывайте журналы в /var/log/caddy/.

Ссылки