a2enmod и a2dismod: как включить и выключить модуль Apache
Модуль — часть Apache, которая добавляет ему возможность: rewrite — перенаправления, headers — заголовки, ssl — HTTPS. Модули включают командой a2enmod и выключают командой a2dismod, а после — перезапускают Apache. Здесь — как это делать, что значат ответы команд и что делать, если модуль не включается.
Содержание 11
- Что сделать прямо сейчас
- a2enmod: включить модуль
- Модули, которые пригодятся для сайта
- Зависимости: модуль включает другие модули
- Конфликты: модуль не включается
- a2dismod: выключить модуль
- Обязательные модули: предупреждение и фраза Yes, do as I say!
- Как проверить, какие модули работают
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Проверьте, включён ли модуль, например rewrite:
a2query -m rewriteОтвет
rewrite (enabled by site administrator)— включён. ОтветNo module matches rewrite— нет. - Включите модуль, проверьте настройки и перезапустите 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) | выключен |
ssl | HTTPS; Certbot включает его сам (Certbot для Apache) | выключен |
deflate | сжатие страниц (сжатие gzip) | включён |
status | страница состояния /server-status, открывается только с самого сервера | включён |
reqtimeout | ограничивает время на получение запроса (Timeout и KeepAlive) | включён |
php8.3 | PHP внутри 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 sslConsidering 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 apache2mime уже был включён, 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_preforkConsidering 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 модуль выгружен.
<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 -MLoaded 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 выполнили, а модуль не работает | не было restart | sudo systemctl restart apache2 |
Aborting после предупреждения | вы не ввели фразу подтверждения | модуль не выключен, так и было задумано |
Всё сверено с Apache 2.4.58 из пакета Ubuntu 24.04.
Источники
- Справка a2enmod для Ubuntu 24.04 — на английском: включение и выключение модулей, ключ
-f. - Пакет apache2 в Debian: скрипт a2enmod — зависимости и конфликты, список обязательных модулей, ответы команд.
- Пакет apache2 в Debian: файлы модулей — строки
DependsиConflictsв файлах.load. - Пакет apache2 в Debian: программа установки — какие модули включаются при установке.
- Ключ -M в документации Apache — на английском: список загруженных модулей.
Сверено 9 ноября 2026 года.
Что почитать дальше
- a2enconf и a2disconfвключение дополнительных настроек.
- MPM в Apacheevent и prefork.
- Файл .htaccessгде пригодятся rewrite, headers и expires.