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

a2enmod и a2dismod: как включить и выключить модуль Apache

Модуль — часть Apache, которая добавляет ему возможность: rewrite — перенаправления, headers — заголовки, ssl — HTTPS. Модули включают командой a2enmod и выключают командой a2dismod, а после — перезапускают Apache. Здесь — как это делать, что значат ответы команд и что делать, если модуль не включается.

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

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Проверьте, включён ли модуль, например rewrite:
    a2query -m rewrite

    Ответ rewrite (enabled by site administrator) — включён. Ответ No module matches rewrite — нет.

  3. Включите модуль, проверьте настройки и перезапустите Apache:
    sudo a2enmod rewrite
    sudo apache2ctl configtest
    sudo systemctl restart apache2

    Ответ configtest — Syntax OK.

a2enmod: включить модуль

sudo a2enmod rewrite

Ответ:

Enabling module rewrite.
To activate the new configuration, you need to run:
  systemctl restart apache2

Команда создала в /etc/apache2/mods-enabled/ ссылку на файл rewrite.load из mods-available. Если у модуля есть файл настроек .conf, ссылка появится и на него. Модуль заработает после sudo systemctl restart apache2.

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

Несколько модулей сразу:

sudo a2enmod rewrite headers expires
ОтветЧто значит
Enabling module rewrite.модуль включён, осталось restart
Module rewrite already enabledмодуль уже был включён
ERROR: Module php8.3 does not exist!в mods-available нет такого модуля: имя написано с ошибкой или не установлен пакет с модулем
Your MPM seems to be threaded. Selecting cgid instead of cgi.вместо cgi команда включила cgid — он работает с MPM event (что такое MPM)

Какие модули есть на сервере:

ls /etc/apache2/mods-available/ | grep '\.load$'

Модули, которые пригодятся для сайта

МодульЗачемПосле установки Apache
rewriteперенаправления и красивые адреса, RewriteRule в .htaccess (RewriteRule)выключен
headersсвои заголовки ответа, строки Header setвыключен
expiresсрок хранения файлов в кэше браузера (кэш в .htaccess)выключен
sslHTTPS; Certbot включает его сам (Certbot для Apache)выключен
deflateсжатие страниц (сжатие gzip)включён
statusстраница состояния /server-status, открывается только с самого серверавключён
reqtimeoutограничивает время на получение запроса (Timeout и KeepAlive)включён
php8.3PHP внутри Apache; появляется после установки пакета libapache2-mod-php (PHP на Ubuntu)нет файла модуля

Ещё при установке включаются alias, auth_basic, authn_file, authz_host, authz_user, access_compat, autoindex, dir, env, filter, mime, negotiation, setenvif, mpm_event и модули, которые им нужны.

Зависимости: модуль включает другие модули

Некоторым модулям нужны другие. Например, ssl не работает без mime и socache_shmcb. a2enmod включает такие модули сам:

sudo a2enmod ssl
Considering dependency mime for ssl:
Module mime already enabled
Considering dependency socache_shmcb for ssl:
Enabling module socache_shmcb.
Enabling module ssl.
See /usr/share/doc/apache2/README.Debian.gz on how to configure SSL and create self-signed certificates.
To activate the new configuration, you need to run:
  systemctl restart apache2

mime уже был включён, socache_shmcb команда включила сама. Строку про README.Debian.gz можно пропустить: сертификат удобнее получить через Certbot.

Зависимости записаны в первых строках файла .load:

head -n 3 /etc/apache2/mods-available/ssl.load

Строка # Depends: — какие модули нужны, # Conflicts: — с какими модулями этот не работает.

Конфликты: модуль не включается

Некоторые модули не работают вместе. Главный пример — MPM: включён может быть только один из mpm_event, mpm_worker и mpm_prefork.

sudo a2enmod mpm_prefork
Considering conflict mpm_event for mpm_prefork:
ERROR: Module mpm_event is enabled - cannot proceed due to conflicts. It needs to be disabled first!
Considering conflict mpm_worker for mpm_prefork:

Сначала выключите модуль из сообщения, потом включайте нужный:

sudo a2dismod mpm_event
sudo a2enmod mpm_prefork
sudo systemctl restart apache2

