Shlink auf Saplo einrichten (eigener Link-Kürzer mit Statistiken)

Bitly kann im kostenpflichtigen Tarif deutlich über 100 Euro pro Monat kosten, bevor du überhaupt das Limit verkürzter Links überschritten hast, denn die Abrechnung hängt von der Anzahl aktiver Adressen und Klicks ab. Shlink ist ein Open-Source-Linkshortener, dieselbe Idee wie Bitly, nur auf deiner eigenen Box, einmalig, ohne Adresslimit und ohne monatliche Rechnung. Im Folgenden erfährst du Schritt für Schritt, wie du Shlink auf Saplo einrichtest.

Warum Shlink auf deinem eigenen Box statt Bitly

Die kostenpflichtigen Pläne von Bitly haben zwei Eigenschaften, die bei Marketingkampagnen und langfristiger Linkverfolgung besonders ärgerlich sind:

• Limit für verkürzte Links und Klicks pro Monat - der kostenlose Plan reicht für eine einzelne Kampagne, nicht für ein ganzes Jahr Arbeit einer Agentur,
• Klickdaten liegen bei einem externen Unternehmen - Traffic-Statistiken aus deinen Kampagnen bleiben auf den Servern von Bitly, nicht auf deinen.

Shlink bietet denselben Mechanismus zum Kürzen von Links und Zählen von Klicks, den du auf deinem eigenen Box betreibst. Es gibt kein Limit für die Anzahl der Adressen, die Klickdaten bleiben in deiner Infrastruktur, und eine eigene Domain zum Kürzen von Links wirkt professioneller als eine generische bit.ly.

Voraussetzungen

Um Shlink auf Saplo einzurichten, brauchst du:

• eine Box mit aktiviertem Docker (die Engine aktiviert Docker bei der Installation aus dem Katalog automatisch, Container-Nesting ist erforderlich und bei Saplo standardmäßig vorhanden),
• mindestens 512 MB freien RAM auf deiner Box und 2 GB Speicherplatz auf der Festplatte,
• eine Domain oder Subdomain *.saploapp.pl im Preis jedes Plans, am besten eine kurze, weil sie in jedem Kurzlink sichtbar sein wird.

Es lohnt sich, von Anfang an klarzustellen, was Shlink ist und was nicht. Shlink selbst ist eine REST API und ein Server für die Weiterleitung von Kurzlinks. Bei Saplo erhältst du ihn zusammen mit dem offiziellen Browser-Panel, das unter der Anwendungsadresse erreichbar und passwortgeschützt ist, sodass du nichts zusätzlich installieren oder konfigurieren musst. Für die Installation selbst benötigst du keine externe Datenbank, da Shlink die Daten standardmäßig in einer lokalen SQLite-Datei im Datenvolumen speichert. Optional kannst du die gemeinsam genutzte MySQL-Datenbank von Saplo auswählen, wenn du mit hohem Traffic rechnest.

Installation Schritt für Schritt

1. Öffne im Saplo-Panel den App-Katalog und wähle Shlink (Kategorie "Tools").
2. Wähle die Box, auf der Shlink laufen soll, sowie die Domain oder Subdomain, unter der die verkürzten Links funktionieren, und entscheide dich für eine Datenbank: SQLite (Standard, keine zusätzliche Infrastruktur) oder MySQL (gemeinsame Saplo-Datenbank, besser bei hohem Traffic).
3. Bestätige die Installation. Die Engine stellt zwei Docker-Container mit den offiziellen Images shlinkio/shlink und shlinkio/shlink-web-client (Panel) bereit, generiert einen zufälligen API-Schlüssel und ein Passwort für das Panel und macht das Ganze unter der angegebenen Domain über nginx mit kostenlosem SSL verfügbar.
4. Die Engine wartet darauf, dass Shlink tatsächlich auf eine Health-Check-Abfrage antwortet, und zwar zweimal, bevor sie die Installation als abgeschlossen betrachtet, da der erste Start eine Migration des Datenbankschemas erfordert, die mehr als ein paar Sekunden dauern kann.
5. Nach Abschluss findest du in den Startdaten der Anwendung (Datei SHLINK-SETUP.txt) den Benutzernamen und das Passwort für das Panel sowie den API-Schlüssel.

