Next.js projesini Mac’te yerel HTTPS’e hazırla

Önkoşullar

Mevcut bir Next.js projesi ve bağımlılıklarını karşılayan Node.js gerekir. Bu rehberin HTTP komutları Next.js 16.4.2 ile ayrı bir örnek projede sınandı. Aşağıdaki LocalTR adımları kullanılabilir Mac sürümü ve gerekli izinlerle uygulanır. HTTP sunucusunun çalışması HTTPS güveninin veya public paylaşımın kabulü değildir.

Önce HTTP sunucusunu aç

Proje klasöründe package.json içindeki dev komutunun next dev çalıştırdığını kontrol et. Npm seçenekleri Next’e aktarmak için aradaki -- gereklidir:

npm run dev -- --hostname 127.0.0.1 --port 3000

İkinci terminalde curl -i http://127.0.0.1:3000/ çalıştır. Örnek ana sayfada beklenen 200 ve kendi uygulamanın içeriğidir. Port doluysa sunucuyu farklı portla başlat ve sonraki eşlemeyi de o porta yap. next dev geliştirme sunucusudur; üretim hosting’i olarak kullanma.

HTTPS’i proxy tarafında ayrı kur

Doğrulanmış LocalTR kullanılabilir olduğunda çalışan HTTP servisini 3000 portuna eşle ve magaza.local gibi bir yerel isim seç. Önce adlandırılmış HTTP adresinin doğru projeyi açtığını doğrula. Ardından yerel HTTPS rehberindeki helper ve CA güven adımlarını tamamlayıp https://magaza.local adresini tarayıcıda kontrol et.

Bu akışta Next upstream’i HTTP olarak kalır. Next’in deneysel HTTPS seçeneğini açmak, LocalTR’nin sertifika güven kurulumunu doğrulamaz. Tarayıcı uyarısını geçmek veya güven kontrollerini kapatmak başarı ölçütü değildir.

Development origin ve beklenen sonuç

Dev asset/origin uyarısı görürsen gerçek kullandığın hostname’i mevcut Next yapılandırmana ekle; dosyanın diğer seçeneklerini silme. next.config.mjs için örnek:

export default {
  allowedDevOrigins: ['magaza.local'],
};

Bu değer hostname’dir; protokol, port veya path ekleme. Next’i yeniden başlat, sayfayı ve gerekli asset’leri kontrol et. Kendi projenin callback ve çerez davranışını da tam origin üzerinden ayrıca dene. Yerel HMR davranışı, public WebSocket/SSE desteğinin kanıtı değildir.

Sorun giderme ve güvenlik

Doğrudan port yanıt vermiyorsa önce Next sürecini ve portu düzelt. HTTP çalışıp .local açılmıyorsa isim/helper eşlemesini incele. Yalnız HTTPS başarısızsa hostname ve sertifika güvenini kontrol et. Origin kısıtını çözmek için tüm hostları gelişigüzel izinli yapma; gerçek müşteri verisini development uygulamasında paylaşma.

Resmî kaynaklar: Next CLI ve allowedDevOrigins. Sonraki adım, ilk yerel adres rehberini ve ardından kendi ortamındaki HTTPS sonucunu doğrulamaktır. Public erişim gerekiyorsa public URL koşullarını ayrıca incele.