Spec-Zone.ru › Caddy

Быстрый старт Caddyfile

Создайте новый текстовый файл с именем Caddyfile (без расширения).

Первым делом в Caddyfile нужно указать адрес вашего сайта:

localhost

Если порты HTTP и HTTPS (соответственно 80 и 443) являются привилегированными портами вашей ОС, вам потребуется запустить Caddy с повышенными привилегиями или использовать более высокие порты. Чтобы получить разрешение, запустите его как root с помощью sudo -E или используйте sudo setcap cap_net_bind_service=+ep $(which caddy). В качестве альтернативы, для использования более высоких портов, просто измените адрес на что-то вроде localhost:2080 и измените порт HTTP с помощью опции http_port в Caddyfile.

Затем нажмите Enter и введите то, что вы хотите, чтобы он делал, чтобы это выглядело так:

localhostrespond "Hello, world!"

Сохраните его и запустите Caddy из той же папки, что и ваш Caddyfile:

caddy start

Вероятно, вам потребуется ввести пароль, потому что Caddy по умолчанию обслуживает все сайты — даже локальные — через HTTPS. (Запрос пароля должен произойти только в первый раз!)

Для локального HTTPS Caddy автоматически генерирует сертификаты и уникальные закрытые ключи для вас. Корневой сертификат добавляется в хранилище доверенных сертификатов вашей системы, поэтому запрос пароля необходим. Это позволяет вам разрабатывать локально через HTTPS без ошибок сертификата.

(Если у вас возникают ошибки разрешения, вам может потребоваться запустить Caddy с повышенными привилегиями или выбрать порт выше 1023.)

Либо откройте свой браузер в localhost, либо curl его:

curl https://localhost
Hello, world!

Вы можете определять несколько сайтов в Caddyfile, обернув их в фигурные скобки { }. Измените ваш Caddyfile на:

localhost {
	respond "Hello, world!"
}
localhost:2016 {
	respond "Goodbye, world!"
}

Вы можете предоставить Caddy обновлённую конфигурацию двумя способами: либо непосредственно через API:

curl localhost:2019/load \
	-H "Content-Type: text/caddyfile" \
	--data-binary @Caddyfile

или с помощью команды reload, которая выполняет тот же запрос к API за вас:

caddy reload

Попробуйте ваш новый "goodbye" endpoint в вашем браузере или с помощью curl, чтобы убедиться, что он работает:

curl https://localhost:2016
Goodbye, world!

Когда вы закончите работу с Caddy, убедитесь, что остановили его:

caddy stop

Дополнительные материалы

  • Концепции Caddyfile
  • Директивы
  • Общие шаблоны

© 2015-2025 Matthew Holt and The Caddy Authors
Licensed under the Apache License 2.0.
Caddy is a registered trademark of Stack Holdings GmbH.
https://caddyserver.com/docs/quick-starts/caddyfile

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API