Создание автоподдоменов в ISPmanager

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

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

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

Зайдите в раздел ДоменыWWW-домены. Создайте новый домен или откройте настройки существующего. В настройках нажмите кнопку Показать скрытые поля.

В блоке «Дополнительные возможности» включите функцию Автоподдоменов.

Доступны два варианта:

В поддиректории домена. Файлы поддомена будут доступны из основного домена.
Пример размещения файлов: www/example.com/domain
Поддомен доступен по адресу: example.com/domain

В отдельной директории. Файлы поддомена располагаются в отдельной папке и недоступны из основного домена.
Пример размещения файлов: www/domain.example.com
Поддомен доступен по адресу: domain.example.com

Частые вопросы при работе с автоподдоменами

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

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

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

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

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

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

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

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

Не работает домен 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 из указанной директории.

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

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

  • в отдельной директории: VirtualDocumentRoot /home/username/data/www/%0
  • в поддиректории домена: VirtualDocumentRoot /home/username/data/www/example.com/%1

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