Поиск
Справочник

VirtualHost в Apache: как описать сайт — домен, папка с файлами, журналы

VirtualHost — блок в настройках Apache, который описывает один сайт: домен, папку с файлами и журналы. На одном сервере может быть сколько угодно таких блоков, и Apache выбирает нужный по домену из запроса. Здесь — как написать файл сайта, как Apache выбирает сайт и как проверить, что всё подключено.

≈ 6 мин чтения5 шагов
Содержание 8

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите, какие сайты знает Apache:
    sudo apache2ctl -S

    В ответе — каждый сайт, его домен и файл, в котором он описан. Как читать ответ — ниже.

  3. Чтобы добавить сайт, пройдите шаги из раздела Как создать сайт.

Как выглядит файл сайта

Каждый сайт — отдельный файл в папке /etc/apache2/sites-available/. Файл для домена example.ru:

<VirtualHost *:80>
    ServerName example.ru
    ServerAlias www.example.ru
    DocumentRoot /var/www/example.ru

    ErrorLog ${APACHE_LOG_DIR}/example.ru-error.log
    CustomLog ${APACHE_LOG_DIR}/example.ru-access.log combined
</VirtualHost>
СтрокаЧто значит
<VirtualHost *:80>начало сайта: запросы на порт 80 на любой адрес сервера
ServerName example.ruглавный домен сайта
ServerAlias www.example.ruдругие домены этого же сайта, через пробел
DocumentRoot /var/www/example.ruпапка с файлами сайта: запрос example.ru/about.html Apache ищет в /var/www/example.ru/about.html
ErrorLogжурнал ошибок этого сайта
CustomLog … combinedжурнал запросов этого сайта; combined — формат строки (журналы)
</VirtualHost>конец сайта

${APACHE_LOG_DIR} Apache заменяет на /var/log/apache2 — это записано в файле /etc/apache2/envvars. Строки ErrorLog и CustomLog можно не писать: тогда ошибки пойдут в общий /var/log/apache2/error.log, а запросы — в other_vhosts_access.log.

Отступы внутри блока Apache не читает, они нужны только для удобства.

Как создать сайт

Вместо example.ru везде пишите свой домен.

Шаг 1. Создайте папку и страницу

sudo mkdir -p /var/www/example.ru
echo 'example.ru OK' | sudo tee /var/www/example.ru/index.html

Шаг 2. Создайте файл сайта

sudo nano /etc/apache2/sites-available/example.ru.conf

Вставьте блок из раздела Как выглядит файл сайта со своим доменом. Сохраните: Ctrl+O, Enter, затем Ctrl+X (как работать в nano).

Имя файла должно заканчиваться на .conf: файлы с другим окончанием Apache не подключит.

Шаг 3. Включите сайт и проверьте настройки

sudo a2ensite example.ru
sudo apache2ctl configtest

Ответ первой команды — Enabling site example.ru., второй — Syntax OK.

Шаг 4. Примените

sudo systemctl reload apache2

Шаг 5. Проверьте

Откройте в браузере http://example.ru. Должна появиться строка example.ru OK. Если домен ещё не направлен на сервер, проверьте с самого сервера:

curl -H 'Host: example.ru' http://127.0.0.1/

Ответ — example.ru OK.

Для HTTPS нужен второй блок — <VirtualHost *:443> с сертификатом. Его создаёт Certbot (Certbot для Apache).

Какой сайт откроется

На каждый запрос Apache выбирает один сайт:

  1. Берёт адрес и порт, на которые пришёл запрос, например порт 80.
  2. Среди сайтов для этого порта ищет тот, у которого ServerName или ServerAlias совпадает с доменом из запроса.
  3. Если совпадений нет, отдаёт первый сайт для этого порта.

Первым считается сайт, который Apache прочитал раньше. Файлы из sites-enabled он читает по алфавиту, поэтому первым идёт 000-default.conf — стартовая страница Apache. Из-за этого:

ЗапросЧто откроется
домен, который есть в ServerName или ServerAliasваш сайт
www.example.ru, а в файле только ServerName example.ruстартовая страница Apache: добавьте ServerAlias www.example.ru
IP-адрес серверастартовая страница Apache
чужой домен, направленный на ваш серверстартовая страница Apache

Если выключить 000-default.conf, первым станет ваш сайт, который идёт раньше других по алфавиту. Тогда он будет открываться и по IP-адресу, и по любому чужому домену, направленному на сервер. Если такое не нужно, оставьте 000-default.conf включённым.

Если два сайта указали один и тот же домен, откроется тот, что прочитан раньше.

Как проверить сайты: apache2ctl -S

sudo apache2ctl -S

Если сайтов для порта несколько, ответ такой:

VirtualHost configuration:
*:80                   is a NameVirtualHost
         default server vps-name (/etc/apache2/sites-enabled/000-default.conf:1)
         port 80 namevhost vps-name (/etc/apache2/sites-enabled/000-default.conf:1)
         port 80 namevhost example.ru (/etc/apache2/sites-enabled/example.ru.conf:1)
                 alias www.example.ru
СтрокаЧто значит
*:80 is a NameVirtualHostна порт 80 несколько сайтов, Apache выбирает их по домену
default server … (файл:строка)сайт, который открывается, если домен не совпал ни с одним сайтом
port 80 namevhost домен (файл:строка)сайт: его ServerName, файл и номер строки, где начинается блок
aliasдомен из ServerAlias

vps-name — имя самого сервера или его адрес, у вас будет своё: у 000-default.conf нет своего ServerName, и Apache подставляет имя сервера.

Если сайт на порту один, ответ короче: *:80 и через пробелы — домен и файл.

Ниже в ответе — общие пути Apache: ServerRoot, Main DocumentRoot, Main ErrorLog и другие. Для проверки сайтов они не нужны.

Если в настройках ошибка, вместо списка сайтов Apache напишет её: файл, номер строки и что не так.

Ошибки и как их исправить

Что видитеПричинаЧто делать
по домену открывается стартовая страница Apacheсайт не включён или домен не совпадает с ServerName и ServerAliassudo apache2ctl -S: есть ли сайт и его домен; стартовая страница вместо сайта
по домену с www открывается другой сайтнет ServerAlias www.example.ruдобавьте строку, sudo apache2ctl configtest и sudo systemctl reload apache2
AH00112: Warning: DocumentRoot [/var/www/example.ru] does not existнет папки из DocumentRootсоздайте её: sudo mkdir -p /var/www/example.ru (AH00112)
сайт отвечает 403Apache не пускает в папку сайтаAH01630: client denied
AH00558 перед Syntax OKу сервера нет полного именина работу сайтов не влияет; как убрать
ERROR: Site example.ru does not exist!нет файла /etc/apache2/sites-available/example.ru.confпроверьте имя файла: ls /etc/apache2/sites-available/
после a2ensite сайт не изменилсяне было reloadsudo systemctl reload apache2

Всё сверено с Apache 2.4.58 из пакета Ubuntu 24.04.

Источники

Сверено 9 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше