Bloga dön
17 Kasım 2026Sergei Solod11 dk okuma

Statik Next.js Sitesinde nginx’in Yüksek CPU Kullanımı: Regex Yönlendirmelerini Düzeltmek

Statik bir Next.js sitesinde nginx, regex tabanlı yönlendirme haritaları yüzünden yoğun CPU kullanıyordu. Tam anahtar aramalarının, gerçek HTTP yanıt eşdeğerliği testlerinin ve kontrollü performans ölçümlerinin eski sayfa ve medya URL’lerini korurken CPU yükünü nasıl büyük ölçüde azalttığını öğrenin.

NginxPerformansPCREYönlendirmelerNext.js

Ön uç zaten statik HTML olarak derlenmişti. nginx, oluşturulan sayfaları ve medya dosyalarını doğrudan sunuyordu; buna rağmen worker süreçleri sıradan istekleri işlerken beklenmedik ölçüde fazla CPU zamanı harcıyordu. İstek başına çalışan ve optimize edilebilecek bir Next.js render işlemi yoktu. Maliyetli işlem daha önce gerçekleşiyordu: nginx, her URL'nin giderek büyüyen eski yönlendirme kurallarından birine girip girmediğini belirlemeye çalışıyordu.

Sonunda bulduğum çözüm, eski bağlantıların çalışmasını sağladı. Sayfa yönlendirmeleri, numaralı görsel takma yolları ve video takma yolları korundu; ancak binlerce düzenli ifade karşılaştırmasının yerini az sayıda yapısal desen eşleşmesi ve hash tablosu araması aldı. Değişiklik yayına alındı ve önceki yönlendirme davranışıyla karşılaştırılarak test edildi. Tekrarlanan kontrollü bir performans testi, HTTP yanıtlarını değiştirmeden, test edilen istek karışımında nginx worker süreçlerinin CPU süresinin yüz kattan fazla azaldığını gösterdi.

Statik Next.js çıktısı neden hâlâ CPU'ya yük bindiriyordu?

Statik dışa aktarma, sayfa oluşturma işlemini istek akışından çıkarır; nginx'in yönlendirme mantığını ise ortadan kaldırmaz. nginx, bir HTML sayfasını veya görseli sunmadan önce yolu normalleştirebilir, yönlendirme haritalarını değerlendirebilir, uygun location bloğunu seçebilir, dosyaların varlığını kontrol edebilir ve yanıtı oluşturabilir. Hızlı bir dosya sistemi, her istekte tekrarlanan maliyetli URL eşleştirmelerinin yükünü telafi edemez.

Yapılandırmada zamanla iki tür eski kural birikmişti. Eski sayfalara ait bire bir takma yollar, yeni kanonik yollara yönlendiriyordu. Sayfalama takma yolları da kullanımdan kaldırılmış yolları yönlendiriyordu, ancak bunlar ortak yapısal desenlere uyuyordu. Ayrıca yeniden adlandırılmış medya yolları, isteğe bağlı görsel numaralarını yakalayan ifadeler kullanıyor; video dosya adları için de ayrı takma yol kuralları bulunuyordu. Sorun yönlendirmelerin varlığı değildi. Sorun, benzer yapıya sahip büyük yönlendirme gruplarının ayrı ayrı regex ifadeleri olarak tanımlanmış olmasıydı.

Önce benzer CPU belirtilerinin diğer nedenlerini elemek

Site sanallaştırılmış Linux üzerinde çalışıyordu; bu yüzden ilk olasılıklardan biri, hipervizör kaynaklı CPU steal süresiydi. Yük ortalamasının yüksek olmasını tek başına tanı saymak yerine CPU kullanımını, steal süresini, süreç bazında tüketimi, bellek baskısını ve disk bekleme süresini karşılaştırdım. Kullandığım temel araçlar şunlardı:

mpstat -P ALL 1 5
pidstat -u -C nginx 1 5
vmstat -w 1 6

MASTER=$(systemctl show nginx -p MainPID --value)
WORKERS=$(pgrep -P "$MASTER" -d,)
perf record -F 49 -g -p "$WORKERS" -- sleep 10
perf report --stdio --no-children -g none

Temel gözlem, nginx worker süreçlerinin kullanıcı alanında ciddi miktarda CPU tüketmesine karşılık CPU steal süresinin nispeten düşük kalmasıydı. Ölçümler, sürekli disk beklemesini veya etkin swap kullanımını başlıca açıklama olarak desteklemiyordu. Süreç bazındaki görünüm bana hangi programın meşgul olduğunu gösterdi; perf ise ne yaptığını belirlememe yardımcı oldu.

