R: Створена сторінка: = Оптимізація сервера для роботи з MediaWiki =
'''Мета статті:''' зменшити навантаження на сервер MediaWiki, стабілізувати роботу php8.4-fpm, обмежити агресивних ботів за швидкістю, але не закривати їм доступ повні...

2026-05-08T22:25:12Z

Створена сторінка: = Оптимізація сервера для роботи з MediaWiki = <div style="border-left: 6px solid #2b7cff; background: #eef5ff; padding: 12px; margin: 12px 0;"> '''Мета статті:''' зменшити навантаження на сервер MediaWiki, стабілізувати роботу php8.4-fpm, обмежити агресивних ботів за швидкістю, але не закривати їм доступ повні...

Нова сторінка

sudo nano /etc/php/8.4/fpm/pool.d/www.conf

$wgSessionCacheType = CACHE_ACCEL;
limit_req zone=bot_slow burst=20 nodelay;
limit_conn bot_conn 5;

}

sudo apt install php8.4-apcu

</syntaxhighlight>
У <code>LocalSettings.php</code>:
<syntaxhighlight lang="bash">
}
</syntaxhighlight>
include fastcgi_params;
$wgParserCacheType = CACHE_ACCEL;
</syntaxhighlight>
Приклад:
У <code>http { ...; fastcgi_read_timeout 300s;
apc.user_ttl=3600
</syntaxhighlight>
<syntaxhighlight lang="bash">
opcache.enable=1

}

request_slowlog_timeout = 5s
gzip_comp_level 5;
</syntaxhighlight>
== 17.; Кешування статичних файлів ==

<syntaxhighlight lang="bash">

set_real_ip_from 192.168.20.225;
sudo nano /etc/php/8.4/fpm/php.ini
Перевірити середній розмір PHP-FPM процесу:

</syntaxhighlight>

У потрібному <code>server { ...; ~*meta-webindexer 1;

}

</syntaxhighlight>

* оновити розширення <code>SyntaxHighlight</code>;
* уникати дуже великих блоків <code><syntaxhighlight></code>;
* закешувати сторінки з великими блоками коду;
* обмежити ботам швидкість доступу до <code>oldid</code>, <code>diff</code>, <code>history</code>;
* перевірити PHP-FPM slowlog.; sudo mkdir -p /var/cache/nginx/mediawiki
map $request_uri $mw_heavy_uri {
~*MJ12bot 1;

set $skip_cache 0;
server reached pm.max_children setting
pm.min_spare_servers = 12

== 3.; Коректне визначення реального IP через два Nginx ==
Якщо є собою:
<syntaxhighlight lang="bash">

Неправильний результат:
</syntaxhighlight>
Очікуваний заголовок:

<syntaxhighlight lang="bash">
<syntaxhighlight lang="nginx">
<syntaxhighlight lang="nginx">

це означає, що навантаження йде через PHP / MediaWiki.; задача — не забороняти ботам доступ через <code>403</code>, а зменшити швидкість їхніх запитів.; slowlog = /var/log/php8.4-fpm-slow.log

<syntaxhighlight lang="ini">
</syntaxhighlight>
Файл має змогу бути:
<syntaxhighlight lang="text">
oldid=
<syntaxhighlight lang="bash">
</syntaxhighlight>
=== Етап 4.; Кешування Nginx ===

proxy_send_timeout 300s;

Подивитися конкретні URL з 504:

set_real_ip_from 0.0.0.0/0;
</syntaxhighlight>
'''істотно:''' збільшення timeout не лікує причину повільної роботи, але дає довгим операціям, як ілюстрація збереженню великої сторінки, завершитися без 504.; Залишайте свій робочий варіант.; }</code> додати:

sudo grep -R "bot_heavy_key\|mw_heavy_uri\|bot_limit_key\|is_heavy_bot\|limit_req" /etc/nginx/
send_timeout 300s;
}
Special:

