Файл 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.
Якщо в журналі вже з'явилися паролі, токени, email-адреси або дані форм, вважайте їх скомпрометованими. Видалення файлу не скасовує можливе копіювання його вмісту, тому за потреби відкличте токени та змініть секрети.
- Не вмикайте 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. Потрібно винести файл за межі public directory або заблокувати його на рівні веб-сервера.
Чи можна залишити WP_DEBUG увімкненим на production-сайті?
Лише тимчасово й під контролем, коли потрібно відтворити конкретну помилку. Постійне налагодження збільшує обсяг технічної інформації в логах, може впливати на продуктивність і створює ризик витоку.
Що робити, якщо debug.log уже був доступний з інтернету?
Закрийте доступ, перенесіть або видаліть файл, перевірте журнали веб-сервера та кеші. Якщо у ньому були токени, паролі або інші секрети, їх потрібно відкликати й замінити. За можливості перевірте, чи файл не зберігся у резервних копіях або кеші проксі.
Які права встановити для каталогу з логом?
Універсального значення немає: воно залежить від користувача PHP та групи веб-сервера. Як орієнтир використовують каталог 750 і файл 640, але спочатку потрібно правильно налаштувати власника та групу. Права 777 застосовувати не слід.
Висновок
Захист debug.log складається з трьох дій: не показувати помилки відвідувачам, зберігати журнал поза публічною директорією та перевірити блокування через зовнішній HTTP-запит. Для production найкраще залишати WP_DEBUG вимкненим, а діагностику проводити короткочасно й контрольовано.
Після виправлення проблеми видаліть старі журнали, перевірте права доступу та переконайтеся, що WordPress, Elementor, плагіни й сервер не створюють інші відкриті логи або резервні копії. Це проста перевірка, яка прибирає один із зайвих каналів витоку технічної інформації.