Настройки Apache: где лежат файлы и какая команда за что отвечает
Apache в Ubuntu хранит настройки в папке /etc/apache2: общий файл, файлы сайтов, модулей и дополнительных настроек. Сайты, модули и настройки включают не правкой файлов, а командами a2ensite, a2enmod и a2enconf. Здесь — какой файл за что отвечает, как проверить настройки перед перезапуском и ссылки на разбор каждой настройки.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Проверьте версию Apache:
apache2ctl -vСтрока
Server version: Apache/2.4.58 (Ubuntu)— версия из Ubuntu 24.04. Всё на этой странице сверено с ней. Если ответа нет, Apache не установлен — как установить. - Проверьте настройки:
sudo apache2ctl configtestВ конце ответа должно быть
Syntax OK. - Найдите в таблице ниже то, что хотите поменять, и откройте разбор.
Что где настраивается
| Что нужно | Где разбор |
|---|---|
| описать сайт: домен, папку с файлами | VirtualHost |
| включить или выключить сайт | a2ensite и a2dissite |
| включить модуль, например rewrite | a2enmod и a2dismod |
| включить дополнительные настройки из conf-available | a2enconf и a2disconf |
| разрешить .htaccess, открыть или закрыть папку | Directory и AllowOverride |
| сменить порт | ports.conf и Listen |
| найти журналы, сделать отдельный журнал для сайта | журналы Apache |
| проверить настройки, посмотреть сайты и модули | apache2ctl |
| скрыть версию Apache из ответов | security.conf |
| понять, что такое event и prefork, и выдержит ли сервер посетителей | MPM в Apache |
| время ожидания и KeepAlive | Timeout и KeepAlive |
| получить сертификат и включить HTTPS | Certbot для Apache |
Файлы в /etc/apache2
| Файл или папка | Что в нём |
|---|---|
apache2.conf | общие настройки: время ожидания, журнал ошибок, доступ к папкам, подключение остальных файлов |
ports.conf | на каких портах Apache принимает запросы: Listen 80, а при включённом модуле ssl — и Listen 443 |
envvars | пользователь, от которого работает Apache, — www-data, и папка журналов /var/log/apache2 |
sites-available/ | файлы сайтов: 000-default.conf, default-ssl.conf и ваши |
sites-enabled/ | ссылки на включённые сайты |
mods-available/ | модули: файл .load загружает модуль, файл .conf — его настройки |
mods-enabled/ | ссылки на включённые модули |
conf-available/ | дополнительные настройки: security.conf, charset.conf и другие |
conf-enabled/ | ссылки на включённые дополнительные настройки |
Посмотреть, что лежит в папке, — команда ls:
ls /etc/apache2/sites-enabled/Сразу после установки ответ — 000-default.conf: включена только стартовая страница Apache.
Как устроены папки available и enabled
Apache читает только папки sites-enabled, mods-enabled и conf-enabled. В них лежат не сами файлы, а ссылки на файлы из папок -available. Включить сайт, модуль или настройку — значит создать ссылку, выключить — удалить её. Сам файл при этом остаётся на месте.
Ссылки создают и удаляют командами:
| Что | Включить | Выключить | Что выполнить после |
|---|---|---|---|
| сайт | sudo a2ensite example.ru | sudo a2dissite example.ru | sudo systemctl reload apache2 |
| модуль | sudo a2enmod rewrite | sudo a2dismod rewrite | sudo systemctl restart apache2 |
| дополнительная настройка | sudo a2enconf security | sudo a2disconf security | sudo systemctl reload apache2 |
Имя пишут без .conf и .load: для файла example.ru.conf — a2ensite example.ru. Какую команду выполнить после, команды подсказывают сами:
To activate the new configuration, you need to run:
systemctl reload apache2Свои файлы кладите в папки -available, а в -enabled ничего не создавайте руками. Так видно, что включено, и выключить что-то можно одной командой, ничего не удаляя.
В каком порядке Apache читает настройки
Apache начинает с файла apache2.conf, а из него подключает остальные:
- модули — файлы
.loadи.confизmods-enabled; - порты —
ports.conf; - общие настройки самого
apache2.conf: доступ к папкам, формат журналов; - дополнительные настройки — файлы из
conf-enabled; - сайты — файлы из
sites-enabled.
Файлы из одной папки Apache читает по алфавиту. Это важно для сайтов: первым читается 000-default.conf, и запросы, которые не подошли ни к одному сайту, Apache отдаёт первому прочитанному сайту (подробнее).
Если вы хотите поменять настройку, которая уже где-то записана, меняйте её в том же файле. Найти, где она стоит, поможет grep:
grep -rn 'ServerTokens' /etc/apache2/В ответе — файл и номер строки. Строки, которые начинаются с #, — комментарии: Apache их не читает.
Как проверить и применить настройки
- Проверьте настройки:
sudo apache2ctl configtestОтвет
Syntax OK— ошибок нет. Если ошибка есть, Apache напишет файл, номер строки и что ему не понравилось. Исправьте строку и проверьте снова. - Примените:
sudo systemctl reload apache2
| Команда | Что делает | Когда нужна |
|---|---|---|
sudo systemctl reload apache2 | перечитывает настройки, не обрывая открытые подключения | после правки файлов сайтов и включения сайтов и дополнительных настроек |
sudo systemctl restart apache2 | останавливает Apache и запускает заново | после включения и выключения модулей |
reload сначала проверяет настройки. Если в них ошибка, Apache продолжает работать со старыми настройками, а команда завершится ошибкой. restart сначала останавливает Apache: если в настройках ошибка, он не запустится, и все сайты на сервере перестанут открываться. Поэтому перед restart проверяйте настройки командой configtest.
Перед Syntax OK может стоять строка с кодом AH00558. Это предупреждение: Apache не смог узнать полное имя сервера. Работе сайтов оно не мешает, как его убрать — AH00558.
Где журналы
| Журнал | Где |
|---|---|
| ошибки | /var/log/apache2/error.log |
| запросы к сайтам | /var/log/apache2/access.log |
| запросы к сайтам без своего журнала | /var/log/apache2/other_vhosts_access.log |
| запуск и остановка службы | sudo journalctl -u apache2 |
Последние строки журнала ошибок:
sudo tail -n 20 /var/log/apache2/error.logКак читать журналы и как сделать отдельный журнал для каждого сайта — журналы Apache.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
вместо Syntax OK — сообщение с файлом и номером строки | ошибка в этой строке | исправьте её и выполните sudo apache2ctl configtest снова; что значат сообщения |
Action 'configtest' failed. | в настройках ошибка, её текст — строкой выше | исправьте файл из сообщения |
ERROR: Site example.ru does not exist! | в sites-available нет файла example.ru.conf | ls /etc/apache2/sites-available/ и проверьте имя (a2ensite) |
после restart все сайты не открываются | Apache не запустился из-за ошибки в настройках | sudo apache2ctl configtest, исправьте ошибку и sudo systemctl start apache2 (служба не запускается) |
| по домену открывается стартовая страница Apache | сайт не включён или в нём нет ServerName с этим доменом | стартовая страница вместо сайта |
| правка в файле ничего не изменила | файл не включён, настройку перекрывает другой файл или не было reload | проверьте папку -enabled, найдите настройку через grep -rn и выполните sudo systemctl reload apache2 |
Всё сверено с Apache 2.4.58 из пакета Ubuntu 24.04.
Источники
- Пакет apache2 в Ubuntu 24.04: файлы настроек —
apache2.conf,ports.conf,envvars, порядок подключения файлов. - Пакет apache2 в Ubuntu 24.04: скрипты —
a2enmod,a2ensite,a2enconf,apache2ctlи службаapache2.service: что делаютreloadиrestart. - Справка a2enmod для Ubuntu 24.04 — на английском: включение модулей.
- Справка apache2ctl для Ubuntu 24.04 — на английском:
configtest. - Директива Include в документации Apache — на английском: файлы по маске подключаются по алфавиту.
Сверено 9 ноября 2026 года.
Что почитать дальше
- Как установить Apache на Ubuntuустановка и первый сайт.
- VirtualHost в Apacheкак описать сайт.
- Ошибки Apacheчто значат сообщения в журнале.