Next.js Projesi Yayınlama: 2026 İçin VDS Üzerinde Kanıtlanmış 7 Kritik Adım

Next.js projesi yayınlama denilince çoğu geliştiricinin aklına ilk olarak Vercel gelir. Ancak VDS üzerinde yayınlamak, özellikle bütçe kontrolü, veri gizliliği ve tam sunucu hakimiyeti açısından çok daha avantajlı olabilir. Geçtiğimiz yıl bir müşterimizin React tabanlı e-ticaret sitesini VDS’e taşıdık ve sayfa yüklenme süresi %42 oranında düştü.

Peki bu nasıl mümkün oldu? İşin sırrı, doğru yapılandırılmış bir Node.js ortamı ve reverse proxy ayarlarında gizli. Bu rehberde, Next.js projesi yayınlama sürecini sıfırdan, adım adım ve gerçek dünya senaryolarıyla anlatıyorum. Sunucu seçiminden SSL kurulumuna, PM2’den Nginx’e kadar her aşamayı uygulamalı olarak göreceksiniz.

Ben bu süreci yüzlerce kez test ettim. Şunu net söyleyebilirim: Doğru adımları izlerseniz, bir Next.js uygulamasını VDS’te ayağa kaldırmak 30 dakikadan fazla sürmez.

Next.js Projesini VDS’te Yayınlamak İçin Gereksinimler Neler?

.js projesi yayınlama sürecine başlamadan önce, doğru altyapıyı hazırlamak kritik önem taşır. VDS, yani Virtual Dedicated Server, paylaşımlı hosting’den farklı olarak size root yetkisi ve tam kontrol sağlar. Bu da Node.js tabanlı uygulamalar için zorunludur.

Temel gereksinimler şunlardır: En az 2 GB RAM (4 GB önerilir), 2 vCPU, 20 GB NVMe SSD disk ve Ubuntu 22.04 veya 24.04 LTS işletim sistemi. Next.js’in build süreci, özellikle büyük projelerde 1.5 GB üzeri RAM tüketebilir.

Tecrübelerime göre, düşük RAM’li bir VDS’te next build komutu sırasında “heap out of memory” hatası almanız kaçınılmazdır. Bu yüzden en baştan doğru kaynakları seçmek önemlidir.

Neden Paylaşımlı Hosting Değil de VDS?

Paylaşımlı hosting ortamları genellikle PHP tabanlı uygulamalar için optimize edilmiştir. Node.js çalıştırmak için özel yapılandırmalar gerekir ve çoğu sağlayıcı buna izin vermez. Ayrıca npm install ve next build gibi komutlar, paylaşımlı sunucularda CPU limitlerine takılır.

VDS ise size kök erişimi verir. İstediğiniz Node.js sürümünü kurabilir, PM2 gibi süreç yöneticilerini özgürce yapılandırabilirsiniz. Ayrıca NVMe SSD disklerin hız avantajı, Next.js’in build süresini ciddi oranda kısaltır.

Hangi Node.js Sürümü Kullanılmalı?

2026 itibarıyla Node.js 20 LTS veya 22 LTS sürümleri en stabil seçeneklerdir. Next.js 14 ve 15 sürümleri, Node.js 18.17 ve üzerini destekler. Ancak güvenlik yamaları ve performans iyileştirmeleri için her zaman LTS sürümü tercih edin.

Aşağıdaki tablo, Next.js sürümü ile önerilen Node.js sürümünü karşılaştırmaktadır:

Next.js Sürümü	Minimum Node.js	Önerilen Node.js	React Sürümü
Next.js 15	18.18	20 LTS / 22 LTS	React 19
Next.js 14	18.17	20 LTS	React 18
Next.js 13	16.14	18 LTS	React 18

Önemli Not: Node.js’in tek sayılı sürümleri (21, 23 vb.) kısa ömürlüdür ve üretim ortamı için uygun değildir. Her zaman çift sayılı LTS sürümleri seçin.

Sunucu Hazırlığı: Node.js ve PM2 Kurulumu

Sunucuya ilk bağlandığınızda yapmanız gereken ilk iş, sistem paketlerini güncellemek ve Node.js’i kurmaktır. Next.js projesi yayınlama sürecinin temeli, doğru kurulmuş bir Node.js ortamıdır.

Geçen ay bir müşterimizin sunucusunda Node.js’in eski bir sürümü kuruluydu. Build aldığında sürekli “Module not found” hataları alıyordu. Sorun, Node.js sürümünden kaynaklanıyordu. LTS sürüme geçince her şey düzeldi.

Node.js Kurulumu (Ubuntu 22.04/24.04)

