Автоподдомены в ISPmanager

ISPmanager позволяет автоматически создавать поддомены для существующего домена — без ручных изменений в конфигурации. Поддомен появляется сам, как только вы создаёте соответствующую директорию в нужном каталоге.

Включение автоподдоменов

Перейдите в меню WWW-домены, откройте свойства нужного домена и в разделе Авто поддомены выберите режим работы.

Режим «В отдельной директории»

Файлы поддомена размещаются в отдельной папке и не пересекаются с файлами основного домена.

Пример:

• Основной домен example.com расположен в www/example.com
• Нужно создать поддомен domain.example.com

Разместите файлы поддомена в каталоге:

www/domain.example.com

Режим «В поддиректории WWW-домена»

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

Пример:

• Основной домен example.com расположен в www/example.com
• Нужно создать поддомен domain.example.com

Разместите файлы поддомена в каталоге:

www/example.com/domain

При этом файлы будут доступны и по адресу example.com/domain.

Технические подробности

Для работы автоподдоменов используется модуль Apache mod_vhost_alias. Он должен быть подключён в конфигурации ISPmanager. Также доступна опция ForceAutoSubdomain в конфигурационном файле панели.

При включении автоподдоменов ISPmanager автоматически вносит следующие изменения:

• Для режима «В отдельной директории» в конфигурацию виртуального хоста добавляется:

  VirtualDocumentRoot /home/username/data/www/%0

• Для режима «В поддиректории WWW-домена»:

  VirtualDocumentRoot /home/username/data/www/example.com/%1

• В директиву ServerAlias добавляется wildcard-запись *.example.com
• В конфигурацию DNS для выбранного домена добавляется запись типа A с символом *, указывающая на IP-адрес домена

Часто задаваемые вопросы

В каком каталоге размещать файлы автоподдомена?

Зависит от выбранного режима:

• «В отдельной директории» → www/полное.имя.домена
• «В поддиректории WWW-домена» → www/имя.домена/имя-поддомена

Автоподдомены включены, но домен недоступен в DNS

Необходимо подождать обновления кэша DNS — это может занять до 24–48 часов. Также убедитесь, что домен делегирован на те же серверы имён, которые используются в ISPmanager.

После включения автоподдоменов другие поддомены стали выдавать ошибку 404

При включении автоподдоменов в конфигурацию Apache добавляется wildcard-запись *.example.com, и все запросы начинают попадать на этот домен. Чтобы исправить ситуацию, в поле Псевдонимы укажите явно только те поддомены, которые действительно нужны.

Записи DNS, указывающие на другие IP-адреса, перестали работать

Wildcard-запись * в конфигурации DNS имеет более высокий приоритет над остальными записями. В этом случае либо откажитесь от автоподдоменов, либо прописывайте все нужные записи типа A в DNS вручную.

Не работает домен с префиксом www (например, www.example.com или www.domain.example.com)

Для таких доменов необходимо создать символические ссылки (symlink).

Для режима «В отдельной директории» ссылки создаются в каталоге www:

lrwxr-xr-x  www.example.com -> example.com
lrwxr-xr-x  www.domain.example.com -> domain.example.com

Для режима «В поддиректории WWW-домена» ссылки создаются внутри директории домена:

lrwxr-xr-x  www -> .
lrwxr-xr-x  www.domain -> domain

Создать символическую ссылку можно командой ln -s:

ln -s domain www.domain
ln -s . www