Örneklemelerden birinde CPU etkinliği örneklerinin yaklaşık üçte biri pcre_exec işlevine, ek bir bölümüyse ngx_http_regex_exec ve ngx_regex_exec işlevlerine atfediliyordu. Bunlar, nginx'in PCRE aracılığıyla düzenli ifade çalıştırırken kullanması beklenen işlevlerdir. Profil, hangi yönlendirme haritasının tek başına sorumlu olduğunu kanıtlamıyordu; ancak tekrarlanan regex değerlendirmelerinin, statik HTML oluşturmayla ilgili bir sorundan çok daha güçlü bir açıklama olduğunu gösteriyordu.

nginx map içindeki sıralı regex kurallarının gizli maliyeti

nginx'in map mekanizması kendi başına yavaş değildir. Düz metin anahtarlar verimli biçimde bulunabilir; regex girdileri ise daha yüksek öncelikli eşleşme kategorilerinden sonra, yapılandırmada tanımlandıkları sırayla değerlendirilir. Map değişkenleri başvurulduklarında değerlendirildiğinden, büyük bir regex haritasının maliyeti özellikle sonucu sık kullanılan bir istek yolunda tüketildiğinde ortaya çıkar. Eski takma yolların hiçbirine uymayan mevcut bir kanonik görsel bile, nginx dosyanın baytlarını sunmadan önce çok sayıda başarısız karşılaştırmanın maliyetini üstlenebilir.

Bu ayrım, her location ~ bloğunu saymanın neden yanıltıcı olacağını da açıklıyor. Regex ile location seçimi ve map içindeki regex değerlendirmesi farklı mekanizmalardır. Profilleme, maliyetli işin türünü ortaya koyar; isteğin izlediği yolu ve değişkenleri kullanan yerleri incelemekse bu işin nerede tetiklendiğini gösterir.

Daha ileri düzeyde yaptığım ayrıştırma, tek kaynağın medya listeleri olmadığını ortaya çıkardı. Ayrı bir sayfalama yönlendirmeleri kümesi de kendi haritası değerlendirildiğinde kayda değer miktarda regex işlemi oluşturuyordu. Yalnızca görselleri optimize etseydim bu bağımsız maliyet yerinde kalacaktı.

Sayfa yönlendirmeleri: tek sayfalama deseni, binlerce ayrı hedef

Sayfa kuralları tekrarlıydı: yollar eski tanımlayıcıya göre değişiyor ve sonları /topics/old-a/page/99 gibi bir sayfalama desenine uyuyordu. İlk bakışta cazip gelen çözüm, 99 değerini alıp yeni slug'ın sonuna eklemekti. Fakat bu yanlış olurdu. Bazı eski sayfalama kuralları, istenen sayfa numarası 3 de olsa 99 da olsa, her sayfa numarasını bilerek /topics/current-a/page/7 gibi sabit bir son sayfaya yönlendiriyordu.

Başka bir önemli kısıt daha vardı: nginx, map içindeki tam anahtar eşleşmelerine regex kurallarından daha yüksek öncelik verir. Bazı tam eşleşme girdileri, genel sayfalama kuralının sonucunu geçersiz kılıyordu. Bazılarıysa zaten kanonik olan bir yolun yönlendirilmesini önlemek için açıkça boş dizeye eşlenmişti. Yalnızca dönen hedefin boş olup olmadığına bakmak, hiçbir tam eşleşmenin bulunmaması ile değeri boş olan bir tam eşleşmenin bulunması arasındaki farkı ortadan kaldırırdı.

Yeni çözüm, yolun tanınmasını hedefin seçilmesinden ayırdı. Aşağıdaki örnek, nginx'in http bağlamında tanımlanan haritalarının sadeleştirilmiş ve temsili bir gösterimidir:

# http context: synthetic page aliases
map $uri $normalized_path {
    default $uri;
    ~^(.+)/$ $1;
}

map $normalized_path $exact_target {
    default "__NO_EXACT__";
    /topics/old-a        /topics/current-a;
    /topics/old-a/page/2 /topics/current-a/page/2;
    /topics/old-b/page/2 "";
}

map $normalized_path $pagination_key {
    default "";
    ~^/(?<old_root>topics/[a-z0-9-]+)/page/[1-9][0-9]*$ /$old_root;
}

