Файл wp-content/debug.log может содержать гораздо больше информации, чем кажется на первый взгляд: абсолютные пути на сервере, названия плагинов и тем, SQL-ошибки, параметры запросов, фрагменты данных из форм и служебные сообщения PHP. Если этот файл открывается в браузере, злоумышленник получает подсказки для подготовки атаки.
Проблема особенно актуальна для сайтов на WordPress с Elementor, большим количеством плагинов или сложной серверной конфигурацией. Сам debug.log не является уязвимостью, но его публичная доступность создаёт ненужную утечку технической информации. Ниже приведён безопасный порядок настройки, проверки и очистки логов.
Чем опасен открытый debug.log
WordPress записывает диагностические сообщения в файл debug.log, когда включены WP_DEBUG и журналирование ошибок. В нём могут появляться предупреждения PHP, ошибки плагинов, названия классов, пути к файлам, SQL-запросы и данные, передаваемые при обработке форм.
Для пользователя сайта это обычно технический шум, но для атакующего — карта инфраструктуры. По путям можно определить структуру хостинга, по названиям компонентов — потенциально уязвимые версии, а по тексту ошибок — способ повторно вызвать нужную ошибку.
Наличие robots.txt или запрет индексации не защищает файл. robots.txt предназначен для поисковых роботов, а не для контроля доступа. Если URL известен или легко угадывается, файл необходимо заблокировать на уровне веб-сервера либо убрать за пределы публичной директории.
- Не оставляйте debug.log доступным по адресу вроде /wp-content/debug.log.
- Не полагайтесь только на скрытое имя файла или robots.txt.
- Считайте содержимое лога потенциально конфиденциальным и не публикуйте его полностью в открытых issue и чатах.
Безопасная конфигурация WordPress для production
На рабочем сайте отладка обычно должна быть отключена. Если необходимо временно собрать диагностику, включите запись в файл, но запретите показ ошибок посетителям. Константы добавляют в wp-config.php до строки, сообщающей о завершении редактирования. Не создавайте второе определение тех же констант в файле или конфигурации хостинга.
- WP_DEBUG отвечает за режим отладки.
- WP_DEBUG_LOG включает запись сообщений в журнал или задаёт путь к нему.
- WP_DEBUG_DISPLAY запрещает вывод ошибок в HTML-ответе страницы.
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', '/var/log/wordpress/debug.log');
define('WP_DEBUG_DISPLAY', false);
@ini_set('display_errors', 0);
Как отключить режим после диагностики
После завершения проверки верните production-настройки. Важно не просто скрыть сообщения, а прекратить их накопление, если постоянное журналирование больше не требуется.
- Установите WP_DEBUG в false.
- Установите WP_DEBUG_DISPLAY в false.
- При необходимости отключите WP_DEBUG_LOG или оставьте его включённым только при наличии контролируемой системы журналирования.
- Удалите или переместите старый debug.log после проверки.
define('WP_DEBUG', false);
define('WP_DEBUG_DISPLAY', false);
// WP_DEBUG_LOG не вмикайте без потреби.
Почему лог лучше хранить за пределами public_html
Самый надёжный подход — записывать лог в каталог, который не является частью публичной директории сайта. Например, если файлы WordPress размещены в /var/www/example/public, журнал можно хранить в /var/log/wordpress/debug.log или другом каталоге, доступном PHP и пользователю веб-сервера, но недоступном через HTTP.
Если каталог физически находится за пределами document root, обычный запрос к URL не должен позволять прочитать этот файл. При этом необходимо проверить права: процесс PHP должен иметь возможность создавать журнал и дописывать в него, а сторонние пользователи системы не должны получать лишний доступ.
Права 750 для каталога могут быть подходящими, если владелец и группа настроены правильно. Для самого файла часто используют 640 или более строгие права. Конкретная схема зависит от того, работает ли PHP от имени www-data, nginx, apache, отдельного системного пользователя или пользователя сайта.
- Убедитесь, что каталог принадлежит правильному пользователю и группе.
- Проверьте, что веб-процесс может записывать файл, но не имеет лишних прав на другие системные каталоги.
- Не используйте chmod 777 для каталога или лога — это маскирует проблему с владельцем и расширяет доступ.
- Убедитесь, что резервные копии и панель хостинга также не делают журнал публичным.
sudo chown -R www-data:www-data /var/log/wordpress
sudo chmod 750 /var/log/wordpress
sudo chmod 640 /var/log/wordpress/debug.log
Как заблокировать debug.log, если его нельзя перенести
На shared-хостинге или в готовом шаблоне сервера не всегда можно изменить путь WP_DEBUG_LOG. В таком случае оставьте файл в wp-content, но запретите его выдачу веб-сервером. Это дополнительная защита, а не полноценная замена правильным файловым правам.
Для Apache правило можно разместить в конфигурации виртуального хоста или в .htaccess, если хостинг разрешает такие директивы. Для Nginx блок добавляют в конфигурацию соответствующего server-блока. После изменений необходимо проверить синтаксис и перезагрузить конфигурацию согласно правилам конкретного сервера.
- Apache должен возвращать 403 или 404 при запросе к /wp-content/debug.log.
- Nginx не должен передавать файл через общее правило обработки статических файлов.
- Если используется CDN или reverse proxy, проверьте доступ не только напрямую к origin, но и через домен.
### Apache
<Files "debug.log">
Require all denied
</Files>
### Nginx
location = /wp-content/debug.log {
deny all;
return 404;
}
Что выбрать: 403 или 404
Оба варианта блокируют чтение содержимого. Код 403 прямо сообщает, что ресурс существует, но доступ запрещён. Код 404 не раскрывает наличие файла, поэтому часто лучше подходит для публичного ответа. Главное — чтобы сервер не возвращал 200 OK вместе с текстом журнала.
- Не проверяйте защиту только по наличию страницы ошибки.
- Проверяйте HTTP-код и убедитесь, что в ответе нет строк из лога.
Как проверить, что файл действительно недоступен
Выполняйте проверку после изменения конфигурации, очистки кеша и завершения теста. Запрос нужно сделать как неавторизованный посетитель: защита не должна зависеть от того, вошли ли вы в административную панель.
Проверьте как точный адрес debug.log, так и типичные варианты с начальным слешем, HTTP/HTTPS и доменом, который обслуживает сайт. Если используется прокси или CDN, результат может кешироваться, поэтому после исправления очистите соответствующий кеш.
- Ожидаемый результат — 403 или 404, а не 200.
- Тело ответа не должно содержать путей к серверу, SQL-ошибок или строк журнала.
- Проверьте доступ из внешней сети, а не только через localhost.
- После диагностики убедитесь, что новый лог не создаётся в публичном каталоге wp-content.
curl -I https://example.com/wp-content/debug.log
curl -sS https://example.com/wp-content/debug.log | head
Логи WordPress, Elementor и сервера: что ещё проверить
Elementor и другие плагины могут создавать предупреждения PHP, AJAX-ошибки или сообщения во время сохранения страниц. Это не означает, что весь журнал следует оставлять открытым. Если проблема связана с Elementor, собирайте лог только на время воспроизведения ошибки и не публикуйте необработанный файл.
Помимо wp-content/debug.log, на сайте могут быть отдельные журналы PHP-FPM, Apache или Nginx, логи хостинга, ошибки cron и журналы сторонних интеграций. Проверьте, не доступны ли они через резервные копии, временные файлы, служебные каталоги или неправильно настроенные alias.
Если в журнале уже появились пароли, токены, адреса электронной почты или данные форм, считайте их скомпрометированными. Удаление файла не отменяет возможного копирования его содержимого, поэтому при необходимости отзовите токены и замените секреты.
- Не включайте WP_DEBUG постоянно ради удобства разработки.
- Не отправляйте подрядчику полный лог без удаления персональных и секретных данных.
- Настройте ротацию логов и ограничение их размера на сервере.
- После инцидента проверьте журналы доступа веб-сервера на наличие запросов к debug.log.
Типичные ошибки при защите debug.log
Самая частая ошибка — установить WP_DEBUG_DISPLAY в false, но оставить сам файл доступным по URL. Скрытие сообщений на странице не меняет права доступа к уже созданному журналу.
Другая проблема — запретить только адрес /debug.log, хотя фактический файл расположен в /wp-content/debug.log, либо добавить правило, которое не работает из-за настроек хостинга. Проверяйте реальный URL и фактический конфигурационный файл, обрабатывающий запрос.
Также опасно просто удалить лог, не устранив причину его появления. Плагин или тема могут создать его снова. После очистки проверьте, не активируют ли его повторно WP_DEBUG, переменная окружения или конфигурация инструмента разработчика.
- Не считайте отсутствие файла доказательством защиты — убедитесь, что он не создаётся повторно.
- Не меняйте права вслепую, если не понимаете, от имени какого пользователя работает PHP.
- Не оставляйте тестовые правила блокировки без проверки синтаксиса после обновления сервера.
- Не очищайте лог во время активной диагностики, если он нужен для анализа; сначала скопируйте его в защищённое место.
Частые вопросы
Достаточно ли установить WP_DEBUG_DISPLAY в false?
Нет. Эта константа скрывает ошибки в ответах страниц, но не запрещает доступ к debug.log. Нужно вынести файл за пределы публичной директории или заблокировать его на уровне веб-сервера.
Можно ли оставить WP_DEBUG включённым на production-сайте?
Только временно и под контролем, когда необходимо воспроизвести конкретную ошибку. Постоянная отладка увеличивает объём технической информации в логах, может влиять на производительность и создаёт риск утечки.
Что делать, если debug.log уже был доступен из интернета?
Закройте доступ, перенесите или удалите файл, проверьте журналы веб-сервера и кеши. Если в нём были токены, пароли или другие секреты, их необходимо отозвать и заменить. По возможности проверьте, не сохранился ли файл в резервных копиях или кеше прокси.
Какие права установить для каталога с логом?
Универсального значения нет: оно зависит от пользователя PHP и группы веб-сервера. В качестве ориентира используют каталог 750 и файл 640, но сначала необходимо правильно настроить владельца и группу. Права 777 применять не следует.
Вывод
Защита debug.log состоит из трёх действий: не показывать ошибки посетителям, хранить журнал за пределами публичной директории и проверить блокировку внешним HTTP-запросом. Для production лучше оставлять WP_DEBUG выключенным, а диагностику проводить кратковременно и под контролем.
После устранения проблемы удалите старые журналы, проверьте права доступа и убедитесь, что WordPress, Elementor, плагины и сервер не создают другие открытые логи или резервные копии. Это простая проверка, которая устраняет один из лишних каналов утечки технической информации.