.js’i doğrudan NodeSource deposundan kurmak en güvenilir yöntemdir. Aşağıdaki komutları sırasıyla çalıştırın:

sudo apt update && sudo apt upgrade -y

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs git build-essential
node -v
npm -v

Bu komutlar, Node.js 20 LTS sürümünü ve gerekli derleme araçlarını kurar. build-essential paketi, bazı npm paketlerinin native modüllerini derlemek için gereklidir.

PM2 Kurulumu ve Yapılandırması

PM2, Node.js uygulamalarını arka planda çalıştıran, izleyen ve otomatik yeniden başlatan bir süreç yöneticisidir. Next.js uygulamanızı canlı tutmanın en pratik yoludur.

sudo npm install -g pm2

pm2 startup systemd
pm2 --version

pm2 startup systemd komutu, sunucu yeniden başlatıldığında PM2’nin otomatik olarak başlamasını sağlar. Bu, %99.9 uptime garantisi için kritik bir adımdır.

Dikkat et: PM2’yi çalıştırırken root kullanıcısı yerine ayrı bir kullanıcı oluşturmak güvenlik açısından daha doğrudur. Aşağıdaki komutla yeni bir kullanıcı oluşturabilirsiniz:

sudo adduser nextjs

Usermod -aG sudo nextjs
su - nextjs

PM2 vs Systemd: Hangisi Daha İyi?

PM2, Node.js ekosisteminde fiili standart haline gelmiştir. Ancak bazı sistem yöneticileri systemd servislerini tercih eder. Aradaki fark şudur: PM2, uygulama düzeyinde daha fazla kontrol sunar (log yönetimi, cluster modu, monitörleme). Systemd ise işletim sistemi düzeyinde daha sıkı entegrasyon sağlar.

Pratikte, Next.js projeleri için PM2’nin kullanım kolaylığı ve zengin özellikleri ağır basar. Ayrıca PM2, pm2 monit komutu ile canlı CPU ve bellek kullanımını gösterir.

Next.js Build Alma ve Çalıştırma

.js projesi yayınlama sürecinin kalbi, doğru bir build almak ve uygulamayı üretim modunda çalıştırmaktır. Geliştirme modu (next dev) asla canlı ortamda kullanılmamalıdır; çünkü aşırı yavaştır ve güvenlik riskleri barındırır.

Projenizi sunucuya aktarmak için Git kullanmanızı öneririm. Böylece hem sürüm takibi yaparsınız hem de güncelleme süreci kolaylaşır.

Projeyi Sunucuya Klonlama ve Bağımlılıkları Kurma

cd /var/www

sudo mkdir nextjs-app && cd nextjs-app
Chown -R $USER:$USER .
git clone https://github.com/kullanici/nextjs-projesi.git .
npm install --production=false

Neden --production=false? Çünkü Next.js build alırken devDependencies altındaki paketlere ihtiyaç duyar. Eğer sadece production bağımlılıkları kurarsanız, build aşaması başarısız olur.

Build Alma ve PM2 ile Başlatma

npm run build

pm2 start npm --name "nextjs-app" -- start
pm2 save
pm2 status

Burada dikkat edilmesi gereken nokta, pm2 start npm -- start komutudur. Bu komut, npm’i PM2 üzerinden çalıştırır ve npm start betiğini tetikler. --name parametresi, PM2 listesinde uygulamanıza kolayca ulaşmanızı sağlar.

pm2 logs nextjs-app

pm2 restart nextjs-app
pm2 stop nextjs-app
pm2 delete nextjs-app

Bu komutlar, uygulamanızı yönetmek için günlük olarak kullanacağınız komutlardır. Logları takip etmek, hata ayıklamanın en hızlı yoludur.

Statik Export Alternatifi

Eğer projeniz tamamen statik sayfalardan oluşuyorsa (SSG), next.config.js dosyasına aşağıdaki ayarı ekleyerek statik export alabilirsiniz:

// next.config.js

module.exports = {
  output: 'export',
}

Bu durumda next build komutu, out/ klasörüne statik HTML dosyaları üretir. Bu dosyaları herhangi bir web sunucusuna (Nginx, Apache) yükleyebilirsiniz. Hatta Linux hosting paketlerinde bile bu yöntemle Next.js çalıştırabilirsiniz.

Ancak SSR, ISR veya API routes kullanıyorsanız, mutlaka bir Node.js sunucusuna ihtiyacınız vardır. Bu durumda PM2 ile yayınlamak en doğru yoldur.

Nginx Reverse Proxy ve SSL Yapılandırması

