VirtualHost в Apache: как описать сайт — домен, папка с файлами, журналы
VirtualHost — блок в настройках Apache, который описывает один сайт: домен, папку с файлами и журналы. На одном сервере может быть сколько угодно таких блоков, и Apache выбирает нужный по домену из запроса. Здесь — как написать файл сайта, как Apache выбирает сайт и как проверить, что всё подключено.
Содержание 8
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите, какие сайты знает Apache:
sudo apache2ctl -SВ ответе — каждый сайт, его домен и файл, в котором он описан. Как читать ответ — ниже.
- Чтобы добавить сайт, пройдите шаги из раздела Как создать сайт.
Как выглядит файл сайта
Каждый сайт — отдельный файл в папке /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 выбирает один сайт:
- Берёт адрес и порт, на которые пришёл запрос, например порт 80.
- Среди сайтов для этого порта ищет тот, у которого
ServerNameилиServerAliasсовпадает с доменом из запроса. - Если совпадений нет, отдаёт первый сайт для этого порта.
Первым считается сайт, который 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 и ServerAlias | sudo 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) |
| сайт отвечает 403 | Apache не пускает в папку сайта | 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 сайт не изменился | не было reload | sudo systemctl reload apache2 |
Всё сверено с Apache 2.4.58 из пакета Ubuntu 24.04.
Источники
- Сайты по именам в документации Apache — на английском: как Apache выбирает сайт по домену и какой сайт открывается, если домен не совпал.
- Директивы ServerName, ServerAlias, DocumentRoot и VirtualHost — на английском: справка по каждой строке файла сайта.
- Исходный код Apache 2.4.58: vhost.c — выбор сайта и ответ
apache2ctl -S. - Пакет apache2 в Ubuntu 24.04: файлы настроек —
000-default.conf,envvarsи подключениеsites-enabled.
Сверено 9 ноября 2026 года.
Что почитать дальше
- a2ensite и a2dissiteвключение и выключение сайтов.
- Directory и AllowOverrideдоступ к папке сайта и .htaccess.
- Настройки Apacheвсе настройки на одной странице.