Lange Nextcloud-Freigabelinks sind schwer vermittelbar. Eine URL wie https://cloud.example.com/index.php/s/aBcDeFg12345678 sieht aus wie etwas, das ein Phisher schicken würde, lässt sich am Telefon schlecht vorlesen und bricht auf einem gedruckten Handout unschön um. Wenn du deinen eigenen Server betreibst, kannst du das beheben, ohne deine Links einem fremden Kurzlink-Dienst zu überlassen: Shortcloud ist ein Nextcloud-Plugin, das jeder öffentlichen Freigabe eine kurze Adresse auf deiner eigenen Domain gibt und sie auf die eigentliche Freigabe weiterleitet. Dieses Tutorial zeigt dir die Installation, die Einrichtung der Rewrite-Regel und die Funktionen im Alltag: automatische Kurzlinks für neue und alte Freigaben, eigene Endungen, zusätzliche Kurz-Domains, QR-Codes, abgelaufene Freigaben mit 410 Gone und das Ausblenden von /index.php aus deinen Adressen.
Alles Folgende stammt aus der Produktdokumentation. Die vollständige Referenz findest du in der Anleitung und auf der Produktseite.
Welches Problem es löst
Ein Kurzlink wie cloud.example.com/go/abc1234 lässt sich leicht tippen, gut drucken und wirkt, als gehöre er zu deiner Organisation. Shortcloud erstellt automatisch einen für jede neue öffentliche Link-Freigabe – egal, ob die Freigabe über die Weboberfläche, den Desktop-Client oder einen mobilen Client angelegt wurde. Deine Domain bleibt deine Domain, und der Redirector ist dein eigener Server, kein öffentlicher Kurzlink-Dienst.
Voraussetzungen
- Nextcloud 32 bis 34 mit PHP 8.1 oder neuer.
- Eine Rewrite-Regel in deinem Webserver. Auf Apache mit
mod_rewriteundAllowOverride Allschreibt die App sie selbst in die.htaccessvon Nextcloud und hält sie über Upgrades hinweg dort. Auf nginx oder einem virtuellen Host zeigt die Einstellungsseite den Snippet, den du einfügen musst. - Für eine zusätzliche Kurz-Domain: DNS, das auf den Server zeigt, ein TLS-Zertifikat und ein virtueller Host (die Einstellungsseite zeigt ihn).
- Ein Lizenzschlüssel aus deinem MediaLab Works-Konto – die kostenlose 30-Tage-Testversion kannst du direkt in der App starten.
Schritt 1 — App installieren und aktivieren
Lade das Archiv shortcloud-x.y.z.tar.gz unter Lizenzen in deinem Konto herunter und entpacke es in deinen Apps-Ordner, sodass apps/shortcloud/ entsteht, im Besitz des Webserver-Benutzers:
cd /var/www/nextcloud/apps
sudo tar -xzf ~/shortcloud-x.y.z.tar.gz
sudo chown -R www-data:www-data shortcloud
Aktiviere sie:
sudo -u www-data php occ app:enable shortcloud
Du kannst sie auch über die Seite Apps aktivieren.
Schritt 2 — Lizenz aktivieren
Öffne Administrationseinstellungen → Shortcloud → Lizenz, füge deinen Lizenzschlüssel ein und speichere. Die App kontaktiert den Lizenzserver, bindet den Schlüssel an diese Nextcloud-Instanz und zeigt die Lizenz als Aktiv an.
Gut zu wissen: Die Lizenz wird einmal täglich geprüft. Ohne Internet läuft die App nach der letzten erfolgreichen Prüfung noch 7 Tage weiter; danach stoppt sie, bis sie wieder prüfen kann. Ohne gültige Lizenz wird nichts gelöscht – jeder Kurzlink bleibt erhalten und funktioniert wieder, sobald die Lizenz gültig ist; in der Zwischenzeit bleibt nur der Bereich Lizenz nutzbar.
Schritt 3 — Prüfen, ob die Rewrite-Regel funktioniert
Nextcloud erlaubt es einer Drittanbieter-App nicht, selbst unter /go/… zu antworten, daher leitet eine Rewrite-Regel diese Anfragen an die App weiter. Auf Apache mit beschreibbarer .htaccess schreibt die App sie beim ersten Request nach dem Aktivieren. Öffne Administrationseinstellungen → Shortcloud: Die Seite testet die Kurzadresse über HTTP und sagt dir, ob die Regel funktioniert, bietet Rewrite-Regel installieren an und zeigt den Snippet für nginx oder einen virtuellen Host.
Der Block, den sie schreibt, sieht so aus:
# BEGIN Shortcloud
<IfModule mod_rewrite.c>
RewriteEngine on
RewriteRule ^go/(.*)$ apps/shortcloud/go.php?slug=$1 [END,QSA]
</IfModule>
# END Shortcloud
Der Block übersteht occ upgrade und occ maintenance:update:htaccess; ersetzt ein Core-Update die .htaccess, legt die App ihn wieder an. Im Terminal kannst du auch occ shortcloud:setup verwenden (mit --check und --remove).
Schritt 4 — Einstellungen anpassen
Dieselbe Einstellungsseite steuert, wie sich der Kurzlink-Dienst verhält:
| Einstellung | Bedeutung |
|---|---|
| Pause | Keine neuen Kurzlinks; bestehende funktionieren weiter. |
| Automatische Kurzlinks | Einer für jede neue öffentliche Link-Freigabe. |
| Pfad-Präfix | Standardmäßig /go/; eine Änderung schreibt die Regel neu. |
| Länge zufälliger Endungen | Standardmäßig 7, ohne verwechselbare Zeichen. |
| Wer erstellen darf | Alle oder nur ausgewählte Gruppen. Administratoren dürfen immer. |
| Ziele | Nur diese Nextcloud (Standard), eine Liste von Hosts oder jede Adresse. Freigabelinks sind immer erlaubt. |
| Reservierte Endungen | Namen, die nie vergeben werden. |
| Eigene Kurz-Domains | Zusätzliche Hosts, mit optionalem Präfix. |
| Pretty URLs | Blendet /index.php aus jeder Adresse aus (alte Adressen funktionieren weiter). |
Ein sinnvoller Ausgangspunkt für die meisten Selbst-Hoster: Lass Ziele auf Nur diese Nextcloud (damit deine Domain nie zu einem offenen Redirector wird), behalte das Standard-Präfix und schalte Pretty URLs ein.
Schritt 5 — Dateien freigeben und den Kurzlink kopieren
Gib eine Datei oder einen Ordner wie gewohnt per Link frei, öffne dann das …-Menü der Link-Freigabe in der Freigabe-Seitenleiste und wähle Kurzlink kopieren. Kurzlink… lässt dich die Endung ändern und zeigt den QR-Code – praktisch für gedruckte Handouts, Folien oder ein Poster bei einer Community-Veranstaltung.
Auch Alben zählen: Öffentliche Albumlinks der Apps Photos und Memories bekommen ebenfalls Kurzlinks.
Schritt 6 — Alten Freigaben ihre Kurzlinks geben
Freigaben, die vor der App entstanden sind, haben noch keinen Kurzlink. Fülle sie nach:
sudo -u www-data php occ shortcloud:backfill --dry-run
sudo -u www-data php occ shortcloud:backfill
Du kannst den Lauf mit --user uid auf einen Benutzer beschränken; probiere immer zuerst --dry-run.
Schritt 7 — Eigene Endungen, zusätzliche Domains und manuelle Links
- Eigene Endungen: Die Domain ist fest, den Rest bestimmst du – zum Beispiel
/go/annual-report. - Zusätzliche Kurz-Domains: zum Beispiel
https://cc.link/abc1234, ausgeliefert vom selben Server. Richte das DNS darauf, hole ein Zertifikat, trage die Domain unter Eigene Kurz-Domains ein und füge dann den virtuellen Host hinzu, den die Seite zeigt. Sie muss keine vertrauenswürdige Nextcloud-Domain sein: Dort antwortet nur der Redirector. - Jede Adresse lässt sich auf der Seite Shortcloud (im Top-Menü) kürzen, im Rahmen der von dir festgelegten Richtlinie. Die Seite listet deine Links mit Besuchen und letztem Besuch auf und lässt dich einen Link pausieren oder löschen.
- Im Terminal:
occ shortcloud:add <url> --user uid [--slug name],occ shortcloud:list,occ shortcloud:delete <id|slug>. Außerdem gibt es eine OCS-API für Skripte.
Tipps und Fehlerbehebung
- Kurzlinks liefern "404 Not Found". Die Rewrite-Regel ist nicht aktiv. Die Einstellungsseite und Administrationseinstellungen → Übersicht weisen darauf hin. Prüfe auf Apache
mod_rewriteundAllowOverride All; füge auf nginx den Snippet aus der Einstellungsseite ein. - Die Regel ist nach einem Nextcloud-Update verschwunden. Sie wird beim nächsten App-Update, beim ersten Request nach dem Versionswechsel oder durch die tägliche Prüfung wiederhergestellt;
occ shortcloud:setupstellt sie sofort wieder her. - Ein Kurzlink antwortet mit "gone". Seine Freigabe wurde gelöscht oder ist abgelaufen – die App antwortet mit 410 Gone, statt auf etwas weiterzuleiten, das es nicht mehr gibt. Das ist das gewünschte Verhalten, kein Bug.
- "Short links to this site are not allowed" beim Kürzen einer Adresse: Externe Ziele werden standardmäßig abgelehnt. Erlaube den Host (oder jede Adresse) unter Ziele.
- "Short links to this address are blocked" bei einem erlaubten Host: Die Adresse steht auf der Anti-Missbrauchsliste. Die App hat keine eingebaute Liste; der Lizenzserver kann eine signierte Liste von Hosts und URL-Fragmenten liefern, die bekanntermaßen für Phishing oder Malware genutzt werden, und diese gilt zusätzlich zu deiner eigenen Richtlinie. Sie ist standardmäßig leer – Link-Shortener wie bit.ly sind nicht blockiert, weil viele Teams sie legitim teilen – und wird nur für Ziele gefüllt, die tatsächlich missbraucht wurden. Wenn eine Adresse, die du brauchst, abgelehnt wird, schreib uns über die Kontaktseite.
- Datenschutz: Pro Link speichert die App Besitzer, Domain, Endung, Ziel, die zugehörige Freigabe, ein Label (den Dateinamen), Status, Besuchszähler und Zeitpunkt des letzten Besuchs. Es werden keine Besucherdaten gespeichert, der Besuchszähler kann also bedenkenlos aktiviert bleiben.
- Pausieren: Einen einzelnen Link pausieren oder die Erstellung für alle pausieren bricht bestehende Links nie. Das Deaktivieren der App behält jeden Link; beim erneuten Aktivieren sind sie unverändert wieder da.
- Gruppenlimits: Wenn nur bestimmte Teams Links erstellen sollen, beschränke die Erstellung auf ausgewählte Gruppen – Administratoren dürfen immer.
Fazit
Ein Kurzlink auf deiner eigenen Domain ist eine kleine Änderung mit echtem Nutzen: Freigabe-URLs, denen Menschen genug vertrauen, um sie anzuklicken, zu drucken und einzutippen. Shortcloud behält den Redirector auf deinem Server, erstellt automatisch Kurzlinks für neue Freigaben, füllt alte nach und bleibt ehrlich, wenn eine Freigabe nicht mehr existiert. Installiere es, bestätige die Rewrite-Regel auf der Einstellungsseite, und der nächste Link, den du teilst, lässt sich viel leichter weitergeben. Mehr Hintergrund findest du in der Wissensdatenbank und den FAQ; das Changelog zeigt, was sich in jeder Version geändert hat.