Панель управления 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 необходимо, чтобы он был подключен в его конфигурации, также возможно использование опции ForceAutoSubdomain в файле конфигурации панели управления.
При включении авто поддомена через ISPmanager в конфигурацию соответствующего виртуального хоста прописывается записи
VirtualDocumentRoot /home/username/data/www/%0 для работы поддоменов "в отдельной директории" или
VirtualDocumentRoot /home/username/data/www/example.com/%1 Для работы поддоменов "в поддиректории WWW домена"
Также вносится wildcard записи *.example.com в директиву ServerAlias и запись * тип A в конфигурацию DNS для выбранного домена указывающую на IP-адрес домена.
Тем самым обеспечивается их работа.
Частые вопросы возникающие при работе с автоподдоменами
В каком каталоге должны быть размещены файлы авто поддомена?
Это зависит от выбора режима работы авто поддоменов. Файлы следует размещать в папке либо www/полное.имя.домена, либо в папке www/имя.домена/имя
Автоподдомены после включения не работают, домен не доступен в DNS
Необходимо некоторое время для обновления кэша DNS (до 24-48 часов), также необходимо, чтобы домен был делегирован на те же сервера имен, которые используются в ISPmanager.
При включении авто поддоменов перестали работать другие поддомены для этого домена, выдают "ошибку 404"
После включения авто поддомена прописывается запись *.example.com в конфигурацию apache для выбранного домена, и соответственно, все запросы попадают на этот домен. Для решения этой проблемы можно в поле Псевдонимы прописать только те записи, которые нужны.
Записи в DNS указывающие на другие IP-адреса перестали работать
Wildcard запись * в конфигурации DNS (в меню Доменные имена) имеет более высокий приоритет над другими записями. В таком случае следует либо не использовать автоподдомены, либо прописывать все записи типа A в DNS вручную. Подобный эффект может проявляться не всегда.
Не работает домен (поддомен) 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, например:
# ln -s domain www.domain
# ln -s . www
Создаст символические ссылки c префиксом www из указанной директории.