İçeriğe geç
zefıly
← Tüm yazılar

Next.js'i kendi sunucunuzda barındırmak, Vercel olmadan

5 dk okuma

Next.js, Node.js olan her sunucuda çalışır. Standalone çıktı nasıl derlenir, sizin yerinize kopyalamadığı iki klasör, nginx arkasında servis olarak nasıl çalıştırılır ve önbellek ile akış hakkında bilinmesi gerekenler. Next.js 16 ile denendi.

Next.js'in Vercel'e ihtiyacı yoktur. next build, her yerde çalışan bir Node.js sunucusu üretir ve bütün özellikler onda çalışır: sunucu bileşenleri, sunucu eylemleri, görsel iyileştirme, artımlı yeniden doğrulama. Sizin devraldığınız, bir platformun sizin yerinize yaptığı kısımdır: süreç, vekil, HTTPS ve dağıtımlar.

Buradaki adımları 12 Kasım 2026'da create-next-app ile oluşturulan yeni bir projeyle denedik; proje Next.js 16.4.6 kurdu, Node.js 24 üzerinde.

Kısaca

  • output: "standalone" ayarlayın ve .next/standalone klasörünü dağıtın: denememizde 39 MB; node_modules ise 366 MB.
  • Standalone klasörü public/ ve .next/static/ klasörlerini içermez. İçine kopyalayın; yoksa sitede stil ve görsel olmaz.
  • PORT ve HOSTNAME ayarlı olarak node server.js ile başlatın.
  • 127.0.0.1 üzerinde systemd servisi olarak çalıştırın ve HTTPS için önüne nginx koyun.
  • Tek sunucu: önbellek kendiliğinden çalışır. Birden çok sunucu: ortak bir önbellek işleyicisi gerekir.

1. Standalone çıktıyı derleyin

next.config.ts içinde:

const nextConfig: NextConfig = {
  output: "standalone",
};
npm ci
npm run build

Next.js, sunucunun gerçekten ihtiyaç duyduğu dosyaları izler ve .next/standalone içine yazar:

node_modules  package.json  server.js

Denememizde bu klasör 39 MB idi. Projenin tam node_modules klasörü 366 MB. Küçük olanı dağıtırsınız ve sunucuda hiç npm install çalıştırmazsınız.

2. Eksik iki klasörü kopyalayın

Herkesin bir kez atladığı adım budur. Standalone klasörü statik dosyaları dışarıda bırakır, çünkü Next.js bunları bir CDN'in sunmasını bekler. Kendi sunucunuzda içine kopyalayın:

cp -r public .next/standalone/
cp -r .next/static .next/standalone/.next/

Bu olmadan sayfalar düz HTML olarak açılır: CSS yok, JavaScript yok, görsel yok.

3. Başlatın

cd .next/standalone
PORT=3000 HOSTNAME=127.0.0.1 node server.js
▲ Next.js 16.4.6
- Local:         http://127.0.0.1:3000
✓ Ready in 0ms

HOSTNAME=127.0.0.1, sunucunun yalnızca yerelde dinlemesini sağlar. Tek giriş yolu öndeki web sunucusudur.

Denememizde statik bir sayfa şu başlıklarla yanıt verdi:

x-nextjs-cache: HIT
Cache-Control: s-maxage=31536000

4. Servis olarak çalıştırın

Bir terminal oturumunda başlatmayın. systemd birimi, çökme ya da yeniden başlatma sonrasında onu tekrar çalıştırır. /etc/systemd/system/myapp.service:

[Unit]
Description=My Next.js app
After=network.target

[Service]
User=myapp
WorkingDirectory=/home/myapp/app/.next/standalone
Environment=NODE_ENV=production
Environment=PORT=3000
Environment=HOSTNAME=127.0.0.1
EnvironmentFile=/home/myapp/app/.env
ExecStart=/usr/bin/node server.js
Restart=always

[Install]
WantedBy=multi-user.target
sudo systemctl enable --now myapp

root olarak değil, kendi Linux kullanıcısıyla çalıştırın. Next.js SIGTERM sinyalini kendisi işler: yeni bağlantı almayı bırakır ve süren istekleri bitirir; yeniden başlatma ziyaretçilerin bağlantısını kesmez.

5. Önde nginx

server {
    server_name example.com;

    location /_next/static/ {
        alias /home/myapp/app/.next/standalone/.next/static/;
        expires 1y;
        add_header Cache-Control "public, immutable";
    }

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_buffering off;
    }
}

