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

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

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

Поддомены создаются при создании директорий в соответствующих каталогах, имя директории зависит от настроек.

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

Для включения авто поддоменов в ISPmanager зайдите в меню WWW домены и затем в свойствах выбранного WWW домена выберите в списке Авто поддомены опцию работы данной функции:

"В отдельной директории" - файлы поддоменов не будут доступны из основного домена, необходимо их создавать в папках соответствующих имени поддомена в домашней директории пользователя владельца в каталоге www, например:

• домен example.com расположен в папке www/example.com
• существует необходимость в создании домена domain.example.com

Для работы такой конфигурации файлы поддомена необходимо разместить в каталоге www/domain.example.com

"В поддиректории WWW домена" - файлы поддоменов будут доступны из основного домена, необходимо создавать их в папках соответствующих имени поддомена в домашней директории пользователя владельца в каталоге www/example.com, например:

• домен example.com расположен в папке www/example.com
• существует необходимость в создании домена domain.example.com

Для работы такой конфигурации файлы поддомена необходимо разместить в каталоге www/example.com/domain. При этом данные будут доступны также по адресу example.com/domain

Технические подробности работы авто поддоменов

Для использования автоматических поддоменов применяется модуль веб-сервера Apache mod_vhost_alias.

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

VirtualDocumentRoot /var/www/username/data/www/%0

для работы поддоменов "в отдельной директории" или

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

Для работы поддоменов "в поддиректории WWW домена"

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

Тем самым обеспечивается их работа.

Частые вопросы возникающие при работе с авто поддоменами

В этой главе рассмотрены наиболее частые вопросы, которые могут возникать у пользователей при использовании функции автоматического создания поддоменов в панели управления ISPmanager.

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

Это зависит от выбора режима работы авто поддоменов. Файлы следует размещать в папке либо www/полное.имя.домена, либо в папке www/имя.домена/имя

Авто поддомены после включения не работают, домен не доступен в DNS

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

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

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

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

Для работы таких доменов должны быть созданы символические ссылки (symlink) в директории зависящей от конфигурации.

В случае если используется конфигурация "В отдельной директории", то в symlink должен существовать в каталоге www, например:

lrwxr-xr-x 1 root user 13 25 сен 22:32 www.example.com -> example.com
lrwxr-xr-x 1 root user 13 25 сен 22:32 www.domain.example.com -> domain.example.com

В случае если используется конфигурация в "в поддиректории WWW домена", то символическая ссылка должна находиться в директории в которой находится домен и иметь вид

lrwxr-xr-x 1 root user 13 25 сен 22:32 www -> .
lrwxr-xr-x 1 root user 13 25 сен 22:32 www.domain -> domain

Как создать символическую ссылку (symlink)?

Для создания symlink следует воспользоваться командой ln -s, зайдя по ssh на сервер:

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

Эти команды создадут символические ссылки c префиксом www из указанной директории.