map $pagination_key $pagination_target {
    default "";
    /topics/old-a /topics/current-a/page/7;
    /topics/old-b /topics/current-b/page/6;
}

map $exact_target $redirect_target {
    default $exact_target;
    __NO_EXACT__ $pagination_target;
}

İlk harita, yol sonundaki eğik çizginin normalleştirilmesini korur. İkincisi, tam yönlendirmeleri ve değeri açıkça boş bırakılmış istisnaları saklar; özel bir işaretçi değer, hiçbir tam eşleşme bulunmadığını gösterir. Üçüncüsü, tek bir regex ile sayfalama yolunun kökünü çıkarır. Dördüncüsü, bu kökü tam anahtar aramasıyla önceki sabit hedefe eşler. Son olarak seçici, sayfalama sonucuna bakmadan önce, değeri boş olan istisnalar dâhil tüm tam eşleşmelere öncelik verir.

Yönlendirmeyi yapan sunucu, elde edilen $redirect_target değerini yalnızca boş olmadığında kullanabilir; mevcut politika sorgu dizelerini koruyorsa özgün HTTP durum kodunu da koruyarak $is_args$args ekleyebilir. Özel işaretçi değerin gerçek bir hedefle asla çakışmaması için ayrılması ve doğrulanması gerekir. Örnekte tarafsız yol adları kullanılıyor; üretimdeki oluşturucunun ise kendi eksiksiz eşleme listesini ve mevcut öncelik sırasını koruması gerekiyordu.

Bu tasarımda büyük-küçük harf davranışını gözden kaçırmak kolaydır. nginx, map içindeki düz metin anahtarları harf büyüklüğünü dikkate almadan karşılaştırırken ~ ile yazılmış regex kuralları büyük-küçük harfe duyarlıdır. Dolayısıyla tüm URL'leri gelişigüzel küçük harfe çevirmek veya bir ~ kuralını ~* biçimine dönüştürmek, eşdeğer bir sonuç elde edildiği anlamına gelmez. Yeni yapı, özgün eşleştirme davranışını yeniden üretmelidir.

Görsel ve video yönlendirmeleri: yolu bir kez ayrıştır, ardından eski anahtarı ara

Medya kuralları da benzer biçimde yararlanılabilecek bir yapıya sahipti. Eski bir görsel yolunda galeri tanımlayıcısı hem dizinde hem de dosya adında bulunuyor, sonuna isteğe bağlı sayısal bir ek gelebiliyordu: /old-gallery/old-gallery-17.avif. Hedef yol aynı sayısal eki koruyor, ancak dizini ve dosya adı önekini değiştiriyordu. Her eski galeri ve her ek biçimi için ayrı regex üretmek, aynı sözdizimini paylaşan karşılaştırmalara gereksiz CPU harcanmasına neden oluyordu.

Daha verimli bir harita, tanımlayıcıyı ve isteğe bağlı eki tek bir regex ile çıkarır; ardından yeni öneki bulmak için düz metin anahtar araması kullanır:

# http context: synthetic AVIF rename inventory
map $uri $legacy_image_key {
    default "";
    ~^/(?<old_id>[a-z0-9-]+)/\k<old_id>(?<image_number>-[0-9]+)?\.avif$ $old_id;
}

map $legacy_image_key $new_image_prefix {
    default "";
    old-gallery /new-gallery/new-gallery;
    old-set     /new-set/new-set;
}

# A recognized alias now has a target candidate:
# $new_image_prefix$image_number.avif
# Existing-file checks and the actual 301 remain
# in the site's media-serving configuration.

Tanınan bir takma yol için /old-gallery/old-gallery-17.avif, hedef adayı olarak /new-gallery/new-gallery-17.avif üretir. Bu, arama mekanizmasıdır; dosya sunma politikasının tamamı değildir. Gerçek dağıtımda mevcut dosyalara öncelik verilmesi, hedef dosyanın varlığının kontrolü ve 301 yönlendirme kararı, medya sunma yapılandırmasının parçası olmaya devam etti. Hedef dosya mevcut değilse, basitleştirilmiş örnekte koşulsuz 301 döndürmek yanlış olurdu.