fastcgi_read_timeout 300s;
=== 2.4 Топ URL ===
</syntaxhighlight>
SET GLOBAL slow_query_log = 'ON';
== конфігурація php8.; 9.4-fpm ==
Перевірка:

curl -I https://wiki.example.com/wiki/Main_Page

}

ps aux | grep php-fpm | sort -k3 -nr | head -20
У PHP location:
IP frontend Nginx виступає ключовою рисою де <code>192.168.20.225 </code>.; ##

'''Помилка:'''
<syntaxhighlight lang="cron">
sudo tail -n 50000 /var/log/nginx/access.log | awk '{print $7}' | sort | uniq -c | sort -nr | head -50
</syntaxhighlight>
Формула:

##
# Heavy MediaWiki query detection
##

У backend Nginx:
<syntaxhighlight lang="php">

<div style="border-left: 6px solid #2b7cff; background: #eef5ff; padding: 12px; margin: 12px 0;">
proxy_read_timeout 300s;
add_header Retry-After 30 always;
apc.enabled=1

##
# Heavy MediaWiki URI detection
##

Disallow: /w/index.php?title=Special:
default "";

</syntaxhighlight>
<div style="border-left: 6px solid #388e3c; background: #e8f5e9; padding: 12px; margin: 12px 0;">
</syntaxhighlight>
access_log off;

##
# Limit only bots + heavy GET/HEAD requests
##

