корень

Устанавливает корневой путь сайта, используемый различными сопоставителями и директивами, которые обращаются к файловой системе. Если не задано, по умолчанию корень сайта — текущий рабочий каталог.

Конкретно, эта директива устанавливает {http.vars.root} placeholder. Она взаимно исключает другие root директивы в том же блоке, поэтому безопасно определять несколько корней с сопоставителями, которые пересекаются: они не будут переходить друг другу и перезаписывать друг друга.

Эта директива не включает автоматическое предоставление статических файлов, поэтому ее часто используют в сочетании с file_server директивой или php_fastcgi директивой.

Синтаксис

root [<matcher>] <path>

• <path> — путь для использования в качестве корневого каталога сайта.

До версии v2.8.0, аргумент <path> мог быть ошибочно интерпретирован парсером как токен сопоставителя, если он начинался с /, поэтому необходимо было указать токен сопоставителя с подстановочными символами (*).

Примеры

Установите корневой путь сайта в /home/bob/public_html (предполагается, что Caddy запущен как пользователь bob):

root * /home/bob/public_html

Установите корневой путь сайта в public_html (относительно текущего рабочего каталога) для всех запросов:

root public_html

Изменить корневой путь сайта только для запросов в /foo/*:

root /foo/* /home/user/public_html/foo

Директива root обычно используется совместно с file_server для предоставления статических файлов и/или с php_fastcgi для предоставления сайта PHP:

example.com {
	root * /srv
	file_server
}