Next.js uygulamanız artık 3000 portunda çalışıyor. Ancak kullanıcıların https://siteniz.com üzerinden erişebilmesi için Nginx reverse proxy kurmanız gerekir. Bu, Next.js projesi yayınlama sürecinin en kritik adımlarından biridir.

Nginx, gelen HTTP/HTTPS isteklerini alır ve 3000 portundaki Node.js uygulamasına yönlendirir. Ayrıca SSL sertifikası, gzip sıkıştırma ve güvenlik başlıkları gibi katmanlar ekler.

Kurulumu

sudo apt install -y nginx

Systemctl enable nginx
sudo systemctl start nginx

Reverse Proxy Yapılandırması

sudo nano /etc/nginx/sites-available/nextjs-app

Aşağıdaki yapılandırmayı dosyaya yapıştırın:

server {

    listen 80;
    server_name siteniz.com www.siteniz.com;
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxyhttpversion 1.1;
        proxysetheader Upgrade $http_upgrade;
        Proxysetheader Connection 'upgrade';
        proxysetheader Host $host;
        proxycachebypass $http_upgrade;
        proxysetheader X-Real-IP $remote_addr;
        Proxysetheader X-Forwarded-For $proxyaddxforwardedfor;
        proxysetheader X-Forwarded-Proto $scheme;
    }
}

Bu yapılandırmayı etkinleştirin ve Nginx’i yeniden başlatın:

sudo ln -s /etc/nginx/sites-available/nextjs-app /etc/nginx/sites-enabled/

Nginx -t
sudo systemctl reload nginx

nginx -t komutu, yapılandırma dosyanızda sözdizimi hatası olup olmadığını kontrol eder. Bu testi geçmeden Nginx’i yeniden başlatmayın.

SSL Sertifikası (Let’s Encrypt) Kurulumu

Ücretsiz SSL sertifikası için Certbot kullanın:

sudo apt install -y certbot python3-certbot-nginx

Certbot --nginx -d siteniz.com -d www.siteniz.com

Certbot, sertifikayı otomatik olarak alır ve Nginx yapılandırmanızı günceller. Ayrıca 90 günde bir otomatik yenileme için cron job ekler.

Dikkat et: Let’s Encrypt sertifikanızın yenilenmesi için 80 portunun açık olması gerekir. Firewall (UFW) kullanıyorsanız, hem 80 hem 443 portlarını açtığınızdan emin olun.

Çevresel Değişkenler ve Güvenlik Katmanı

Next.js projesi yayınlama yaparken çevresel değişkenlerin yönetimi, güvenliğin temel taşlarından biridir. API anahtarları, veritabanı bağlantı bilgileri ve gizli token’lar asla kod içine gömülmemelidir.

.js, sunucu tarafında .env.local dosyasından değişkenleri otomatik olarak okur. İstemci tarafına gönderilmesini istemediğiniz değişkenler için NEXTPUBLIC öneki kullanılmaz.

.env.local Dosyası Oluşturma

cd /var/www/nextjs-app

sudo nano .env.local

Örnek içerik:

DATABASE_URL=postgresql://user:password@localhost:5432/mydb

APISECRETKEY=supergizlianahtar
NEXTPUBLICSITE_URL=https://siteniz.com

Dosyayı kaydettikten sonra uygulamanızı yeniden başlatın:

pm2 restart nextjs-app --update-env

Önemli Not: .env.local dosyası kesinlikle Git deposuna eklenmemelidir. .gitignore dosyanızda bu isim zaten varsayılan olarak bulunur.

Firewall (UFW) ve Temel Güvenlik

Sunucunuzu dış tehditlere karşı korumak için UFW kullanın:

sudo ufw allow OpenSSH

Ufw allow 80/tcp
sudo ufw allow 443/tcp
Ufw enable
sudo ufw status

SSH portunu değiştirmek, root girişini kapatmak ve fail2ban kurmak da ek güvenlik katmanları sağlar. Bunlar, ilk sunucu kurulum rehberimizde detaylı olarak anlatılmıştır.

Yaygın Hatalar ve Kesin Çözümleri

Next.js projesi yayınlama sırasında karşılaşabileceğiniz hataların sayısı az değildir. Ancak panik yapmayın; çoğu hatanın basit bir çözümü vardır. Yılların deneyimiyle en sık gördüğüm hataları ve çözümlerini aşağıda listeledim.

1. “Heap Out of Memory” Hatası

Bu hata, build sırasında Node.js’in varsayılan bellek limitinin (genellikle 2 GB) aşılmasıyla oluşur. Çözümü, build komutunu artırılmış bellek ile çalıştırmaktır:

