İçeriğe geç
Next.js

Next.js'i -H ile başlatmayın: proxy arkasında sonsuz yönlendirme ve EPROTO

Four Software
31 Temmuz 2026
5 Dk Okuma

Bir gün canlıda şu üç şey aynı anda bozuldu: /en/projects gibi yerelleştirilmiş yollar kendilerine yönlenip sonsuz döngüye girdi, middleware'deki NextResponse.rewrite çağrıları EPROTO hatasıyla 500 döndü, ve admin girişinden sonra panel sessizce takıldı.

Üçünün de tek bir sebebi vardı: pm2 komutundaki -H 127.0.0.1 bayrağı.

Bayrak neyi değiştiriyor

Next'e bir bind adresi verdiğinizde, uygulama kendi origin'ini o adres olarak kabul ediyor — yani http://localhost:4000. Gelen isteğin Host başlığını artık dikkate almıyor.

Tek başına zararsız görünen bu davranış, bir reverse proxy arkasında zincirleme sonuçlar doğuruyor.

1. next-intl sonsuz döngüye giriyor

next-intl, isteğin hangi dile ait olduğunu URL üzerinden çözüyor ve gerekiyorsa doğru yola yönlendiriyor. Uygulama kendi adresini localhost:4000 sanınca, https://siteniz.com/en/projects isteğini "bu benim bilmediğim bir origin" diye değerlendirip yönlendirme üretiyor. Tarayıcı yönlendirmeyi izliyor, aynı sonuç tekrar üretiliyor. ERR_TOO_MANY_REDIRECTS.

2. Rewrite'lar EPROTO ile patlıyor

nginx X-Forwarded-Proto: https başlığını iletiyorsa, Next isteğin şemasını https, kendi origin'ini ise localhost:4000 olarak görüyor. Bu ikisi birleşince bir rewrite hedefi harici bir TLS adresi gibi yorumlanıyor ve uygulama kendine düz HTTP ile konuşurken TLS el sıkışması bekliyor:

Error: write EPROTO ... SSL routines:ssl3_get_record:wrong version number

Kafa karıştırıcı olan şu: hata mesajı sertifikayı işaret ediyor, oysa sertifikayla hiç ilgisi yok.

3. Auth akışı kırılıyor

NextAuth callback URL'lerini origin üzerinden kuruyor. Yanlış origin, giriş sonrası yanlış adrese dönmek demek — kullanıcı için "şifre doğru ama panele giremiyorum" gibi görünüyor.

Çözüm

Bind bayrağını kaldırın:

# yanlış
pm2 start ./node_modules/next/dist/bin/next -- start -p 4000 -H 127.0.0.1

# doğru
pm2 start ./node_modules/next/dist/bin/next -- start -p 4000

Bayrak olmadan Next Host başlığına saygı duyuyor, üç sorun da aynı anda kayboluyor.

"Ama portu dışarı kapatmam gerekiyor"

-H 127.0.0.1 kullanmanın yaygın gerekçesi bu. Ancak port erişimini uygulama katmanında değil, güvenlik duvarında çözmek gerekiyor:

ufw allow 80,443/tcp
# 4000 hiç açılmıyor

Uygulama tüm arayüzlerde dinliyor, ama dışarıdan yalnızca nginx'in geçtiği portlar erişilebilir. Aynı güvenlik, yan etkisiz.

Nasıl teşhis edilir

Bu belirtilerden birini görüyorsanız önce bind bayrağına bakın:

  • Yerelleştirilmiş yollar döngüye giriyor, kök yol çalışıyor
  • Rewrite/redirect içeren yollar 500 veriyor, statik yollar sorunsuz
  • Log'da EPROTO veya wrong version number var ama TLS'i nginx sonlandırıyor
  • Giriş başarılı görünüyor, ardından oturum kayboluyor

nginx access log'u da ayırt edici: POST /api/auth/callback 200 ardından hemen GET /admin 302 görüyorsanız sorun uygulamada değil, önündeki katmandadır.

#Next.js#nginx#pm2#next-intl#deploy