Модуль Apache mod_vhost_alias

Краткое описание

Этот модуль создаёт динамически настраиваемые виртуальные хосты, позволяя использовать IP-адрес и/или заголовок Host: HTTP-запроса как часть пути для определения файлов, которые следует предоставлять. Это позволяет легко использовать огромное количество виртуальных хостов с похожими конфигурациями.

ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/"
VirtualScriptAlias "/never/found/%0/cgi-bin/"

Подстановка в имена каталогов

Все директивы этого модуля подставляют строку в путь. Подставляемая строка (далее — «имя») может быть именем сервера (подробные сведения о том, как оно определяется, см. в директиве UseCanonicalName) или IP-адресом виртуального хоста на сервере в формате с точками. Подстановка выполняется с помощью спецификаторов, вдохновлённых printf, которые имеют несколько форматов:

N и M используются для указания подстрок имени. N выбирает компоненты имени, разделённые точками, а M выбирает символы внутри той части, которую выбрал N. M необязателен и по умолчанию равен нулю, если не указан; точка должна присутствовать тогда и только тогда, когда присутствует M. Значения интерпретируются следующим образом:

Если значение N или M превышает количество доступных частей, подставляется одиночное подчёркивание.

Примеры

Для простых виртуальных хостов, основанных на имени, в файле конфигурации сервера можно использовать следующие директивы:

UseCanonicalName    Off
VirtualDocumentRoot "/usr/local/apache/vhosts/%0"

Запрос http://www.example.com/directory/file.html будет обработан с использованием файла /usr/local/apache/vhosts/www.example.com/directory/file.html.

Если виртуальных хостов очень много, рекомендуется организовать файлы так, чтобы уменьшить размер каталога vhosts. Для этого в файле конфигурации можно использовать следующее:

UseCanonicalName    Off
VirtualDocumentRoot "/usr/local/apache/vhosts/%3+/%2.1/%2.2/%2.3/%2"

Запрос http://www.domain.example.com/directory/file.html будет обработан с использованием файла /usr/local/apache/vhosts/example.com/d/o/m/domain/directory/file.html.

Более равномерного распределения файлов можно добиться, выполняя хеширование имени с конца, например:

VirtualDocumentRoot "/usr/local/apache/vhosts/%3+/%2.-1/%2.-2/%2.-3/%2"

Примерный запрос поступил бы с /usr/local/apache/vhosts/example.com/n/i/a/domain/directory/file.html.

В качестве альтернативы можно использовать:

VirtualDocumentRoot "/usr/local/apache/vhosts/%3+/%2.1/%2.2/%2.3/%2.4+"

Примерный запрос поступил бы с /usr/local/apache/vhosts/example.com/d/o/m/ain/directory/file.html.

Пользователи часто хотят направлять несколько доменов в несколько корневых каталогов документов, не беспокоясь о длине имени хоста или количестве его частей. Если запрошенное имя хоста — sub.www.domain.example.com, а не просто www.domain.example.com, то использование %3+ приведёт к тому, что корневым каталогом документов станет /usr/local/apache/vhosts/domain.example.com/... вместо предполагаемого каталога example.com. В таких случаях может быть полезно сочетание %-2.0.%-1.0, которое всегда возвращает доменное имя и домен верхнего уровня, например example.com, независимо от количества поддоменов, добавленных к имени хоста. Таким образом можно создать конфигурацию, которая будет направлять все поддомены первого, второго или третьего уровня в один и тот же каталог:

VirtualDocumentRoot "/usr/local/apache/vhosts/%-2.0.%-1.0"

В приведённом выше примере и www.example.com, и www.sub.example.com, и example.com будут указывать на /usr/local/apache/vhosts/example.com.

Для виртуальных хостов, основанных на IP-адресе, в файле конфигурации можно использовать следующее:

UseCanonicalName DNS
VirtualDocumentRootIP "/usr/local/apache/vhosts/%1/%2/%3/%4/docs"
VirtualScriptAliasIP  "/usr/local/apache/vhosts/%1/%2/%3/%4/cgi-bin"

Запрос http://www.domain.example.com/directory/file.html будет обработан с использованием файла /usr/local/apache/vhosts/10/20/30/40/docs/directory/file.html, если IP-адрес www.domain.example.com равен 10.20.30.40. Запрос http://www.domain.example.com/cgi-bin/script.pl будет обработан запуском программы /usr/local/apache/vhosts/10/20/30/40/cgi-bin/script.pl.

Если директива VirtualDocumentRoot должна содержать символ ., но он конфликтует с директивой %, проблему можно обойти следующим образом:

VirtualDocumentRoot "/usr/local/apache/vhosts/%2.0.%3.0"

Запрос http://www.domain.example.com/directory/file.html будет обработан с использованием файла /usr/local/apache/vhosts/domain.example/directory/file.html.

Директивы LogFormat %V и %A полезно использовать вместе с этим модулем.

VirtualDocumentRoot interpolated-directory|none

VirtualDocumentRoot none

VirtualDocumentRootIP interpolated-directory|none

VirtualDocumentRootIP none

VirtualScriptAlias interpolated-directory|none

VirtualScriptAlias none

VirtualScriptAliasIP interpolated-directory|none

VirtualScriptAliasIP none