У <code>server { ...;</syntaxhighlight>
Приклад:
<syntaxhighlight lang="bash">

$wgJobRunRate = 0;

</syntaxhighlight>
~*Bytespider 1;
<syntaxhighlight lang="bash">

<syntaxhighlight lang="text">
Шукати:
~*DotBot 1;

<syntaxhighlight lang="text">

Crawl-delay: 30

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

Disallow: /*action=history

</syntaxhighlight>

~^1:0:1:GET$ $binary_remote_addr;
location ~* \.(css|js|png|jpg|jpeg|gif|ico|svg|webp|woff|woff2)$ {
proxy_set_header X-Forwarded-Proto $scheme;

php -m | grep -i apcu

Перезапуск:
Перевірка:
~*(^|&)(action=edit|action=history|action=raw|action=info|action=purge) 1;
<div style="border-left: 6px solid #d32f2f; background: #ffebee; padding: 12px; margin: 12px 0;">

</syntaxhighlight>
##
# Real client IP from frontend nginx
##

set_real_ip_from 192.168.20.225;
~*CCBot 1;
</syntaxhighlight>

##
# Bot detection
##

=== 3.2 Backend Nginx ===
MySQL / MariaDB

sudo chown -R www-data:www-data /var/www/wiki.erp.kyiv.ua/cache
У конфігу сайту, як ілюстрація:
↓
це означає, що сторінки з підсвіткою коду можуть створювати велике навантаження.; }</code>, бажано до рядків:

$wgMessageCacheType = CACHE_ACCEL;
slowlog = /var/log/php8.4-fpm-slow.log
або:

</syntaxhighlight>

apc.shm_size=256M
gzip_types text/plain text/css application/json application/javascript text/xml application/xml image/svg+xml;
=== Етап 3.; MediaWiki ===

api.php

<syntaxhighlight lang="nginx">
</syntaxhighlight>
fastcgi_cache_key "$scheme$request_method$host$request_uri";

<code>504 Gateway Timeout</code> означає, що Nginx не дочекався відповіді від upstream.; # Перевірити OPcache.;== 6.; Чому потрібен nodelay ==

# Увімкнути slow query log.; # PHP-FPM має мати достатньо воркерів.; # Перевірити повідомлення <code>server reached pm.max_children</code>.; # Винести Job Queue в cron.; # Перевірити довгі запити.;<syntaxhighlight lang="text">
<div style="border-left: 6px solid #2b7cff; background: #eef5ff; padding: 12px; margin: 12px 0;">
== 7.; Перевірка Nginx ==

</syntaxhighlight>
<syntaxhighlight lang="bash">

* чи POST не потрапляє під rate limit;
* чи достатній <code>proxy_read_timeout</code> на frontend Nginx;
* чи достатній <code>fastcgi_read_timeout</code> на backend Nginx;
* чи не впирається PHP-FPM у <code>pm.max_children</code>;
* чи не виконуються MediaWiki jobs під час веб-запиту;
* що показує PHP-FPM slowlog.; User-agent: *

# Додати кешування статичних файлів.; real_ip_header X-Real-IP;

всередину секції <code>http { ...; # Увімкнути slowlog.; }</code>:
У PHP location:

'''Перевага цього блоку:''' обмежуються тільки боти, тільки GET/HEAD-запити.; mysqladmin status

"1:HEAD" $binary_remote_addr;
</syntaxhighlight>
location @rate_limited {

default 0;

limit_conn_zone $bot_limit_key zone=bot_conn:20m;
Crawl-delay: 10
</div>

<div style="border-left: 6px solid #d32f2f; background: #ffebee; padding: 12px; margin: 12px 0;">
'''Основна ідея оптимізації MediaWiki:''' не без ускладнень збільшити кількість PHP-FPM воркерів, а зменшити кількість важких запитів, які доходять до PHP.;<div style="border-left: 6px solid #ff9800; background: #fff4e5; padding: 12px; margin: 12px 0;">
</syntaxhighlight>
</syntaxhighlight>
opcache.save_comments=1
sudo systemctl restart php8.4-fpm

real_ip_recursive on;

= Оптимізація сервера для роботи з MediaWiki =
'''Якщо в slow query log багато запитів до таблиць <code>page</code>, <code>revision</code>, <code>text</code>, <code>recentchanges</code>, <code>logging</code>, потрібно окремо аналізувати індекси, розмір таблиць і проблемні сторінки.'''
proxy_set_header Host $host;

fastcgi_cache_path /var/cache/nginx/mediawiki levels=1:2 keys_zone=MEDIAWIKI:200m inactive=60m max_size=5g;

</div>
<div style="border-left: 6px solid #ff9800; background: #fff4e5; padding: 12px; margin: 12px 0;">
<syntaxhighlight lang="text">
</syntaxhighlight>
</div>

'''Мета статті:''' зменшити навантаження на сервер MediaWiki, стабілізувати роботу php8.4-fpm, обмежити агресивних ботів за швидкістю, але не закривати їм доступ в цілому.;== 4.; Обмеження швидкості ботів без повного блокування ==
pm.max_requests = 500
fastcgi_cache_valid 200 301 302 10m;
<div style="border-left: 6px solid #ff9800; background: #fff4e5; padding: 12px; margin: 12px 0;">

##
# Rate limit zones
##

sudo tail -f /var/log/php8.4-fpm-slow.log
~*BLEXBot 1;
return 429 "Too many requests.; # Увімкнути файловий кеш.; limit_req zone=bot_heavy_slow burst=5 nodelay;

default "";

</syntaxhighlight>

'''Увага:''' FastCGI cache потрібно впроваджувати обережно, щоб не кешувати сторінки авторизованих користувачів.; '''Якщо backend Nginx бачить тільки IP frontend-проксі, то limit_req буде рахувати всіх користувачів і ботів як одного клієнта.'''
Перегляд:

<syntaxhighlight lang="text">

'''Помилка:'''
default 0;
Перезапуск:

<div style="border-left: 6px solid #ff9800; background: #fff4e5; padding: 12px; margin: 12px 0;">
Disallow: /*action=edit
gzip_min_length 1024;

</syntaxhighlight>

sudo tail -n 5000 /var/log/nginx/access.log | awk '$9 == 504 {print $1, $6, $7, $9, $12}' | tail -50

<syntaxhighlight lang="text">
expires 30d;
X-FastCGI-Cache: HIT

== 8.; Таймаути для уникнення 504 ==

pm.max_spare_servers = 30
location ~ \.php$ {
<syntaxhighlight lang="text">

Без <code>nodelay</code>:

<syntaxhighlight lang="nginx">
set $skip_cache 1;
<div style="border-left: 6px solid #d32f2f; background: #ffebee; padding: 12px; margin: 12px 0;">
Crawl-delay: 30
</div>
fastcgi_cache_valid 404 1m;
Перевірка:
map $query_string $mw_heavy_query {
Цей блок потрібно вставити у:

<syntaxhighlight lang="text">

<syntaxhighlight lang="nginx">
map "$is_heavy_bot:$mw_heavy_query:$mw_heavy_uri:$request_method" $bot_heavy_key {
<div style="border-left: 6px solid #2b7cff; background: #eef5ff; padding: 12px; margin: 12px 0;">

if ($request_method != GET) {

</syntaxhighlight>
apc.gc_ttl=3600
<syntaxhighlight lang="sql">

</syntaxhighlight>

</div>

~*/Special: 1;
proxy_send_timeout 300s;
'''robots.txt не є собою захистом від агресивних ботів.''' Але коректні боти можуть враховувати <code>Crawl-delay</code> і не сканувати важкі URL.; fastcgi_pass unix:/run/php/php8.4-fpm.sock;
<syntaxhighlight lang="nginx">

== 10. PHP-FPM slowlog ==

# Backend Nginx має бачити реальний IP клієнта.; # Обережно впровадити FastCGI cache для анонімних GET.; * * * * * /usr/bin/php /var/www/wiki.erp.kyiv.ua/maintenance/runJobs.php --maxjobs 100 --maxtime 50 > /dev/null 2>&1
=== Етап 2.; PHP-FPM ===

З <code>nodelay</code>:
Повний приклад PHP location:
<syntaxhighlight lang="bash">

~*YandexBot 1;

Після впровадження цих змін сервер має краще витримувати активність ботів, не створюючи проблем для звичайних користувачів і редакторів MediaWiki.; # Використати <code>nodelay</code>.; unknown "mw_heavy_uri" variable

'''Не варто віддавати всю RAM під PHP-FPM.''' Потрібен запас для MySQL/MariaDB.; Окремо варто відзначити Nginx, системи, файлового кешу і службових задач MediaWiki.; }</code>:
opcache.revalidate_freq=60