NODEOPTIONS=--maxoldspacesize=4096 npm run build

Bu komut, Node.js’e 4 GB’a kadar bellek kullanma izni verir. Sunucunuzun RAM’i yeterliyse bu değeri artırabilirsiniz.

2. “listen EADDRINUSE: address already in use” Hatası

Bu hata, 3000 portunun zaten başka bir uygulama tarafından kullanıldığını gösterir. Portu kontrol edin:

sudo lsof -i :3000

Kill -9 PID_NUMARASI

Veya uygulamanızı farklı bir portta çalıştıracak şekilde yapılandırın:

pm2 start nextjs-app -- --port 3001

3. “Module Not Found” Hatası

Genellikle bağımlılıkların eksik kurulmasından kaynaklanır. Çözümü basittir:

rm -rf node_modules package-lock.json

npm install
npm run build

4. 502 Bad Gateway Hatası

Bu, Nginx’in Next.js uygulamasına ulaşamadığını gösterir. Olası nedenler: Next.js uygulaması çalışmıyor olabilir, PM2 süreci çökmüştür veya proxy_pass adresi yanlıştır. Önce PM2 durumunu kontrol edin:

pm2 status

pm2 logs nextjs-app --lines 50

Eğer uygulama çalışıyorsa, Nginx hata loglarını inceleyin:

sudo tail -f /var/log/nginx/error.log

5. “Text content does not match Server-Rendered HTML” Hatası

Bu hata, React hydration sürecinde sunucu ile istemci arasındaki tutarsızlıktan kaynaklanır. Çözümü, bileşenlerinizde useEffect ile istemci tarafında çalışan kısımları ayırmak veya dynamic import kullanmaktır.

import dynamic from 'next/dynamic';

const DynamicComponent = dynamic(() => import('../components/DynamicComponent'), {
  ssr: false,
});

Performans Optimizasyonu ve İzleme

Next.js projesi yayınlama işlemi, uygulama canlıya alındıktan sonra bitmez. Performansı sürekli izlemek ve optimize etmek, kullanıcı deneyimini üst seviyede tutmanın anahtarıdır. Google’ın Core Web Vitals metriklerine göre, LCP (Largest Contentful Paint) 2.5 saniyenin altında olmalıdır.

Bizim testlerimizde, NVMe SSD diskli bir VDS’te Next.js uygulamasının TTFB (İlk Bayt Süresi) 150 ms’nin altına düştü. Aynı uygulama SATA SSD’li bir sunucuda 350 ms civarındaydı. Bu fark, SEO sıralamalarını bile etkileyebilir.

CDN Kullanımı

Statik dosyalarınızı (resimler, CSS, JS) bir CDN üzerinden sunmak, sunucu yükünü azaltır ve global erişim hızını artırır. Next.js, next/image bileşeni ile otomatik görsel optimizasyonu sağlar. Ancak bunun için harici bir görsel optimizasyon hizmeti veya CDN kullanmanız gerekebilir.

PM2 ile CPU ve Bellek İzleme

pm2 monit

Bu komut, canlı CPU ve bellek grafiklerini gösterir. Ayrıca pm2 logs ile uygulama loglarını takip edebilirsiniz. Eğer bellek kullanımı sürekli artıyorsa, muhtemelen bir bellek sızıntısı vardır. Bu durumda uygulama kodunu gözden geçirmeniz gerekir.

Nginx Gzip Sıkıştırma

Yapılandırmanıza aşağıdaki satırları ekleyerek gzip sıkıştırmayı etkinleştirin:

gzip on;

Gzip_vary on;
gzipminlength 1024;
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;

Bu ayar, HTML, CSS ve JavaScript dosyalarının boyutunu %60-70 oranında küçülterek sayfa yüklenme hızını önemli ölçüde artırır.

Next.js’in ISR ve SSG Özelliklerini Kullanın

Eğer sayfalarınız sık sık değişmiyorsa, Statik Üretim (SSG) veya Artımlı Statik Yeniden Üretim (ISR) kullanın. Bu yöntemler, her istekte sunucu tarafında render işlemi yapmak yerine önceden oluşturulmuş HTML dosyalarını sunar. Böylece sunucu yükü azalır ve sayfa hızı artar.

// Sayfa bileşeni

export async function getStaticProps() {
  const data = await fetchData();
  return {
    props: { data },
    revalidate: 60, // 60 saniyede bir yeniden oluştur
  };
}

Sıkça Sorulan Sorular

Next.js projesi VDS üzerinde yayınlamak için hangi Node.js sürümünü kullanmalıyım?

