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/standaloneklasörünü dağıtın: denememizde 39 MB;node_modulesise 366 MB.- Standalone klasörü
public/ve.next/static/klasörlerini içermez. İçine kopyalayın; yoksa sitede stil ve görsel olmaz. PORTveHOSTNAMEayarlı olaraknode server.jsile 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 uygulamadanX-Accel-Buffering: nobaş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:
- Çalışan klasörde değil, yeni bir klasörde derleyin (
releases/2026-11-13-1). publicve.next/staticklasörlerini standalone klasörüne kopyalayın.currentsimgesel bağlantısını yeni sürüme çevirin.systemctl restart myapp.- 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.