Video yönlendirmelerinde de dosya adı biçimini tanıyan tek bir regex'in arkasında benzer bir tam anahtar tablosu kullanıldı. Eski takma yol aramasını görsel eşlemesine uyarlayan mevcut WebP uyumluluk yolunun da korunması gerekiyordu. Medya optimizasyonunun başarılı sayılabilmesi için güncel dosyaların doğru baytları ve başlıkları döndürmesi, eski bir video takma yolunu izleyen aralık isteklerinde de 206 Partial Content desteğinin sürmesi gerekir.

Bu örnekler yalnızca eski dosya listelerinin öngörülebilir bir dosya adı düzenini izlemesi sayesinde işe yarıyor. Dosyalar birbirinden bağımsız ve keyfî biçimde yeniden adlandırılmış olsaydı güvenli tasarım, dosya bazında tam anahtarlar, oluşturulmuş bir indeks veya başka bir sınırlandırılmış arama yöntemi kullanırdı. Ortak bir desen bulunmayan hedefleri tek regex ile yeniden oluşturabileceğimizi varsaymak doğru olmazdı.

Ayrı 410 haritasına ne oldu?

Yapılandırmanın başka bir bölümü, yalnızca 410 Gone döndürmek amacıyla kullanımdan kaldırılmış sayfa desenlerini tek tek listeliyordu. Mevcut statik dosya yönlendirme politikasının gerçekten bulunmayan sayfalar için zaten 410 döndürdüğü doğrulandıktan sonra bu özel harita kaldırıldı. Eski sayfaların kullanımdan kaldırıldığına ilişkin üstveriler doğrulama için tutuldu; kaldırılan tek şey, istek sırasında yapılan gereksiz eşleştirmeydi.

Bu, yapılandırmaya özgü bir karardır; nginx'in varsayılan davranışı değildir. Başka türlü ayarlanmadığı sürece yalın bir try_files çoğu zaman 404 ile sonuçlanır. Açık bir 410 kuralını kaldırmak, ancak gerçek sunucuda bulunmayan kaynakların izlediği yolun, kullanımdan kaldırılmış sayfalama URL'leri ve olası iç hata sayfası işlemleri dâhil, gerekli 410 yanıtını üretmeye devam etmesi durumunda güvenlidir. Değişiklik kabul edilmeden önce bu koşul gerçek HTTP istekleriyle kontrol edildi.

Daha hızlı yönlendirme haritasının öncekiyle aynı davrandığı nasıl kanıtlanır?

Sözdizimi geçerli bir nginx yapılandırması bile binlerce eski bağlantıyı fark ettirmeden bozabilir. Bu nedenle yeni çözümde, özgün kural listeleri doğruluk için bağımsız girdi olarak kullanıldı; optimize edilmiş çıktılardan yeniden türetilen hedefler esas alınmadı. Oluşturulan arama tabloları yinelenen anahtarlar, desteklenmeyen ifadeler, tutarsız görsel önekleri ve güncelliğini yitirmiş oluşturulmuş dosyalar açısından kontrol edildi. Güvenli biçimde temsil edilemeyen kurallar sessizce kaybolmamalı; oluşturma işlemini hatayla durdurmalıydı.

Test matrisi; tam sayfa takma yollarını, kanonik yollar için boş değerli istisnaları, birbiriyle örtüşen sayfalama kurallarını, sabit sayfalama üst sınırlarını, geçerli ve geçersiz sayfa numaralarını, sondaki eğik çizgileri, büyük-küçük harf varyasyonlarını ve sorgu dizelerini kapsıyordu. Medya içinse numarasız ve numaralı görseller, başında sıfır bulunan sayısal ekler, sonunda rakam olan tanımlayıcılar, iç içe geçmiş hedef yollar, WebP uyumluluğu ve özgün video takma yolları test edildi. Dosya sunumunun önemli olduğu durumlarda gerçekten okunabilen test dosyaları kullanılarak yanıt gövdeleri, yönlendirmeler, önbellekle ilgili başlıklar ve video bayt aralıkları karşılaştırıldı.

En önemlisi, bunlar yalnızca JavaScript içinde yapılan dize karşılaştırmaları değil, gerçek nginx HTTP kontrolleriydi. Yeni yapılandırma oluşturulan istek matrisi boyunca sınandı; ayrı bir istek kümesi ise PCRE tabanlı eski yapılandırmaya karşı kontrol edildi. Bildirilen sonuç, istenmeyen yanıt farklılığı sayısının sıfır olmasıydı. Yayına alma sonrasındaki temel üretim kontrolleri de optimize edilmiş include dosyalarının etkin, eski uzun regex tablolarının ise devre dışı olduğunu doğruladı.