İki ayrıntı:

  • Statik dosyalar nginx'ten. /_next/static/ altındaki dosyaların adında özet (hash) vardır ve hiç değişmezler. nginx bunları Node.js'ten hızlı sunar ve uzun önbellek süresi güvenlidir.
  • proxy_buffering off. Next.js sayfaları akıtır: önce iskelet, yavaş kısımlar sonra. Yanıtın tamamını tamponlayan bir vekil bu yararı ortadan kaldırır. Next.js belgeleri aynı etki için uygulamadan X-Accel-Buffering: no başlığı göndermeyi önerir.

6. Ortam değişkenleri

  • NEXT_PUBLIC_ ile başlayan değişkenler JavaScript'e derleme sırasında yazılır. Değiştirmek yeni bir derleme ister.
  • Diğerlerini sunucu çalışırken okur. Değiştirmek için yeniden başlatmak yeter.

Yani dağıttığınız ortamın genel değerleriyle derleyin.

7. Önbellek ve birden çok sunucu

Next.js önbelleğini (oluşturulmuş sayfalar, çekilen veriler) bellekte ve diskte .next/cache içinde tutar. Tek sunucuda bu hiçbir ayar gerektirmeden çalışır.

Yük dengeleyici arkasında birden çok sunucu varsa her birinin kendi önbelleği olur ve birindeki yeniden doğrulama diğerlerine ulaşmaz. Bunun için Next.js, next.config içinde önbelleği Redis gibi ortak bir yerde tutan bir cacheHandler belirlemenize izin verir. Oradan başlamayın. Tek sunucu çok şey taşır.

8. Dağıtımlar

Basit ve güvenli bir sıra:

  1. Çalışan klasörde değil, yeni bir klasörde derleyin (releases/2026-11-13-1).
  2. public ve .next/static klasörlerini standalone klasörüne kopyalayın.
  3. current simgesel bağlantısını yeni sürüme çevirin.
  4. systemctl restart myapp.
  5. Uygulama yanıt vermezse bağlantıyı geri çevirip yeniden başlatın.

Sunucuda yalnızca yeterli bellek varsa derleyin: next build, uygulamayı çalıştırmaktan çok daha fazlasını ister. Küçük bir VPS'te CI'da derleyin ve standalone klasörünü yükleyin.

Zefily ile

Zefily'de bir Next.js + PostgreSQL başlangıç yığını vardır: ön vekil olarak nginx, Node.js 24 ve PostgreSQL. Bir Git deposu bağlarsınız; her dağıtım yeni bir sürüm derler, onu sitenin kendi kullanıcısı altında yerel bir portta yönetilen bir systemd servisi olarak başlatır ve uygulama yanıt vermezse önceki sürüme döner. Diğer Node uygulamaları (Nuxt, SvelteKit, Astro, Express) aynı şekilde çalışır. Node.js ve Python uygulamaları ve GitHub'dan dağıtım belgelerine bakın.

Sık sorulan sorular

Next.js'i Vercel olmadan barındırabilir miyim?

Evet. next build, Node.js olan her makinede çalışan bir Node.js sunucusu üretir. Sunucu bileşenleri, sunucu eylemleri, görsel iyileştirme ve yeniden doğrulama kendi sunucunuzda da çalışır.

Next.js'te output standalone ne yapar?

server.js ve yalnızca uygulamanın ihtiyaç duyduğu node_modules dosyalarını içeren bir .next/standalone klasörü yazar. Denememizde 366 MB yerine 39 MB idi.

Kendi sunucumdaki Next.js sitesinde neden CSS yok?

Standalone klasörü public/ ve .next/static/ klasörlerini içermez. server.js'i başlatmadan önce ikisini de .next/standalone içine kopyalayın.

Standalone Next.js sunucusunun portunu nasıl değiştiririm?

node server.js çalıştırmadan önce PORT ortam değişkenini, dinlenecek adres için de HOSTNAME değişkenini ayarlayın.

Next.js'i kendi sunucumda çalıştırmak için Redis gerekir mi?

Tek sunucuda gerekmez; yerleşik önbellek yeter. Ortak önbellek işleyicisi yalnızca aynı uygulamayı birden çok sunucu çalıştırdığında gerekir.

Zefily'nin kurduğu başlangıç yığınları için Uygulama yığınları belgesine bakın.

Diğer yazılar

Muhteşem Kasım · Siber Pazartesi

Gitmeden önce: ömürlük paketler indirimde

Ömürlük paketi bir kez ödeyin ya da yıllık paketlerin ilk yılında %30 indirim alın.

Paket başına yalnızca 100 ömürlük paket satılır. Bitince biter.

Kampanyayı inceleyin

Muhteşem Kasım

Kampanyayı inceleyin →