Менять MPM без причины не нужно. Когда это нужно и чем MPM отличаются — MPM в Apache.

Если конфликт у модуля, который нужен другому модулю, ответ закончится строкой ERROR: Could not enable dependency mpm_prefork for php8.3, aborting: модуль php8.3 не включится, пока вы не решите конфликт.

a2dismod: выключить модуль

sudo a2dismod rewrite

Ответ:

Module rewrite disabled.
To activate the new configuration, you need to run:
  systemctl restart apache2

Ссылка на rewrite.load удалена из mods-enabled, а если у модуля был файл .conf, — и ссылка на него. Файлы в mods-available остались. После sudo systemctl restart apache2 модуль выгружен.

Перед тем как выключить модуль, проверьте, что его строки не используются в файлах сайтов и в .htaccess. Если в файле сайта есть строка выключенного модуля и она не внутри блока <IfModule>, Apache не запустится. Если такая строка в .htaccess, сайт будет отвечать ошибкой 500 (Invalid command 'RewriteEngine').
ОтветЧто значит
Module rewrite disabled.модуль выключен, осталось restart
Module rewrite already disabledмодуль и так был выключен
ERROR: The following modules depend on socache_shmcb and need to be disabled first: sslмодуль нужен другому включённому модулю: сначала выключите тот, что указан в конце

Обязательные модули: предупреждение и фраза Yes, do as I say!

Модули alias, auth_basic, authn_file, authz_host, authz_user, autoindex, deflate, dir, env, filter, logio, mime, negotiation, setenvif, unixd, version и watchdog a2dismod считает обязательными. Если выключить один из них, команда предупредит:

WARNING: The following essential module will be disabled.
This might result in unexpected behavior and should NOT be done
unless you know exactly what you are doing!
 autoindex

To continue type in the phrase 'Yes, do as I say!' or retry by passing '-f':

Чтобы ничего не выключать, нажмите Enter: ответ — Aborting, модуль остался включённым.

Модуль autoindex выключают, чтобы Apache не показывал список файлов в папке без index.html. Для этого выключать модуль не нужно: уберите слово Indexes из строки Options в блоке Directory вашего сайта (Directory и Options).

Как проверить, какие модули работают

Список модулей, которые Apache загрузил:

sudo apache2ctl -M
Loaded Modules:
 core_module (static)
 so_module (static)
 ...
 rewrite_module (shared)
ПометкаЧто значит
(static)модуль встроен в Apache, выключить его нельзя
(shared)модуль подключён из mods-enabled, его включают и выключают командами

Один модуль:

sudo apache2ctl -M | grep rewrite

Ответ rewrite_module (shared) — модуль работает. Пустой ответ — модуль не загружен.

apache2ctl -M показывает модули по настройкам на диске: если вы только что выполнили a2enmod и ещё не перезапустили Apache, модуль уже будет в списке, но заработает только после restart.

a2query -m без имени модуля покажет все включённые модули и кто их включил:

ОтветЧто значит
rewrite (enabled by site administrator)включили вы командой a2enmod
mime (enabled by maintainer script)включила программа установки Apache

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

Что видитеПричинаЧто делать
ERROR: Module php8.3 does not exist!не установлен пакет с модулем или имя с ошибкойls /etc/apache2/mods-available/ | grep php; для PHP установите пакет libapache2-mod-php
ERROR: Module mpm_event is enabled - cannot proceed due to conflicts.модули не работают вместеsudo a2dismod mpm_event, затем снова a2enmod (MPM)
Invalid command 'RewriteEngine'модуль rewrite выключенsudo a2enmod rewrite и sudo systemctl restart apache2 (разбор)
Invalid command 'Header'модуль headers выключенsudo a2enmod headers и sudo systemctl restart apache2
после a2dismod Apache не запускаетсяв файле сайта есть строка выключенного модуляsudo apache2ctl configtest покажет файл и строку: включите модуль обратно или удалите строку
a2enmod выполнили, а модуль не работаетне было restartsudo systemctl restart apache2
Aborting после предупреждениявы не ввели фразу подтверждениямодуль не выключен, так и было задумано

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

Источники

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

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

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