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

Directory и AllowOverride в Apache: доступ к папке сайта, Options и .htaccess

Блок Directory задаёт правила для папки на сервере: кто может открыть файлы, показывать ли список файлов и какие строки разрешены в .htaccess. В Ubuntu часть таких блоков уже записана в apache2.conf, и из-за них .htaccess после установки не работает. Здесь — что в этих блоках, как добавить свой для папки сайта и что значат ошибки.

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

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите, какие блоки уже записаны в общих настройках:
    grep -n -A4 '<Directory' /etc/apache2/apache2.conf

    В ответе три блока: для /, /usr/share и /var/www/. Что они значат — ниже.

  3. Если нужен .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
IndexesDirectoryIndex, настройки списка файлов, кэширование 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 применяет их по порядку:

  1. Блоки <Directory> — от короткого пути к длинному: сначала /, потом /var/www/, потом /var/www/example.ru. Каждый следующий перекрывает то, что задал предыдущий.
  2. Вместе с ними — файлы .htaccess, если AllowOverride их разрешает. Строки из .htaccess перекрывают блок Directory той же папки.
  3. Блоки <DirectoryMatch>.
  4. Блоки <Files> и <FilesMatch>.
  5. Блоки <Location> — по адресу в запросе, а не по папке на диске.

Поэтому ваш блок <Directory /var/www/example.ru> с AllowOverride All срабатывает, хотя в /var/www/ записано AllowOverride None: путь длиннее, и блок применяется позже.

Если для одной и той же папки записаны два блока, сработают оба в том порядке, в каком Apache их прочитал, — более поздний перекроет более ранний.

Как проверить

  1. Проверьте настройки и примените:
    sudo apache2ctl configtest
    sudo systemctl reload apache2
  2. Проверьте, читается ли .htaccess: добавьте в его начало строку из лишнего слова, например proverka, и откройте сайт. Ответ 500 — файл читается; уберите строку. Ответ 200 — у папки AllowOverride None (подробнее).
  3. Проверьте список файлов — вместо 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 и ошибка 500AllowOverride не разрешает группу FileInfoAllowOverride All или добавьте FileInfo
.htaccess: Options not allowed hereAllowOverride без группы 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, в журнале код AH00670Options +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.

Источники

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

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

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