Модуль 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