Kontrollü performans testi, iyileşmeyi trafik değişiminden ayırdı

Yayına alma sonrasında üretim ortamındaki CPU grafikleri belirgin biçimde iyileşti; ancak istek hacmi ve isteklerin dağılımı da değişmişti. Önceki yoğun bir ölçümle daha sonraki sakin bir ölçümü karşılaştırmak, yapılandırma değişikliğine atfedilebilecek iyileşmeyi olduğundan büyük gösterirdi.

Arama maliyetini diğer etkenlerden ayırmak için bağımsız bir performans testinde aynı nginx çalıştırılabilir dosyası kullanıldı; aynı karma istek dizisi eski ve optimize edilmiş yapılandırmalarda tekrarlandı. Dizide kanonik sayfalar, eski sayfa takma yolları, sayfalama takma yolları, bulunmayan sayfalar, kanonik görseller, eski görsel ve video takma yolları ile bulunmayan medya dosyaları vardı. Çalıştırmalar eski, yeni, yeni, eski sırasıyla iç içe geçirildi; yanıt durum kodları ve Location değerleri eşleşti.

Bu kontrollü iş yükünde optimize edilmiş haritalar, regex ağırlıklı eski haritaların nginx worker CPU süresinin yüzde birinden daha azını tüketti; sonuç tekrarlanan çalıştırmalarda da elde edildi. Bu, söz konusu istek karışımında yönlendirme işleme değişikliğinin etkisini güçlü biçimde ölçüyor. Ancak bu sonuç, üretimdeki her isteğin 100 kat hızlandığı veya rastgele bir trafik dağılımında sunucunun toplam CPU kullanımının aynı oranda düşeceği anlamına gelmiyor.

Daha sonraki sistem kontrolleri, nginx'in az CPU kullandığını, disk baskısının düşük olduğunu ve işlemcide bol miktarda boş kapasite bulunduğunu gösterdi. Önceki PCRE darboğazı, değişiklik sonrasında alınabilen örneklerde artık baskın değildi. Ancak kullanım bu kadar düşükken örnek sayısı da az olduğundan işlev bazındaki yüzdeleri fazla yorumlamamak gerekir. Çözümün işe yaradığını gösteren daha güçlü kanıtlar, kontrollü karşılaştırma, yanıt eşdeğerliği testleri ve başarılı dağıtımdır.

Çok sayıda nginx yönlendirmesini daha güvenli biçimde taşımak

Çok sayıda eski URL'si olan başka bir sitede bu geçişi olabildiğince mekanik yürütürdüm: özgün kural listesini saklar, ortak yol sözdizimlerinin az sayıdaki türünü belirler, her birini sınırlı kapsamlı bir regex'e dönüştürür ve hedefleri düz metin anahtarlı haritalarda tutardım. Kanonik yollar için tam eşleşmeli istisnaları, HTTP durum kodlarını, mevcut dosya kontrollerini, sorgu dizelerini, ana makine adının kanonikleştirilmesini ve büyük-küçük harf duyarlılığını rastlantısal uygulama ayrıntıları değil, dışarıya yansıyan davranışın parçaları olarak ele alırdım.

Ardından oluşturulan yapılandırmanın tamamını nginx -t ile doğrular, eski ve yeni davranışları gerçek nginx üzerinden karşılaştırır, aynı isteklerle performans testi yapar ve geri yüklenebilir bir yedekle, yeniden yükleme sonrasındaki kontrolleri planlayarak dağıtıma geçerdim. Bir yönlendirme yapısal şemayla temsil edilemiyorsa onu sessizce atmak yerine, dar kapsamlı bir istisna veya URL bazında tam eşleşmeli bir girdi kullanırdım.

Tanıyı doğru koymayı sağlayan yaklaşım değişikliği, statik dosya sunmanın ve düşük maliyetli yönlendirme yapmanın ayrı özellikler olduğunu fark etmekti. Next.js, sayfa oluşturma işini zaten tamamlamıştı ve nginx dosyaları verimli biçimde sunabiliyordu. Eksik kalan optimizasyon, bu dosyalar sunulmadan önce yapılan aramaydı. Eski bağlantıları korurken bu aramayı hızlandırmak mümkündü.

Öncelik ve değerlendirme kurallarının ayrıntıları için resmi nginx belgelerindeki map modülü ve HTTP çekirdek modülünde location seçimi bölümlerine bakabilirsiniz.