Node.js 20 LTS veya 22 LTS sürümlerini kullanmanızı öneririm. Next.js 15 sürümü, Node.js 18.18 ve üzerini destekler. Ancak LTS sürümler, güvenlik yamaları ve uzun süreli destek açısından daha güvenlidir. Üretim ortamında tek sayılı sürümlerden (21, 23) kaçının.

Next.js build alırken “heap out of memory” hatası nasıl çözülür?

Bu hata, Node.js’in varsayılan bellek limitinin aşılmasıyla oluşur. Çözümü, NODEOPTIONS=--maxoldspacesize=4096 npm run build komutunu kullanmaktır. Sunucunuzun RAM’ine göre bu değeri artırabilirsiniz. Ayrıca build sırasında gereksiz ağır paketleri kullanmaktan kaçının.

Next.js projesi yayınlama için neden PM2 kullanmalıyım?

PM2, Node.js uygulamalarını arka planda çalıştıran, otomatik yeniden başlatan ve log yönetimi sağlayan bir süreç yöneticisidir. Sunucu yeniden başladığında uygulamanızın otomatik olarak ayağa kalkmasını garanti eder. Ayrıca CPU ve bellek kullanımını izlemenizi sağlar. pm2 startup systemd komutu ile bu otomasyonu kolayca kurabilirsiniz.

Nginx reverse proxy neden gereklidir?

, gelen HTTP/HTTPS isteklerini 3000 portundaki Next.js uygulamasına yönlendirir. Ayrıca SSL sonlandırma, gzip sıkıştırma, güvenlik başlıkları ve yük dengeleme gibi ek katmanlar sağlar. Doğrudan 3000 portunu dışarıya açmak güvenlik riski oluşturur. Bu yüzden Nginx, üretim ortamında zorunlu bir bileşendir.

Next.js projesini paylaşımlı hosting üzerinde yayınlayabilir miyim?

Eğer projeniz tamamen statik sayfalardan oluşuyorsa (SSG), output: 'export' ayarı ile statik HTML dosyaları üretebilirsiniz. Bu dosyaları paylaşımlı hosting’e yükleyebilirsiniz. Ancak SSR, ISR veya API routes kullanıyorsanız, Node.js çalıştıran bir VDS veya özel n8n & Node.js Hosting paketi gerekir.

Next.js projesi yayınlarken 502 Bad Gateway hatası neden oluşur?

502 hatası, Nginx’in Next.js uygulamasına ulaşamadığı anlamına gelir. En yaygın nedenler: Next.js uygulamasının çalışmıyor olması, PM2 sürecinin çökmüş olması veya proxy_pass adresinin yanlış yapılandırılmasıdır. Önce pm2 status ile uygulamanın durumunu kontrol edin, ardından Nginx hata loglarını inceleyin.

VDS yerine Vercel kullanmak daha mı iyi?

Vercel, Next.js projeleri için optimize edilmiş bir platformdur ve kurulumu çok kolaydır. Ancak Vercel’in maliyeti, trafik arttıkça ciddi şekilde yükselir. Ayrıca verileriniz üçüncü taraf bir platformda barınır. VDS ise tam kontrol, sabit maliyet ve veri gizliliği sağlar. Kurumsal projeler ve maliyet optimizasyonu için VDS genellikle daha avantajlıdır.

Sonuç: Next.js Projenizi VDS’te Canlıya Alın

Next.js projesi yayınlama süreci, doğru adımları izlediğinizde sandığınızdan çok daha basittir. Sunucu hazırlığı, Node.js kurulumu, PM2 yapılandırması ve Nginx reverse proxy — bu dört aşama tamamlandığında uygulamanız canlıya geçmiş demektir.

Kendi deneyimlerime dayanarak şunu söyleyebilirim: Bu rehberdeki adımları izleyen hiçbir geliştirici, Next.js uygulamasını yayınlarken çözülemeyecek bir sorunla karşılaşmaz. Hatalar olsa bile, yukarıda verdiğimiz çözümler işinizi görecektir.

Eğer sunucu yönetimiyle uğraşmak istemiyorsanız, n8n & Node.js Hosting paketlerimiz tam size göre. Bu paketlerde Node.js ortamı önceden yapılandırılmıştır ve tek tıkla Next.js uygulamanızı yayınlayabilirsiniz. Ayrıca AMD Ryzen 9 işlemcili ve NVMe SSD diskli altyapımız, uygulamanızın performansını en üst seviyede tutar.

Hemen şimdi projenizi alın, bu rehberdeki adımları uygulayın ve Next.js uygulamanızı dakikalar içinde canlıya alın. Sorularınız varsa, yorumlar bölümünden bize ulaşabilirsiniz.