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

apache2ctl: проверить настройки Apache, посмотреть сайты и модули, перезапустить

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

≈ 8 мин чтения
Содержание 13

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

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

    Ответ Syntax OK — ошибок нет, можно применять: sudo systemctl reload apache2.

  3. Если в ответе ошибка — найдите файл и номер строки по разбору ниже.

Команды 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 configtest

Apache читает все файлы настроек — 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 apache2Apache останавливается и запускается заново

apache2ctl graceful и apache2ctl restart сначала проверяют настройки. Если в них ошибка, Apache не перезапускается и работает со старыми настройками, а на экране — ошибка проверки.

systemctl restart сначала останавливает Apache. Если в настройках ошибка, он не запустится, и все сайты перестанут открываться. Поэтому перед каждым restart запускайте sudo apache2ctl configtest.

Что выбрать:

Что изменилиКоманда
файл сайта в sites-availablesudo systemctl reload apache2
включили или выключили сайт (a2ensite, a2dissite)sudo systemctl reload apache2
включили или выключили настройку (a2enconf, a2disconf)sudo systemctl reload apache2
включили или выключили модуль (a2enmod, a2dismod)sudo systemctl restart apache2
сменили MPMsudo 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.нет текстового браузера для statuscurl -s 'http://localhost/server-status?auto'
в списке -S нет вашего сайтасайт не включёнsudo a2ensite example.ru и reload

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

Источники

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

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

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