apache2ctl: проверить настройки Apache, посмотреть сайты и модули, перезапустить
apache2ctl — команда для проверки и управления Apache. Главное, что она делает, — проверяет настройки до перезапуска: если в файле ошибка, вы увидите её сразу, а сайты продолжат работать. Здесь — все полезные команды apache2ctl, что значат их ответы и когда вместо неё лучше systemctl.
Содержание 13
- Что сделать прямо сейчас
- Команды apache2ctl
- configtest: проверить настройки
- Если в настройках ошибка
- apache2ctl -S: сайты и пути
- apache2ctl -M: включённые модули
- Какие файлы читает Apache
- Версия Apache и MPM
- graceful и restart: как применить настройки
- status: состояние Apache
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Проверьте настройки Apache:
sudo apache2ctl configtestОтвет
Syntax OK— ошибок нет, можно применять:sudo systemctl reload apache2. - Если в ответе ошибка — найдите файл и номер строки по разбору ниже.
Команды apache2ctl
| Команда | Что делает |
|---|---|
sudo apache2ctl configtest | проверяет все файлы настроек, ответ — Syntax OK или ошибка |
sudo apache2ctl -S | показывает сайты, порты, главную папку и журнал ошибок |
sudo apache2ctl -M | показывает включённые модули |
sudo apache2ctl -t -D DUMP_INCLUDES | показывает, какие файлы настроек прочитаны |
apache2ctl -v | показывает версию Apache |
sudo apache2ctl -V | показывает версию, MPM и пути, с которыми собран Apache |
sudo apache2ctl graceful | применяет настройки, не обрывая открытые страницы |
sudo apache2ctl restart | перезапускает Apache, обрывая текущие запросы |
sudo apache2ctl status | состояние Apache со страницы server-status |
apache2ctl -t — то же, что configtest. Если команды apache2ctl нет, Apache не установлен — установка Apache.
Пишите sudo перед командой. Файлы сертификатов Let's Encrypt в /etc/letsencrypt читает только root, и без sudo проверка может сообщить об ошибке там, где настройки верны.
configtest: проверить настройки
sudo apache2ctl configtestApache читает все файлы настроек — apache2.conf, включённые модули, conf-enabled, sites-enabled — и проверяет каждую строку. Сам Apache при этом не перезапускается, сайты работают как раньше.
Если ошибок нет:
Syntax OKЕсли перед Syntax OK есть строка AH00558: Could not reliably determine the server's fully qualified domain name, это предупреждение, а не ошибка: настройки применятся. Как убрать — AH00558.
Если в настройках ошибка
Первая строка ответа начинается с кода AH00526: в ней номер строки и путь к файлу, где Apache нашёл ошибку, например line 12 of /etc/apache2/sites-enabled/example.ru.conf. Дальше — что не так и две строки от apache2ctl:
Invalid command 'RewriteEngine', perhaps misspelled or defined by a module not included in the server configuration
Action 'configtest' failed.
The Apache error log may have more information.| Строка | Что значит |
|---|---|
строка с AH00526 | файл и номер строки с ошибкой |
Invalid command 'RewriteEngine', … | что не так: здесь — модуль rewrite выключен (разбор) |
Action 'configtest' failed. | проверка не прошла |
The Apache error log may have more information. | apache2ctl пишет эту строку после любой ошибки; при configtest причина уже на экране, в журнал смотреть не нужно |
Откройте файл на нужной строке:
sudo nano +12 /etc/apache2/sites-enabled/example.ru.conf+12 — перейти сразу к строке 12. Исправьте, сохраните — Ctrl+O, Enter, Ctrl+X — и снова запустите sudo apache2ctl configtest. Пока ответ не Syntax OK, не перезапускайте Apache.
Разбор других текстов ошибок — ошибки Apache.
apache2ctl -S: сайты и пути
sudo apache2ctl -SВ начале ответа — блок VirtualHost configuration:: на каких портах какие сайты и какой сайт открывается по умолчанию. Как его читать, разобрано в VirtualHost в Apache.
Ниже — общие пути:
ServerRoot: "/etc/apache2"
Main ErrorLog: "/var/log/apache2/error.log"| Строка | Что значит |
|---|---|
ServerRoot | папка с настройками Apache |
Main DocumentRoot | папка с файлами для сайта без своего DocumentRoot |
Main ErrorLog | общий журнал ошибок (журналы Apache) |
apache2ctl -S тоже проверяет настройки: если в них ошибка, вместо списка будет ошибка, как у configtest.
apache2ctl -M: включённые модули
sudo apache2ctl -MОтвет начинается со строки Loaded Modules:, дальше — по модулю в строке:
Loaded Modules:
core_module (static)
...
rewrite_module (shared)| Пометка | Что значит |
|---|---|
(static) | модуль встроен в Apache, выключить нельзя |
(shared) | модуль включён командой a2enmod, выключается командой a2dismod |
Проверить один модуль:
sudo apache2ctl -M | grep rewriteЕсть строка rewrite_module (shared) — модуль включён. Пустой ответ — выключен, включить: sudo a2enmod rewrite (a2enmod и a2dismod).
Какие файлы читает Apache
sudo apache2ctl -t -D DUMP_INCLUDESОтвет начинается со строки Included configuration files:, дальше — все файлы настроек в том порядке, в каком Apache их прочитал. Если вашего файла сайта в списке нет, сайт не включён: sudo a2ensite и имя файла (a2ensite).
Версия Apache и MPM
apache2ctl -vОтвет — две строки: Server version: Apache/2.4.58 (Ubuntu) и Server built: с датой сборки.
Узнать, какой MPM работает:
sudo apache2ctl -V | grep 'Server MPM'Ответ — Server MPM: и название: event или prefork (MPM в Apache).
graceful и restart: как применить настройки
| Команда | Что происходит |
|---|---|
sudo systemctl reload apache2 | то же, что apache2ctl graceful: Apache перечитывает настройки, открытые страницы догружаются |
sudo apache2ctl graceful | то же самое, но без systemd |
sudo apache2ctl restart | процессы Apache завершаются сразу, текущие запросы обрываются, затем Apache читает настройки заново |
sudo systemctl restart apache2 | Apache останавливается и запускается заново |
apache2ctl graceful и apache2ctl restart сначала проверяют настройки. Если в них ошибка, Apache не перезапускается и работает со старыми настройками, а на экране — ошибка проверки.
systemctl restart сначала останавливает Apache. Если в настройках ошибка, он не запустится, и все сайты перестанут открываться. Поэтому перед каждым restart запускайте sudo apache2ctl configtest.
Что выбрать:
| Что изменили | Команда |
|---|---|
файл сайта в sites-available | sudo systemctl reload apache2 |
включили или выключили сайт (a2ensite, a2dissite) | sudo systemctl reload apache2 |
включили или выключили настройку (a2enconf, a2disconf) | sudo systemctl reload apache2 |
включили или выключили модуль (a2enmod, a2dismod) | sudo systemctl restart apache2 |
| сменили MPM | sudo systemctl restart apache2 |
Правки в .htaccess работают сразу, перезапускать Apache не нужно.
Запускать и останавливать Apache удобнее через systemctl: sudo systemctl start apache2 и sudo systemctl stop apache2. Если набрать sudo apache2ctl start, команда сама передаст запуск systemd и напишет Invoking 'systemctl start apache2'. (команда systemctl).
status: состояние Apache
sudo apache2ctl statusКоманда открывает страницу http://localhost:80/server-status текстовым браузером. Если на сервере его нет, ответ:
'www-browser -dump http://localhost:80/server-status' failed.
Maybe you need to install a package providing www-browser or you
need to adjust the APACHE_LYNX variable in /etc/apache2/envvarsСтавить браузер не нужно — ту же страницу можно получить так:
curl -s 'http://localhost/server-status?auto'| Строка ответа | Что значит |
|---|---|
ServerVersion | версия Apache |
ServerMPM | какой MPM работает |
ServerUptime | сколько Apache работает без перезапуска |
Total Accesses | сколько запросов принято с запуска |
BusyWorkers | сколько запросов обрабатывается сейчас |
IdleWorkers | сколько обработчиков свободно |
Страница открывается только с самого сервера: в файле /etc/apache2/mods-available/status.conf для неё стоит Require local. Не меняйте это: страница показывает адреса посетителей и запросы.
Если curl вернул пустой ответ или код 404, выключен модуль status: sudo a2enmod status и sudo systemctl restart apache2.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Action 'configtest' failed. | ошибка в настройках | читайте строку с AH00526 выше: в ней файл и номер строки |
Action 'restart' failed. или Action 'graceful' failed. | проверка перед перезапуском нашла ошибку, Apache работает со старыми настройками | sudo apache2ctl configtest, исправьте строку из ответа |
Invalid command 'RewriteEngine', perhaps misspelled… | модуль rewrite выключен | sudo a2enmod rewrite и sudo systemctl restart apache2 |
AH00558: Could not reliably determine the server's fully qualified domain name | не задано имя сервера; это предупреждение | AH00558 |
после configtest с ответом Syntax OK Apache не запускается | ошибка не в настройках, например порт занят | sudo journalctl -u apache2 -n 30 и Apache не запускается |
'www-browser -dump …' failed. | нет текстового браузера для status | curl -s 'http://localhost/server-status?auto' |
в списке -S нет вашего сайта | сайт не включён | sudo a2ensite example.ru и reload |
Всё сверено с Apache 2.4.58 из пакета Ubuntu 24.04.
Источники
- Пакет apache2 в Debian: apache2ctl — что делают команды и строки Action failed.
- Пакет apache2 в Debian: служба apache2 — reload выполняет apachectl graceful.
- Остановка и перезапуск Apache — на английском: чем graceful отличается от restart.
- Ключи программы Apache — на английском: -t, -S, -M, -v, -V и DUMP_INCLUDES.
- Модуль mod_status — на английском: страница server-status.
Сверено 9 ноября 2026 года.
Что почитать дальше
- Ошибки Apacheчто значат тексты ошибок.
- VirtualHost в Apacheкак читать список сайтов.
- Настройки Apacheвсе настройки на одной странице.