Zum Inhalt springen

Erste Schritte

Shortlink

Ein selbst betriebener Dienst zum Kürzen von Adressen. Ein angemeldeter Nutzer trägt eine lange Ziel-Adresse ein und erhält eine kurze, die er weitergeben kann. Der Besucher braucht kein Konto.

Stand: 5.0.2.

Wofür

Der Kurz-Link liegt auf deiner Domain. Das Ziel bleibt änderbar — ein gedruckter Link bleibt gültig, während die Zielseite umzieht. Und die Aufrufzahlen bleiben im Haus.

Was Shortlink nicht ist: keine Statistik-Plattform (es gibt Zähler, aber keine Auswertung nach Herkunft, Gerät oder Kampagne), kein Marketing-Werkzeug, kein Werbe-Tracker, keine Dateiablage.

Der Zuschnitt in vier Sätzen:

  • Keine öffentliche Registrierung. Konten legt ausschließlich ein Administrator an.
  • Ein Kurz-Link wird nie ein zweites Mal vergeben — auch nicht nach Ablauf oder Löschung. Sonst könnte ein alter, längst verschickter Link auf ein fremdes Ziel führen.
  • Weiterleitung immer mit 302, nie 301. Eine dauerhaft zwischengespeicherte Weiterleitung erreicht die Anwendung nie wieder: Ein geändertes Ziel griffe nicht, und der Zähler sähe den Besucher nicht mehr.
  • Alle Wege funktionieren ohne JavaScript. Mit JavaScript wird es bequemer, aber kein Anwendungsfall hängt davon ab.

Die Oberfläche ist deutschsprachig, die Kommandozeile englisch.

Installieren

Mit vorbereiteter Datenbank und Domain in einer Viertelstunde:

curl -fLO https://gitlab.com/mankeldor/shortlink/-/raw/main/shortlink-setup.sh
sh shortlink-setup.sh /pfad/zur/installation
cd /pfad/zur/installation
php artisan shortlink:install

Der ganze Weg: Systemanforderungen → Installation → Cron einrichten → Nach der Installation.

Wo was steht
Häufige Fragen Was es kostet, was der Betrieb verlangt, was es bewusst nicht kann
Erste Schritte Anforderungen, Installation, Cron, Aktualisierung
Betrieb Konfiguration, Einstellungen, Konten, Sicherheit, Backup, Wartung, Störungssuche
Benutzen Für die Menschen, die täglich damit arbeiten: Links anlegen, verwalten, weitergeben
Lizenz Wer was darf, kostenlos oder lizenzpflichtig
Änderungen Was sich zuletzt geändert hat

Für Entwicklung und Konventionen: CONVENTIONS.md, CONTRIBUTING.md, DOCS-CONVENTIONS.md.

Quelle dieser Seite: docs/uebersicht.md im Repository. Sie wird beim Bauen daraus erzeugt — Änderungen gehören in die Markdown-Datei, nicht in diese Seite.