Dağıtım
Bu sayfada
Bir sitelo derlemesi düz statik dosyalardır: sitelo build, HTML, CSS ve JS dosyalarını dist/ içine yazar. Her statik sunucu işe yarar — aşağıdaki yapılandırmalar yalnızca npm run build → dist/ varsayar.
Temiz URL’ler, index.html içeren dizinlerdir (/about/index.html → /about); bu yüzden güzel URL’ler yönlendirme kuralı olmadan kutudan çıktığı gibi çalışır. Bir 404.html kendiliğinden üretilir — Netlify, Cloudflare Pages ve GitHub Pages’in hepsinin anladığı kural budur.
Bunların hepsinin kopyalamaya hazır sürümleri temel örnekte bulunur (depodaki examples/basic).
Statik sunucular
Bu sunucular siteyi derler ve dist/ dizinini kendi CDN’lerinden sunar.
Netlify · Vercel · Cloudflare · AWS Amplify · AWS S3 + CloudFront · Azure Static Web Apps · Firebase Hosting · GitHub Pages · GitLab Pages · Render · DigitalOcean App Platform
Netlify
[build]
command = "npm run build"
publish = "dist"Vercel
{
"$schema": "https://openapi.vercel.sh/vercel.json",
"framework": null,
"buildCommand": "npm run build",
"outputDirectory": "dist",
"installCommand": "npm install"
}Cloudflare
Cloudflare artık yeni projeler için Pages yerine Workers’ı öneriyor. Bu yapılandırmayla npx wrangler deploy siteyi derler ve dist/ dizinini yükler; depoyu Cloudflare panelinde bağladığınızda aynı komut her push’ta çalışır. html_handling: "drop-trailing-slash" /about adresini yönlendirme olmadan sunar, bilinmeyen URL’ler ise 404.html alır.
// Cloudflare Workers
{
"name": "my-site",
"compatibility_date": "2026-10-01",
"build": {
"command": "npm run build"
},
"assets": {
"directory": "./dist",
"not_found_handling": "404-page",
"html_handling": "drop-trailing-slash"
}
}Hâlâ Pages’te misiniz? Derleme komutunu npm run build, çıktı dizinini dist olarak ayarlayın ya da yerel bir derlemeyi npx wrangler pages deploy dist ile yükleyin.
AWS Amplify
# AWS Amplify Hosting
version: 1
frontend:
phases:
preBuild:
commands:
- npm install
build:
commands:
- npm run build
artifacts:
baseDirectory: dist
files:
- '**/*'
cache:
paths:
- node_modules/**/*AWS S3 + CloudFront
Bucket’ı gizli tutun ve önüne origin access control ile CloudFront koyun. CloudFront yalnızca / adresini index.html dosyasına eşler; sitelo’nun temiz URL’lerini sunmak için bu fonksiyonu dağıtımın viewer isteklerine bağlayın.
function handler(event) {
var request = event.request
var uri = request.uri
if (uri.endsWith('/')) {
request.uri += 'index.html'
} else if (uri.slice(uri.lastIndexOf('/') + 1).indexOf('.') === -1) {
request.uri += '/index.html'
}
return request
}Gizli bir bucket eksik dosyaya 403 ile yanıt verir; bu yüzden 403 ve 404 için /404.html dosyasını 404 durum koduyla döndüren özel hata yanıtları ekleyin. Ardından her derlemeyi yükleyip önbelleği temizleyin:
npm run build
aws s3 sync dist/ s3://my-bucket --delete
aws cloudfront create-invalidation --distribution-id MY_DISTRIBUTION_ID --paths "/*"Azure Static Web Apps
Azure portalında Static Web App’i uygulama konumu / ve çıktı konumu dist olacak şekilde oluşturun; Azure, depoya npm run build çalıştıran bir GitHub Actions iş akışı ekler. Derlemenin bu dosyayı dist/ içine kopyalaması için onu public/ dizinine koyun — bu dosya olmadan Azure bilinmeyen URL’lere 404.html yerine kendi hata sayfasıyla yanıt verir.
{
"responseOverrides": {
"404": {
"rewrite": "/404.html"
}
}
}Firebase Hosting
Firebase Hosting’de firebase use --add ile bir proje seçin, sonra firebase deploy çalıştırın — predeploy kancası önce derler. Bilinmeyen URL’ler otomatik olarak 404.html alır, trailingSlash: false ise /about adresini yönlendirme olmadan sunar.
{
"hosting": {
"public": "dist",
"predeploy": "npm run build",
"trailingSlash": false
}
}GitHub Pages
# GitHub Pages
name: Deploy
on:
push:
branches: [main]
permissions:
contents: read
pages: write
id-token: write
jobs:
deploy:
runs-on: ubuntu-latest
environment:
name: github-pages
steps:
- uses: actions/checkout@v7
- uses: actions/setup-node@v7
with:
node-version: 24
- run: npm ci && npm run build
- uses: actions/upload-pages-artifact@v5
with:
path: dist
- uses: actions/deploy-pages@v5Bir alt yol altında mı dağıtıyorsunuz (user.github.io/repo)? --base /repo/ ile derleyin.
GitLab Pages
GitLab, 404.html sayfasını ve dizin URL’lerini kendisi sunar; bu yüzden iş yalnızca derler ve dist/ dizinini yayımlar.
# GitLab Pages
deploy-pages:
image: node:24
script:
- npm ci
- npm run build
pages:
publish: dist
rules:
- if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCHRender
Aşağıdaki Blueprint’i depoya ekleyin ya da panelden aynı derleme komutu ve yayın diziniyle bir statik site oluşturun. Temiz URL’ler ve 404.html yönlendirme kuralı olmadan çalışır.
# Render
services:
- type: web
name: my-site
runtime: static
buildCommand: npm install && npm run build
staticPublishPath: ./distDigitalOcean App Platform
github.repo alanına kendi deponuzu yazın, ardından uygulamayı doctl apps create --spec .do/app.yaml ile oluşturun — ya da belirtimi panele yapıştırın. App Platform dizin URL’lerini çözer ve varsayılan olarak 404.html sunar.
# DigitalOcean App Platform
name: my-site
static_sites:
- name: site
github:
repo: your-name/your-site
branch: main
deploy_on_push: true
build_command: npm run build
output_dir: distKonteyner sunucuları
Bu sunucular bir konteyner çalıştırır ve tek bir Dockerfile hepsine yeter: Node siteyi derler, ardından Caddy dist/ dizinini temiz URL’lerle sunar ve bilinmeyen URL’lere 404.html ile yanıt verir. Sunucu PORT değişkenini ayarlıyorsa Caddy onu, ayarlamıyorsa 80 portunu dinler. Üç dosyayı da proje köküne ekleyin.
Railway · Fly.io · Heroku · Google Cloud Run
FROM node:24-slim AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
FROM caddy:2-alpine
COPY Caddyfile /etc/caddy/Caddyfile
COPY --from=build /app/dist /app/distnode_modules
dist
.git:{$PORT:80} {
root * /app/dist
encode zstd gzip
try_files {path} {path}/index.html
file_server
handle_errors {
rewrite * /{err.status_code}.html
file_server
}
}Railway
Railway bir Dockerfile bulduğunda onu derler, yani ayarlanacak bir şey yok. Dockerfile olmadan RAILPACK_SPA_OUTPUT_DIR=dist servis değişkenini ekleyin ve Caddyfile dosyasını koruyun: Railpack bu durumda dist/ dizinini, bilinmeyen URL’lere ana sayfayla yanıt veren tek sayfalı uygulama varsayılanı yerine bu dosya üzerinden sunar.
Fly.io
Uygulamayı fly launch ile oluşturun, sonra fly deploy çalıştırın.
# Fly.io
app = "my-site"
[http_service]
internal_port = 80
force_https = true
auto_stop_machines = "stop"
auto_start_machines = true
min_machines_running = 0Heroku
Heroku, Dockerfile dosyasını heroku.yml aracılığıyla derler. Uygulamayı bir kez heroku stack:set container ile konteyner yığınına geçirin, sonra git push heroku main çalıştırın.
# Heroku
build:
docker:
web: DockerfileGoogle Cloud Run
Proje kökünde gcloud run deploy --source . çalıştırın: Cloud Build Dockerfile dosyasını derler, Cloud Run da sunar.
Kendi sunucunuz
Derlemeyi rsync -a --delete dist/ you@server:/var/www/my-site/ ile sunucuya kopyalayın ve Caddy ya da nginx ile sunun — temiz URL’ler ve 404.html yukarıdaki sunuculardaki gibi çalışır. Caddy alan adı için HTTPS sertifikasını kendisi alır; nginx kullanıyorsanız certbot ile bir tane ekleyin.
example.com {
root * /var/www/my-site
encode zstd gzip
try_files {path} {path}/index.html
file_server
handle_errors {
rewrite * /{err.status_code}.html
file_server
}
}server {
listen 80;
server_name example.com;
root /var/www/my-site;
location / {
try_files $uri $uri/index.html =404;
}
error_page 404 /404.html;
}Yayımlamadan önce
sitemap.xmlüretilsin diyesitelo.config.jsiçindesitedeğerini ayarlayın — bkz. Yapılandırma- Markalı bir bulunamadı sayfası için bir
src/404.ht.jsekleyin (aksi hâlde temiz bir varsayılan üretilir) sitelo previewson bir kontrol için üretim derlemesini yerelde sunar