Erste Konfiguration

Shlink generiert ebenso wie Grafana oder MinIO die Zugangsdaten automatisch bei der Installation, statt sie im Assistenten abzufragen.

1. Öffne die Startdaten der Anwendung im Saplo-Panel (Datei SHLINK-SETUP.txt). Dort findest du Benutzername, Passwort und API-Schlüssel.
2. Klicke bei der Anwendung auf Öffnen, melde dich an und wähle den Server Meine Links. Der Server ist bereits mit dem API-Schlüssel verbunden, du musst nichts eingeben.
3. Erstelle den ersten Kurzlink im Tab zum Erstellen eines Links, optional mit einem eigenen Kurzcode statt einer zufälligen Zeichenfolge.
4. Prüfe die Klickstatistiken und den QR-Code des erstellten Links. Beide Funktionen sind integriert und direkt nach der Installation verfügbar.

Kurzlinks funktionieren auf derselben Domain ohne Passwort, das Passwort schützt nur das Panel. Ein eigener Kurzcode darf nicht server, settings, assets oder icons heißen, da diese Adressen für das Panel reserviert sind.

Wenn du Automatisierung dem Klicken in der Oberfläche vorziehst, kannst du dasselbe direkt über die REST API erledigen, beispielsweise einen Kurzlink mit einem einzigen Befehl erstellen:

curl -s -X POST 'https://deine-domain.saploapp.pl/rest/v3/short-urls' \
  -H "X-Api-Key: YOUR_API_KEY" -H 'Content-Type: application/json' \
  -d '{"longUrl":"https://saplo.pl"}'

Shlink auf Saplo kontra Bitly

Häufige Fragen

Hat Shlink ein Web-Login-Panel wie WordPress oder Ghost? Ja. Bei Saplo läuft unter der Anwendungsadresse das offizielle Shlink-Panel, das mit einem Passwort geschützt ist. Benutzername und Passwort stehen in der Datei SHLINK-SETUP.txt. Dieselbe Serverinstanz kannst du auch im app.shlink.io-Client hinzufügen oder über die REST API mit dem Schlüssel aus dieser Datei verwalten.

Gibt es ein Limit für die Anzahl der verkürzten Links? Nein. Shlink setzt weder bei der Anzahl der URLs noch bei den Klicks ein Limit. Die einzige Einschränkung sind die Ressourcen deiner gewählten Box.

Kann ich sehen, aus welchem Land auf den Link geklickt wurde? Standardmäßig nein. Für die Geolokalisierung der Besuche brauchst du einen eigenen kostenlosen MaxMind-Schlüssel. Einen kann man während der Installation nicht automatisch anlegen. Ohne ihn zählt Shlink die Klicks normal, liefert aber keine Informationen zum Land des Besuchers.

Worin unterscheidet sich SQLite von MySQL bei der Installation? SQLite ist eine Datenbankdatei im Datenvolume und benötigt keine zusätzliche Infrastruktur. In den meisten Fällen reicht das aus. MySQL ist eine gemeinsam genutzte Saplo-Datenbank und erst bei wirklich hohem Klickaufkommen die bessere Wahl.

Werden die Daten in Shlink automatisch gesichert? Das hängt vom gewählten Box-Plan ab. Das Backup funktioniert auf Ebene der gesamten Box, genau wie bei anderen Apps aus dem App-Katalog. Es handelt sich nicht um eine separate Funktion von Shlink.

Wenn du Fragen beim Einrichten von Shlink auf deiner eigenen Box oder bei der Ersteinrichtung des Panels hast, schreib uns. Wir helfen dir bei der Ersteinrichtung.