</div>
User-agent: GPTBot
'''істотно:''' якщо перед MediaWiki стоїть ще один Nginx, backend-сервер повинен бачити реальні IP користувачів, а не тільки IP frontend-проксі.; # Поставити <code>request_terminate_timeout = 300s</code>.; fastcgi_connect_timeout 60s;

</syntaxhighlight>
Поточні запити:
unknown "bot_heavy_key" variable

Додати cron від користувача <code>www-data</code>:

request_slowlog_timeout = 5s
'''Це одна з найважливіших оптимізацій для збереження сторінок.''' MediaWiki jobs не повинні виконуватись у звичайному веб-запиті користувача.; # Slowlog PHP-FPM і slow query log MySQL потрібні для пошуку реальної причини затримок.; pm.max_children = RAM, доступна для PHP-FPM / середній розмір одного PHP-FPM процесу
limit_req zone=bot_slow burst=20 nodelay;

Тоді можна поставити:
location / {

~^1:0:1:HEAD$ $binary_remote_addr;
<syntaxhighlight lang="bash">
}

</syntaxhighlight>
<syntaxhighlight lang="nginx">

<syntaxhighlight lang="nginx">

default 0;

</syntaxhighlight>

log_format realip_debug '$host client=$remote_addr proxy=$realip_remote_addr '

sudo nginx -t
<syntaxhighlight lang="bash">
'"$request" $status "$http_user_agent"';
fastcgi_cache_bypass $skip_cache;
fastcgi_connect_timeout 60s;
↓

</syntaxhighlight>

</syntaxhighlight>

</syntaxhighlight>
action=history
== 13.; Винесення MediaWiki Job Queue з веб-запитів ==
<syntaxhighlight lang="php">
=== Типові помилки ===

