gooddeploy
Handbuch · Kapitel 13

Freigabelink für Previews

Previews sind geschützt: Wer die Adresse einer Preview ohne Freigabe aufruft, sieht nur eine Hinweisseite. Mit gooddeploy share erzeugst du einen Link, mit dem dein Kunde oder dein Team die Preview ohne Konto und ohne Passwort ansieht, so lange du willst, höchstens 30 Tage.

gooddeploy share k7m2q9xa
gooddeploy share https://kunde-website--k7m2q9xa.gooddeploy.de --days 14

Statt der Deployment-ID kannst du die Preview-Adresse angeben. Ohne --days gilt der Link 7 Tage, erlaubt sind 1 bis 30 Tage. Die Ausgabe sieht so aus:

✓ Freigabelink für k7m2q9xa (kunde-website), gültig bis 26.10.2026 14:30
  https://kunde-website--k7m2q9xa.gooddeploy.de/__gooddeploy/share#1793024400.oxmcoTlBrdcUlc6ExApAaQ
  Wer den Link hat, sieht die Preview ohne Konto. Der Browser merkt sich die Freigabe für diese Adresse.
  Widerrufen    gooddeploy share revoke

Für Skripte liefert gooddeploy share k7m2q9xa --json die Felder url, expiresAt, deployment und project.

Eigene Previews ansehen: deploy und open

Für dich selbst brauchst du share meist nicht: Ist die Preview geschützt, erzeugt gooddeploy deploy nach „Preview bereit“ einen Link, der 1 Tag gilt, und zeigt ihn als Öffnen an; die nackte Adresse steht darunter. gooddeploy open <id> erzeugt ebenso einen 1-Tages-Link und öffnet ihn im Browser. Beides braucht wie share das Recht deploy; fehlt es, bleibt es bei der Adresse und dem Hinweis auf gooddeploy share <id>, der Deploy gilt trotzdem als erfolgreich. Mit deploy --no-share-link erzeugt deploy keinen Link.

Für Kunden erzeugst du mit gooddeploy share <id> --days 7 einen eigenen, länger gültigen Link. Jeder dieser Links, auch die von deploy und open, steht im Audit-Log (api.share.created) und gilt nach gooddeploy share revoke nicht mehr.

Was beim Öffnen passiert

  1. Der Link öffnet eine kurze Seite der Preview. Sie liest die Freigabe aus dem Teil hinter # und entfernt ihn sofort aus der Adresszeile.
  2. Der Browser bekommt ein Cookie, das nur für genau diese Preview-Adresse gilt, und landet auf der Startseite der Preview.
  3. Ab dann sieht er die Preview mit allen Bildern und Seiten, bis der Link abläuft.

Der Teil hinter # wird von Browsern nie an einen Server geschickt. Die Freigabe steht deshalb nicht in Zugriffsprotokollen und wird nicht als Referer an andere Seiten weitergegeben. Teile den Link trotzdem nur mit Menschen, die die Preview sehen sollen: Wer den Link hat, kommt hinein.

Abgelaufen oder ungültig

Nach Ablauf zeigt die Preview wieder die Hinweisseite mit Status 401. Erzeuge dann einfach einen neuen Link. Ein Link gilt nur für die Preview, für die er erzeugt wurde, nicht für andere Previews oder die Live-Seite.

gooddeploy share revoke

widerruft sofort alle Freigabelinks für die Previews des Projekts, auch die schon im Browser gemerkten Freigaben. Neue Links erzeugst du danach wie gewohnt.

Zusammen mit dem Passwortschutz

  • Die Live-Seite ist nie über einen Freigabelink geschützt. Schütze sie bei Bedarf mit einem Passwort, siehe Passwortschutz.
  • Hast du für die Previews zusätzlich ein Passwort gesetzt, reicht eins von beiden: ein gültiger Freigabelink oder das Passwort.
  • Previews senden immer X-Robots-Tag: noindex, damit Suchmaschinen sie nicht aufnehmen.

Grenzen

  • Einzelne Links lassen sich nicht widerrufen, nur alle Links eines Projekts auf einmal.
  • Ein QR-Code für das Handy kommt später.

Wer darf das?

Einen Link erzeugen darf, wer auf dem Projekt deploy hat. Alle Links widerrufen braucht settings (oder admin). Siehe Rechte.