# 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.

Last reviewed: 2026-11-12

## 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.

Sources: https://api.deployvera.com/api/plans · https://deployvera.com/docker · https://deployvera.com/help
