Directory и AllowOverride в Apache: доступ к папке сайта, Options и .htaccess
Блок Directory задаёт правила для папки на сервере: кто может открыть файлы, показывать ли список файлов и какие строки разрешены в .htaccess. В Ubuntu часть таких блоков уже записана в apache2.conf, и из-за них .htaccess после установки не работает. Здесь — что в этих блоках, как добавить свой для папки сайта и что значат ошибки.
Содержание 11
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите, какие блоки уже записаны в общих настройках:
grep -n -A4 '<Directory' /etc/apache2/apache2.confВ ответе три блока: для
/,/usr/shareи/var/www/. Что они значат — ниже. - Если нужен .htaccess, откройте файл сайта и добавьте блок из раздела Как выглядит блок Directory:
sudo nano /etc/apache2/sites-available/example.ru.confВместо
example.ru.conf— файл вашего сайта, список покажетls /etc/apache2/sites-available/.
Как выглядит блок Directory
Блок для папки сайта /var/www/example.ru:
<Directory /var/www/example.ru>
Options -Indexes +FollowSymLinks
AllowOverride All
Require all granted
</Directory>| Строка | Что значит |
|---|---|
<Directory /var/www/example.ru> | правила для этой папки и всех папок внутри неё |
Options -Indexes +FollowSymLinks | не показывать список файлов, переходить по ссылкам на файлы (подробнее) |
AllowOverride All | читать .htaccess и разрешить в нём все строки (подробнее) |
Require all granted | открывать файлы может любой посетитель (подробнее) |
</Directory> | конец блока |
Путь пишут без адреса сайта — это папка на диске сервера, та же, что в строке DocumentRoot.
Вставьте блок в файл сайта перед строкой <VirtualHost *:80>. Так он действует и для HTTP, и для HTTPS: если Certbot потом создаст второй файл сайта для HTTPS, переносить блок не понадобится. Затем проверьте и примените:
sudo apache2ctl configtest
sudo systemctl reload apache2Ответ configtest — Syntax OK. Для блоков Directory достаточно reload, restart не нужен.
Блоки из apache2.conf
В файле /etc/apache2/apache2.conf уже записаны три блока:
<Directory />
Options FollowSymLinks
AllowOverride None
Require all denied
</Directory>
<Directory /usr/share>
AllowOverride None
Require all granted
</Directory>
<Directory /var/www/>
Options Indexes FollowSymLinks
AllowOverride None
Require all granted
</Directory>| Блок | Что значит для вашего сайта |
|---|---|
<Directory /> | весь диск закрыт: файлы из папок вне /var/www и /usr/share Apache не отдаёт, ответ 403 |
<Directory /usr/share> | открыта папка с общими файлами программ; сайты туда не кладут |
<Directory /var/www/> | папка сайтов открыта, но .htaccess не читается (AllowOverride None), а у папки без index.html показывается список файлов (Indexes) |
Ниже в том же файле — ещё один блок:
<FilesMatch "^\.ht">
Require all denied
</FilesMatch>Он закрывает файлы, имя которых начинается с .ht: .htaccess и .htpasswd с паролями. Запрос к ним получит ответ 403.
Эти блоки не правьте: свой блок для папки сайта перекроет их (порядок блоков).
Options: что разрешено в папке
| Значение | Что включает |
|---|---|
Indexes | список файлов, если в папке нет index.html или другого файла из DirectoryIndex |
FollowSymLinks | переход по ссылкам на файлы и папки; без него не работают правила RewriteRule в .htaccess |
SymLinksIfOwnerMatch | переход по ссылке, только если у ссылки и файла один владелец |
ExecCGI | запуск программ CGI |
Includes | команды SSI в страницах .shtml |
MultiViews | подбор файла по языку и типу: запрос /about откроет about.html |
All | всё, кроме MultiViews |
None | ничего из списка |
Знаки плюс и минус
Строку Options пишут двумя способами:
| Запись | Что делает |
|---|---|
Options -Indexes | убирает Indexes, остальное из блока /var/www/ остаётся: FollowSymLinks работает |
Options +Includes | добавляет Includes к тому, что уже включено |
Options Indexes | без знаков: заменяет всё, что было; FollowSymLinks выключится |
В одной строке нельзя смешивать значения со знаками и без. На строку Options -Indexes FollowSymLinks проверка ответит:
Either all Options must start with + or -, or no Option may.Пишите знак перед каждым значением: Options -Indexes +FollowSymLinks.
Как убрать список файлов
После установки в блоке /var/www/ включён Indexes. Если в папке сайта нет index.html или index.php, по её адресу откроется страница Index of / со всеми файлами папки. Чтобы список не показывался, добавьте в блок своего сайта строку:
Options -IndexesПосле reload по адресу такой папки будет ответ 403, а в журнале ошибок — запись с кодом AH01276. Если у вас нет блока Directory для сайта, то же самое можно написать в .htaccess — список файлов в .htaccess.
AllowOverride: разрешить .htaccess
AllowOverride говорит, какие строки Apache примет из файла .htaccess в этой папке.
| Значение | Что можно писать в .htaccess |
|---|---|
None | ничего: Apache даже не ищет файл .htaccess |
All | всё, что допускается в .htaccess |
FileInfo | переадресации RewriteRule и Redirect, ErrorDocument, заголовки Header |
AuthConfig | пароль на папку и строки Require |
Indexes | DirectoryIndex, настройки списка файлов, кэширование ExpiresByType |
Options | строку Options |
Limit | старые строки Order, Deny и Allow |
Значения можно перечислить через пробел: AllowOverride FileInfo AuthConfig. Для сайта на WordPress или другого готового движка пишите AllowOverride All: его .htaccess рассчитан на это.
После установки для /var/www/ стоит AllowOverride None, поэтому .htaccess не работает, пока вы не добавите свой блок с AllowOverride All. Подробно для сайта, который переехал с хостинга, — .htaccess на своём VPS.
AllowOverride работает только внутри <Directory>:
| Где написано | Что будет |
|---|---|
внутри <Directory> | работает |
внутри <VirtualHost>, но не в <Directory> | проверка выдаст AllowOverride not allowed in <VirtualHost> context, Apache не примет настройки |
внутри <Location> или <Files> | предупреждение AH00114: Useless use of AllowOverride — строка ничего не делает |
в самом .htaccess | ошибка: эту строку пишут только в настройках сервера |
Если в .htaccess есть строка из группы, которую AllowOverride не разрешает, страницы папки ответят ошибкой 500, а в журнале ошибок появится запись с именем строки:
/var/www/example.ru/.htaccess: RewriteEngine not allowed hereЗначит, у папки AllowOverride None или в нём нет нужной группы — для RewriteEngine это FileInfo. Добавьте группу или напишите All.
Require: кто может открыть файлы
| Строка | Кто может открыть |
|---|---|
Require all granted | все |
Require all denied | никто, ответ 403 |
Require ip 203.0.113.10 | только с этого IP-адреса |
Require local | только запросы с самого сервера |
Пример — папка admin сайта, которую видно только с вашего адреса. Вместо 203.0.113.10 — ваш IP:
<Directory /var/www/example.ru/admin>
Require ip 203.0.113.10
</Directory>Больше примеров — запрет доступа в .htaccess: строки Require одинаковы в блоке Directory и в .htaccess.
Папка сайта вне /var/www
Блок <Directory /> закрывает весь диск, поэтому если DocumentRoot указывает на папку вне /var/www, например /srv/example.ru или /home/user/example.ru, сайт ответит 403, а в журнале ошибок будет AH01630: client denied by server configuration. Откройте папку своим блоком:
<Directory /srv/example.ru>
Options -Indexes +FollowSymLinks
AllowOverride All
Require all granted
</Directory>Если после этого ответ всё ещё 403, у пользователя www-data нет прав на папку — AH00035: search permissions и права на файлы.
Require тоже пишут только внутри <Directory>, <Location> или <Files>: строка прямо в <VirtualHost> даст при проверке Require not allowed in <VirtualHost> context.
В каком порядке Apache применяет блоки
Для одного запроса может подойти несколько блоков. Apache применяет их по порядку:
- Блоки
<Directory>— от короткого пути к длинному: сначала/, потом/var/www/, потом/var/www/example.ru. Каждый следующий перекрывает то, что задал предыдущий. - Вместе с ними — файлы
.htaccess, еслиAllowOverrideих разрешает. Строки из.htaccessперекрывают блок Directory той же папки. - Блоки
<DirectoryMatch>. - Блоки
<Files>и<FilesMatch>. - Блоки
<Location>— по адресу в запросе, а не по папке на диске.
Поэтому ваш блок <Directory /var/www/example.ru> с AllowOverride All срабатывает, хотя в /var/www/ записано AllowOverride None: путь длиннее, и блок применяется позже.
Если для одной и той же папки записаны два блока, сработают оба в том порядке, в каком Apache их прочитал, — более поздний перекроет более ранний.
Как проверить
- Проверьте настройки и примените:
sudo apache2ctl configtest sudo systemctl reload apache2 - Проверьте, читается ли
.htaccess: добавьте в его начало строку из лишнего слова, напримерproverka, и откройте сайт. Ответ 500 — файл читается; уберите строку. Ответ 200 — у папкиAllowOverride None(подробнее). - Проверьте список файлов — вместо
imagesподставьте папку безindex.html:curl -I http://example.ru/images/Строка
HTTP/1.1 403 Forbidden— список выключен.HTTP/1.1 200 OK— список показывается.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
.htaccess не работает, правила ничего не меняют | у папки AllowOverride None из блока /var/www/ | добавьте блок Directory с AllowOverride All для папки сайта, reload |
.htaccess: RewriteEngine not allowed here и ошибка 500 | AllowOverride не разрешает группу FileInfo | AllowOverride All или добавьте FileInfo |
.htaccess: Options not allowed here | AllowOverride без группы Options | добавьте Options в AllowOverride или уберите строку из .htaccess |
AllowOverride not allowed in <VirtualHost> context | строка стоит в <VirtualHost> вне <Directory> | перенесите её в блок <Directory> |
Either all Options must start with + or -, or no Option may. | в строке Options значения со знаками и без | знак перед каждым: Options -Indexes +FollowSymLinks |
Illegal option Indexs | опечатка в значении Options | сверьте с таблицей |
Illegal override option FileInf | опечатка в имени группы AllowOverride | сверьте с таблицей |
после Options Indexes правила RewriteRule отвечают 403 | запись без знаков выключила FollowSymLinks, в журнале код AH00670 | Options +Indexes или Options Indexes FollowSymLinks |
сайт в /srv или /home отвечает 403 | блок <Directory /> закрывает весь диск | блок Directory с Require all granted для папки сайта (AH01630) |
по адресу папки открывается Index of / со списком файлов | Indexes из блока /var/www/ | Options -Indexes в блоке сайта |
Всё сверено с Apache 2.4.58 из пакета Ubuntu 24.04.
Источники
- Директивы Directory, Options и AllowOverride — на английском: где можно писать каждую директиву, значения Options и группы AllowOverride.
- Как Apache объединяет блоки настроек — на английском: порядок Directory, .htaccess, Files и Location.
- Директива Require — на английском: варианты all, ip, local.
- Пакет apache2 в Debian: apache2.conf — блоки Directory и FilesMatch из общих настроек.
- Исходный код Apache 2.4.58: core.c — тексты ошибок Options и AllowOverride.
Сверено 9 ноября 2026 года.
Что почитать дальше
- Файл .htaccessчто можно настроить в .htaccess.
- Почему .htaccess не работаетразбор по шагам.
- VirtualHost в Apacheкак описать сайт.