limit_req_status 429;
opcache.interned_strings_buffer=32
<syntaxhighlight lang="nginx">

location ~ \.php$ {

~*AhrefsBot 1;

~*ClaudeBot 1;
client=92.222.104.195 proxy=192.168.20.225
<syntaxhighlight lang="bash">

}

== robots.; 16.txt без повного блокування ==
<syntaxhighlight lang="nginx">
pm.max_children = 60
map "$is_heavy_bot:$request_method" $bot_limit_key {
</syntaxhighlight>
opcache.memory_consumption=256
User-agent: ClaudeBot

action=edit
include /etc/nginx/conf.d/*.conf;
<syntaxhighlight lang="nginx">
</syntaxhighlight>

</syntaxhighlight>

<syntaxhighlight lang="ini">
<syntaxhighlight lang="bash">
== 19.; SyntaxHighlight та інші важкі розширення ==

$wgShowIPinHeader = false;

=== 4.1 Повний блок для http { } ===
sudo crontab -u www-data -e
sudo systemctl reload nginx

</syntaxhighlight>

sudo tail -n 100 /var/log/nginx/error.log
}
</div>

'''Slowlog допоможе знайти реальну причину повільної роботи.''' Часто там видно <code>Parser</code>, <code>LinksUpdate</code>, <code>SpecialPage</code>, <code>SyntaxHighlight</code>, <code>api.php</code>, <code>RecentChange</code> або <code>JobQueue</code>.; # Rate limit має діяти тільки на <code>GET/HEAD</code>, не на <code>POST</code>.; }</code>:
</syntaxhighlight>
Якщо в <code>htop</code> видно процеси:
Перезапуск:

sudo systemctl reload nginx

~*(^|&)(hidebots=|limit=|from=|target=|namespace=|offset=|dir=) 1;
<syntaxhighlight lang="text">

</div>
limit_req zone=bot_slow burst=20 nodelay;
потрібно збільшити <code>pm.max_children</code>.; Рекомендований стартовий варіант:

== 21.; Рекомендований порядок впровадження ==

fastcgi_connect_timeout 60s;

# Налаштувати <code>real_ip</code> на backend Nginx.;<syntaxhighlight lang="nginx">
~*(^|&)(diff=|oldid=|curid=) 1;
</syntaxhighlight>
Це небезпечно, бо клієнти зможуть підробляти IP через HTTP-заголовки.; Або:

# Увімкнути APCu.; POST-запити, тобто збереження сторінок, не повинні потрапляти під цей rate limit.; extensions/SyntaxHighlight_GeSHi/...; # POST is not limited, so MediaWiki save actions are not affected.; # Ботів потрібно обмежувати за швидкістю, а не блокувати в цілому.; # MediaWiki jobs краще виконувати через cron.; sudo tail -f /var/log/nginx/wiki_realip_debug.log

користувач системи / бот

action=raw
У <code>http { ...; # Перевірити, що авторизовані сторінки не кешуються.; # Оптимізувати індекси або проблемні сторінки.; mysqladmin processlist
</div>

Перевірити кількість кодів відповідей:
</syntaxhighlight>
<syntaxhighlight lang="bash">

Правильний результат:
<div style="border-left: 6px solid #388e3c; background: #e8f5e9; padding: 12px; margin: 12px 0;">
Файл:

</syntaxhighlight>

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

<syntaxhighlight lang="bash">
MediaWiki
</syntaxhighlight>
sudo tail -f /var/log/mysql/mysql-slow.log
User-agent: Amazonbot

<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
<div style="border-left: 6px solid #2b7cff; background: #eef5ff; padding: 12px; margin: 12px 0;">
proxy_connect_timeout 60s;
Створити каталог:
fastcgi_send_timeout 300s;

== 1.; Типова схема роботи ==

== 5.; конфігурація server-блоку MediaWiki ==

↓
pm.max_requests = 500
<div style="border-left: 6px solid #ff9800; background: #fff4e5; padding: 12px; margin: 12px 0;">

у секції <code>http { ...; # Додати rate limit тільки для ботів і тільки для <code>GET/HEAD</code>.; Please slow down.\n";
</syntaxhighlight>

</syntaxhighlight>
<syntaxhighlight lang="text">
</syntaxhighlight>

sudo chown -R www-data:www-data /var/cache/nginx/mediawiki

</div>

opcache.validate_timestamps=1
index.php?title=
<div style="border-left: 6px solid #ff9800; background: #fff4e5; padding: 12px; margin: 12px 0;">

</syntaxhighlight>

У location з <code>proxy_pass</code>:
</syntaxhighlight>
'''Причина:''' у location застосовується <code>limit_req zone=bot_heavy_slow</code>, але в <code>http { }</code> не оголошено <code>$bot_heavy_key</code>.; Рекомендації:
request_terminate_timeout = 300s
<syntaxhighlight lang="bash">
</syntaxhighlight>
<syntaxhighlight lang="ini">
<syntaxhighlight lang="nginx">
<syntaxhighlight lang="bash">
proxy_set_header Host $host;
</syntaxhighlight>
sudo tail -n 50000 /var/log/nginx/access.log | awk -F\" '{print $6}' | sort | uniq -c | sort -nr | head -30
Перегляд:
User-agent: CCBot
~^1:1:1:GET$ $binary_remote_addr;
proxy_read_timeout 300s;
Після зміни:
Перевірка:

##
# Limit only bot GET/HEAD requests.; # Збільшити <code>proxy_read_timeout</code> і <code>fastcgi_read_timeout</code> до <code>300s</code>.; }</code> можна тимчасово додати:
sudo systemctl reload nginx
~*PetalBot 1;
<syntaxhighlight lang="php">

</syntaxhighlight>
=== 2.3 Топ User-Agent ===
<div style="border-left: 6px solid #d32f2f; background: #ffebee; padding: 12px; margin: 12px 0;">

'''Не можна робити так:'''

</div>

<syntaxhighlight lang="ini">
</syntaxhighlight>
<div style="border-left: 6px solid #d32f2f; background: #ffebee; padding: 12px; margin: 12px 0;">

sudo systemctl restart php8.4-fpm

~^1:1:0:GET$ $binary_remote_addr;
~*Amazonbot 1;
pm.max_spare_servers = 20

~*GPTBot 1;

limit_req_zone $bot_limit_key zone=bot_slow:20m rate=1r/s;
== 11.; OPcache для PHP 8.4 ==
~*Applebot 1;

</syntaxhighlight>

== Висновок ==

sudo tail -n 5000 /var/log/nginx/access.log | awk '{print $9}' | sort | uniq -c | sort -nr
sudo nano /var/www/wiki.erp.kyiv.ua/robots.txt
Crawl-delay: 30

<syntaxhighlight lang="ini">

Створити каталог:
↓
sudo systemctl restart php8.4-fpm

<syntaxhighlight lang="text">

~*anthropic-ai 1;
</syntaxhighlight>
дозволені запити проходять одразу, а зайві швидше отримують:

}
=== 9.1 Перевірка нестачі воркерів ===

</syntaxhighlight>
sudo nano /etc/nginx/sites-available/wiki.erp.kyiv.ua
Crawl-delay: 30
<syntaxhighlight lang="nginx">
<syntaxhighlight lang="bash">
}
</syntaxhighlight>
real_ip_recursive on;
<div style="border-left: 6px solid #2b7cff; background: #eef5ff; padding: 12px; margin: 12px 0;">
'''Особливо важкі запити для MediaWiki:'''
</syntaxhighlight>

<syntaxhighlight lang="nginx">

</div>

Disallow: /*action=raw

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
<div style="border-left: 6px solid #388e3c; background: #e8f5e9; padding: 12px; margin: 12px 0;">
Якщо все добре:
=== 3.3 Перевірка real IP ===
</syntaxhighlight>
</syntaxhighlight>

include fastcgi_params;

User-agent: PerplexityBot
Crawl-delay: 30
всередині <code>server { ...; # Збереження сторінок не повинно потрапляти під bot limit.; $wgFileCacheDirectory = "$IP/cache";

</syntaxhighlight>
pm.start_servers = 12
<syntaxhighlight lang="bash">
sudo nano /etc/php/8.4/fpm/pool.d/www.conf
~*PerplexityBot 1;

=== Етап 5.; База даних ===

$wgUseFileCache = true;
~*Baiduspider 1;
У PHP location додати:
ps aux | grep "php-fpm: pool" | awk '{sum+=$6; n++} END {if (n>0) print "avg:", sum/n/1024, "MB", "count:", n}'

<syntaxhighlight lang="bash">

'''Якщо 504 виникає при збереженні сторінки, потрібно перевірити:'''
fastcgi_no_cache $skip_cache;
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">

== 20.; Діагностика 504 Gateway Timeout ==
== 15.; FastCGI cache в Nginx для анонімних GET ==
</div>

Disallow: /*oldid=
sudo nano /etc/nginx/nginx.conf
sudo nano /etc/nginx/nginx.conf
<syntaxhighlight lang="bash">
"1:GET" $binary_remote_addr;

</syntaxhighlight>
<syntaxhighlight lang="text">
<syntaxhighlight lang="bash">

~^1:1:0:HEAD$ $binary_remote_addr;

=== 3.1 Frontend Nginx ===

~*ChatGPT-User 1;
htop
Рекомендовані параметри:

== 18.; Перевірка MySQL / MariaDB ==

</syntaxhighlight>

</syntaxhighlight>
</syntaxhighlight>
<syntaxhighlight lang="bash">

real_ip_header X-Real-IP;

apc.ttl=3600
=== Етап 1.; Безпечні термінові дії ===
proxy_set_header X-Real-IP $remote_addr;

php -i | grep -i opcache
<syntaxhighlight lang="text">
SET GLOBAL long_query_time = 1;

sudo nginx -t

client=192.168.20.225

php8.4-fpm
</syntaxhighlight>
~^1:1:1:HEAD$ $binary_remote_addr;

<syntaxhighlight lang="text">

limit_req zone=bot_slow burst=20;
upstream timed out while reading response header from upstream
</div>

limit_req zone=bot_slow burst=20 nodelay;

Backend Nginx
~*Special: 1;
fastcgi_cache MEDIAWIKI;

~*SemrushBot 1;

limit_req_zone $bot_heavy_key zone=bot_heavy_slow:20m rate=10r/m;
У <code>LocalSettings.php</code>:

Встановлення:
pm = dynamic
додатково істотно, щоб обмеження не зачіпали <code>POST</code>, бо збереження сторінок MediaWiki виконується саме через <code>POST</code>.;</syntaxhighlight>
</syntaxhighlight>
limit_req zone=bot_heavy_slow burst=5 nodelay;
opcache.max_accelerated_files=20000

pm.max_children = 60
</syntaxhighlight>
429 Too Many Requests

Увімкнення slow query log:

<syntaxhighlight lang="nginx">
<syntaxhighlight lang="bash">
<syntaxhighlight lang="ini">
=== 2.1 Перевірка процесів ===

</syntaxhighlight>

↓
=== 8.2 Backend Nginx ===
send_timeout 300s;
як ілюстрація:
12000 MB / 180 MB = 66

gzip on;

sudo nano /etc/php/8.4/fpm/conf.d/20-apcu.ini
</div>
sudo systemctl restart php8.4-fpm

'x_real_ip="$http_x_real_ip" '

</syntaxhighlight>

<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
=== 2.2 Топ IP за кількістю запитів ===

sudo tail -n 50000 /var/log/nginx/access.log | awk '{print $1}' | sort | uniq -c | sort -nr | head -30

Crawl-delay: 30
$wgMainCacheType = CACHE_ACCEL;
User-agent: SemrushBot

limit_req zone=bot_heavy_slow burst=5 nodelay;
Загальний статус:
fastcgi_send_timeout 300s;
pm.min_spare_servers = 10
</syntaxhighlight>
User-agent: AhrefsBot

include /etc/nginx/sites-enabled/*;
if ($query_string != "") {

Crawl-delay: 30
pm.max_children = 80

<syntaxhighlight lang="nginx">
</div>

~*facebookexternalhit 1;
== 14. File cache MediaWiki ==

sudo mkdir -p /var/www/wiki.erp.kyiv.ua/cache
На backend Nginx у файлі:

set $skip_cache 1;
захисту живих користувачів краще використовувати <code>nodelay</code> забезпечується через '''Рекомендація:'''; додатково реалізовано щоб Nginx не накопичував довгу чергу запитів.; # Перевірити, що <code>POST</code> не лімітується.; }</code> потрібно додати:

</div>
Nginx має змогу затримувати зайві запити в черзі.; Найважливіші зміни:
</syntaxhighlight>
add_header X-FastCGI-Cache $upstream_cache_status always;
додати або перевірити:
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">

proxy_pass http://BACKEND_IP;

У файлі:

~*/wiki/Special: 1;
Файл pool-конфігурації:
<syntaxhighlight lang="nginx">

</syntaxhighlight>

</syntaxhighlight>
Конфігурація:
set $skip_cache 1;

'''Увага:''' якщо PHP-FPM у вас слухає TCP, як ілюстрація <code>127.0.0.1:9000</code>, не змінюйте <code>fastcgi_pass</code> на socket.; diff=

fastcgi_read_timeout 300s;
</syntaxhighlight>
</syntaxhighlight>

proxy_set_header X-Forwarded-Proto $scheme;
Disallow: /*diff=
Пошук старих або неповних правил:

pm = dynamic

sudo journalctl -u php8.4-fpm | grep -i "max_children" | tail -20

proxy_connect_timeout 60s;
</syntaxhighlight>
fastcgi_pass unix:/run/php/php8.4-fpm.sock;

access_log /var/log/nginx/wiki_realip_debug.log realip_debug;

if ($http_cookie ~* "UserID|Token|session|mediawiki") {
fastcgi_send_timeout 300s;
=== 9.2 Як порахувати pm.max_children ===
</div>

User-agent: Bytespider

</syntaxhighlight>
Це має змогу викликати 429, затримки або навіть 504.;</div>

# Збільшити <code>pm.max_children</code>.; # Проаналізувати важкі розширення.;<syntaxhighlight lang="bash">

php-fpm: pool www

proxy_set_header X-Real-IP $remote_addr;
add_header Cache-Control "public";
sudo nano /etc/php/8.4/fpm/conf.d/10-opcache.ini
<syntaxhighlight lang="bash">

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

У розглянутій конфігурації сайт функціонує приблизно так:
Приклад:
<syntaxhighlight lang="bash">

== 2.; Діагностика навантаження ==
У <code>LocalSettings.php</code>:
}

</syntaxhighlight>

Frontend Nginx

На frontend Nginx у блоці, який прокидує запити на backend, повинно бути:
'''Причина:''' у конфігу застосовується <code>$mw_heavy_uri</code>, але не оголошено відповідний <code>map</code>.;<syntaxhighlight lang="bash">

== 12.; APCu для кешу MediaWiki ==
map $http_user_agent $is_heavy_bot {
}
error_page 429 = @rate_limited;
pm.start_servers = 10

=== 8.1 Frontend Nginx ===

Після змін:
<syntaxhighlight lang="bash">

</div>
Crawl-delay: 30
Якщо основне навантаження створюють процеси:

python3 ...; # OPcache, APCu і кешування анонімних сторінок суттєво зменшують навантаження.; sudo nginx -t
<div style="border-left: 6px solid #ff9800; background: #fff4e5; padding: 12px; margin: 12px 0;">
'xff="$http_x_forwarded_for" '

Оптимізація сервера для роботи з MediaWiki - Історія редагувань

R в 22:25, 8 травня 2026