Next.js'i -H ile başlatmayın: proxy arkasında sonsuz yönlendirme ve EPROTO
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
EPROTOveyawrong version numbervar 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.