DeployVeraDocs

TEKNİK REFERANS

Next.js yayınlama (standalone, ISR, next/image, Proxy)

Next.js uygulamasını DeployVera’da Docker konteyneri olarak çalıştırma: output standalone, PORT ve HOSTNAME ve next start altında nelerin çalıştığı (ISR, sharp’lı next/image, Proxy). Kaynak: Next.js belgeleri.

Son kontrol: Markdown

Kapsam

DeployVera, Next.js uygulamanızı Node.js üzerinde kesintisiz çalışan bir Docker konteyneri olarak çalıştırır. Bu, Next.js belgelerinde anlatılan kendi sunucunuzda barındırma (self-hosting) modelidir; Vercel platform çalışma ortamı değildir.

Vercel’e özgü platform çalışma ortamına, edge fonksiyonlara veya küresel CDN’e dayanan özellikler bu modelin dışındadır. next start ile bir Node.js sunucusunda çalışan özellikler, aşağıdakiler gibi, konteynerde de çalışır.

Bu sayfadaki Next.js ifadeleri Next.js belgelerinden alınmıştır: self-hosting rehberi (son güncelleme 2026-10-15) ve output referansı (son güncelleme 2026-09-18); ikisine de 2026-11-16 tarihinde erişildi. Bir ayrıntıya güvenmeden önce güncel Next.js belgelerine bakın.

output: 'standalone'

Next.js yapılandırmasında output: 'standalone' ayarlayın. Belgeye göre bu, node_modules kurmadan tek başına dağıtılabilen bir .next/standalone klasörü ve next start yerine kullanılabilen minimal bir server.js üretir.

Minimal sunucu public ve .next/static klasörlerini varsayılan olarak kopyalamaz. Belge, next build sonrasında bunların standalone/public ve standalone/.next/static içine kopyalanabileceğini, sonrasında server.js’in bunları sunacağını söyler.

// next.config.js
module.exports = {
  output: 'standalone',
}

PORT ve HOSTNAME

Belgeye göre proje belirli bir portu veya ana makine adını dinleyecekse server.js çalışmadan önce PORT veya HOSTNAME ortam değişkenlerini tanımlayın; örneğin PORT=8080 HOSTNAME=0.0.0.0 node server.js sunucuyu http://0.0.0.0:8080 üzerinde başlatır.

Konteynerde sunucunun dışarıdan gelen bağlantıları kabul etmesi için HOSTNAME=0.0.0.0 ayarlayın ve PORT değerini DeployVera panelinde girdiğiniz portla aynı yapın.

Örnek Dockerfile

Uygulamayı derleyip standalone sunucuyu çalıştıran çok aşamalı bir Dockerfile. Node.js sürümünü ve paket yöneticisini projenize göre uyarlayın.

Gizli değerler Dockerfile’da değil, panelde ortam değişkeni olarak tanımlanır.

FROM node:22-alpine AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM node:22-alpine
WORKDIR /app
ENV NODE_ENV=production
ENV HOSTNAME=0.0.0.0
ENV PORT=3000
COPY --from=build /app/.next/standalone ./
COPY --from=build /app/.next/static ./.next/static
COPY --from=build /app/public ./public
EXPOSE 3000
CMD ["node", "server.js"]

next start altında ISR, next/image ve Proxy

next/image ile Görsel Optimizasyonu, next start ile dağıtıldığında kendi sunucunuzda sıfır yapılandırmayla çalışır (self-hosting rehberi). Ayrı bir servis tercih ederseniz görsel yükleyici (loader) yapılandırılabilir. output referansı, izleme yerel dosyaları kaçırdığında örnek dahil etme deseni olarak node_modules/sharp/**/* verir. Rehber, glibc tabanlı Linux sistemlerinde görsel optimizasyonunun aşırı bellek kullanımını önlemek için ek yapılandırma gerektirebileceğini belirtir; ücretsiz pakette 512 MB RAM vardır, belleği izleyin.

Proxy (istekleri yönlendirmeden önce işleyen dosya kuralı), next start ile dağıtıldığında kendi sunucunuzda sıfır yapılandırmayla çalışır; statik dışa aktarmada desteklenmez.

Artımlı Statik Yeniden Oluşturma (ISR) ve önbellek: rehbere göre ISR aynı Next.js sunucu önbelleğini kullanır; önbellek varsayılan olarak her sunucu örneğinin yerel dosya sisteminde tutulur ve kalıcı yerel diski olan tek örnek için otomatik çalışır. DeployVera’da konteynerin yazılabilir katmanı geçicidir; kalıcı depolama bağlamazsanız önbellek yeniden dağıtımdan sonra yeniden oluşur. Birden çok örnek çalıştırmak, rehberde anlatıldığı gibi ortak bir önbellek yöneticisi (cache handler) gerektirir.

Ortam değişkenleri

Varsayılan olarak ortam değişkenleri yalnızca sunucuda kullanılabilir. NEXT_PUBLIC_ önekli değişkenler next build sırasında JavaScript paketine gömülür (self-hosting rehberi); bu yüzden imaj derlenirken mevcut olmaları gerekir, bunu build logundan doğrulayın.

Sunucu tarafı değişkenleri DeployVera panelinde çalışma zamanı ortam değişkeni olarak tanımlayın.

Sınırlar

Vercel’e özgü altyapıya dayanan Next.js özellikleri sağlanmaz. DeployVera’da veritabanları beta aşamasındadır; yedekler platform düzeyindedir ve kendi kendine indirilemez veya geri yüklenemez.

Next.js belgesi ile projenizin Next.js sürümü ayrışırsa kendi sürümünüzün belgesi geçerlidir. Fiyat ve paket limitleri /docker adresindeki canlı katalogdadır.