Statische Site deployen
S3-kompatibler Objektspeicher eignet sich auch als Host für statische Sites. Sie laden Ihre gebauten Dateien in einen Bucket hoch, geben sie öffentlich zum Lesen frei, richten Ihre Domain auf die URL des Buckets aus und haben eine statische Site mit CDN für ein paar Cent pro Monat.
Diese Anleitung bringt Sie von einem gebauten Verzeichnis dist/ (der Ausgabe eines beliebigen modernen Static-Site-Generators — Next.js-Export, Astro, Hugo, reines HTML) zu einer Live-Site unter Ihrer Domain.
Voraussetzungen
- Ein NimbusNexus-Konto mit einem API-Key.
- Eine gebaute Site in einem lokalen Verzeichnis
dist/. - Eine Domain, die Sie kontrollieren (oder Sie verwenden eine von NimbusNexus vergebene Subdomain und überspringen den Schritt mit der Domain).
awscli, konfiguriert für den Objektspeicher von NimbusNexus (oder ein beliebiger S3-kompatibler Client —rclone,mc,s3cmd).
export NIMBUS_KEY="nn_live_xxxxxxxxxxxxxxxx"
export BUCKET="my-site"
export REGION="us-east-1"1 · Bucket erstellen
curl -X POST https://api.nimbusnexus.net/v1/buckets \
-H "Authorization: Bearer $NIMBUS_KEY" \
-H "Content-Type: application/json" \
-d "{
\"name\": \"$BUCKET\",
\"region\": \"$REGION\",
\"storage_class\": \"standard\",
\"public_read\": true,
\"website\": {
\"enabled\": true,
\"index_document\": \"index.html\",
\"error_document\": \"404.html\"
}
}"Was die einzelnen Optionen bewirken:
public_read: true— jeder im Internet kann jedes Objekt im Bucket perGETabrufen. Für statisches Hosting erforderlich; der Bucket-Name erscheint in URLs.website.enabled: true— aktiviert den Modus für statische Sites. Der Bucket liefert dann HTML mit dem richtigenContent-Typeaus, verwendetindex_documentfür Requests auf Verzeichnisse und rendert bei 4xx daserror_document.
Die Antwort enthält die URL des Buckets:
{
"id": "bkt_01HG7Y3...",
"url": "https://my-site.s3.us-east-1.nimbusnexus.net",
"website_endpoint": "https://my-site.s3.us-east-1.nimbusnexus.net"
}2 · S3-CLI konfigurieren
aws configure set aws_access_key_id $NIMBUS_KEY
aws configure set aws_secret_access_key $NIMBUS_SECRET
aws configure set region $REGION
aws configure set s3.endpoint_url https://s3.us-east-1.nimbusnexus.net$NIMBUS_SECRET ist der geheime Teil eines S3-kompatiblen Access-Keys, den Sie im Dashboard unter Settings → Object Storage Keys → New key generieren. Verwechseln Sie ihn nicht mit dem regulären API-Key — das sind verschiedene Keys.
3 · Site hochladen
aws s3 sync ./dist s3://$BUCKET \
--delete \
--cache-control "public, max-age=3600" \
--endpoint-url https://s3.us-east-1.nimbusnexus.net--delete entfernt Dateien im Bucket, die nicht mehr in ./dist liegen. --cache-control setzt auf jedem Objekt einen Cache-Header von 1 Stunde — lang genug, dass Browser nicht bei jedem Seitenaufruf neu laden, und kurz genug, dass Sie nach einer Tippfehlerkorrektur keine Caches manuell invalidieren müssen.
Für Dateien, die NIE gecacht werden sollen (Ihre index.html):
aws s3 cp ./dist/index.html s3://$BUCKET/index.html \
--cache-control "no-cache, max-age=0" \
--endpoint-url https://s3.us-east-1.nimbusnexus.netMuster: langes Caching für gehashte Assets (/_app/[hash].js), kein Caching für das Einstiegs-HTML, das auf sie verweist. Dasselbe Muster nutzen Vercel + Netlify + Cloudflare Pages intern.
4 · Prüfen, ob es funktioniert
Öffnen Sie https://my-site.s3.us-east-1.nimbusnexus.net im Browser. Sie sollten Ihre Site sehen.
Wenn Sie stattdessen XML sehen, routet der Website-Endpoint nicht korrekt — meist, weil public_read oder website.enabled nicht gesetzt wurde. Prüfen Sie die Bucket-Konfiguration erneut:
curl https://api.nimbusnexus.net/v1/buckets/$BUCKET \
-H "Authorization: Bearer $NIMBUS_KEY"5 · Eigene Domain (optional)
Legen Sie bei Ihrem Registrar einen DNS-Eintrag an, der Ihre Domain auf den Bucket verweist:
www.example.com CNAME my-site.s3.us-east-1.nimbusnexus.netFür eine Apex-Domain (example.com ohne www.) funktionieren CNAMEs nicht — CNAME-Einträge auf dem Apex sind laut RFC unzulässig. Zwei Optionen:
- Verwenden Sie
www.example.comals maßgebliche Adresse und leiten Sie den Apex → www weiter - Legen Sie auf dem Apex einen A-Eintrag an, der auf eine Floating-IP zeigt, die an einer kleinen VM mit einer Weiterleitung hängt (300 Zeilen nginx-Konfiguration, ~$5/Monat)
Sobald sich der DNS-Eintrag verbreitet hat (1 Minute bis 24 Stunden, je nach TTL Ihres Registrars):
curl -X PATCH https://api.nimbusnexus.net/v1/buckets/$BUCKET \
-H "Authorization: Bearer $NIMBUS_KEY" \
-H "Content-Type: application/json" \
-d '{
"custom_domains": ["www.example.com"]
}'Damit akzeptiert der Bucket Requests mit Host: www.example.com und stellt ein TLS-Zertifikat für diesen Hostnamen aus (über Let's Encrypt, automatisch erneuert).
6 · Deployment-Pipeline einrichten
Das oben Beschriebene ist das einmalige Deployment. Für CI/CD ist das Muster dasselbe aws s3 sync, aus einer GitHub Action (oder einem beliebigen CI-Runner):
# .github/workflows/deploy.yml (abbreviated)
- name: Deploy
run: |
aws s3 sync ./dist s3://$BUCKET --delete --endpoint-url $ENDPOINT
env:
AWS_ACCESS_KEY_ID: ${{ secrets.NIMBUS_S3_KEY }}
AWS_SECRET_ACCESS_KEY: ${{ secrets.NIMBUS_S3_SECRET }}
BUCKET: my-site
ENDPOINT: https://s3.us-east-1.nimbusnexus.netDie meisten CI-Systeme haben bereits S3-kompatible Deploy-Actions; Sie richten sie auf unseren Endpoint aus, und sie funktionieren unverändert.
Kosten
Speicher: $0,013/GB-Monat in der Klasse Standard. Eine Site mit 50 MB kostet etwa einen Cent pro Monat.
Egress: kostenlos für die ersten 100 GB/Monat, danach $0,01/GB. Eine Site mit 100.000 Seitenaufrufen bei 200 KB pro Seite kommt auf 20 GB — noch im kostenlosen Kontingent.
Im Vergleich zum selben Workload auf AWS CloudFront + S3: beim Egress typischerweise 4–6× günstiger, beim Speicher ähnlich.
Nächste Schritte
- Referenz für Objektspeicher — die vollständige Bucket-API.
- DNS-Zonen — hosten Sie Ihr DNS direkt bei NimbusNexus statt bei Ihrem Registrar.
- Cold Storage — für die Teile Ihres Speichers, die Sie fast nie lesen (Build-Artefakte, alte Releases).