Shortcloud — den Nextcloud-Linkverkürzer installieren

Installation

Melde dich in deinem MediaLab-Works-Konto an, öffne Lizenzen und lade das App-Archiv shortcloud-x.y.z.tar.gz herunter (verfügbar mit aktivem Abonnement, einer Lifetime-Lizenz innerhalb ihres Update-Zeitraums oder während des kostenlosen 30-tägigen Testzeitraums).
Entpacke es in den Nextcloud-Ordner apps/ (oder custom_apps/), sodass du apps/shortcloud/ erhältst, 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 es: sudo -u www-data php occ app:enable shortcloud oder über die Seite Apps.
Öffne Verwaltungseinstellungen → Shortcloud → License, 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 Active an.

Lizenz

Die Lizenz wird einmal täglich geprüft. Ohne Internet arbeitet die App 7 Tage nach der letzten erfolgreichen Prüfung weiter; danach wird sie gestoppt, bis sie wieder prüfen kann.

Ohne gültige Lizenz wird die App gestoppt: Hintergrund-Jobs (Album-Sync, Regelprüfung) laufen nicht, ihre Seiten, Kurzadressen und die API antworten mit dem Grund, und nur der Abschnitt License funktioniert weiter (dort kannst du den Testzeitraum starten, den Schlüssel eingeben oder verlängern). Nichts wird gelöscht: Jeder Kurzlink bleibt erhalten und funktioniert wieder, sobald die Lizenz gültig ist.

Konfiguration

Die Rewrite-Regel. Nextcloud lässt es eine Dritt-App nicht von selbst unter /go/… antworten, deshalb leitet eine Rewrite-Regel diese Anfragen an die App. Auf Apache mit beschreibbarer .htaccess schreibt sie die App bei der ersten Anfrage nach der Aktivierung selbst. Öffne Verwaltungseinstellungen → Shortcloud: Die Seite testet die Kurzadresse über HTTP und sagt, ob die Regel funktioniert, bietet Install rewrite rule an und zeigt den Ausschnitt für nginx oder einen virtuellen Host. Der Block, den sie schreibt:

# BEGIN Shortcloud
<IfModule mod_rewrite.c>
  RewriteEngine on
  RewriteRule ^go/(.*)$ apps/shortcloud/go.php?slug=$1 [END,QSA]
</IfModule>
# END Shortcloud

Der Block überlebt occ upgrade und occ maintenance:update:htaccess; ersetzt ein Core-Update die .htaccess, setzt die App ihn zurück. Aus einem Terminal: occ shortcloud:setup (--check, --remove).

Settings auf derselben Seite:

Einstellung	Bedeutung
Pause	Keine neuen Kurzlinks; bestehende funktionieren weiter.
Automatic short links	Einer für jede neue öffentliche Linkfreigabe.
Path prefix	Standardmäßig `/go/`; beim Ändern wird die Regel neu geschrieben.
Length of random endings	Standardmäßig 7, ohne optisch verwechselbare Zeichen.
Who may create	Jeder oder nur ausgewählte Gruppen. Administratoren dürfen immer.
Targets	Nur diese Nextcloud (Standard), eine Liste von Hosts oder jede Adresse. Freigabelinks sind immer erlaubt.
Reserved endings	Namen, die nie vergeben werden.
Custom short domains	Zusätzliche Hosts, mit optionalem Präfix.
Pretty URLs	Verbirgt `/index.php` in jeder Adresse (alte Adressen funktionieren weiter).

Eine zusätzliche Kurzdomain: Richte ihre DNS auf den Server, hole ein Zertifikat, füge sie unter Custom short domains hinzu und ergänze den virtuellen Host, den die Seite anzeigt. Sie muss keine vertrauenswürdige Nextcloud-Domain sein: Nur der Weiterleiter antwortet dort.

Der tägliche Gebrauch

Teile eine Datei oder einen Ordner wie gewohnt per Link und nutze dann Copy short link im …-Menü der Linkfreigabe. Short link… lässt dich das Ende ändern und zeigt den QR-Code.
Die Seite Shortcloud (oberes Menü) listet deine Links mit Besuchen und letztem Besuch und lässt dich jede erlaubte Adresse verkürzen sowie einen Link pausieren oder löschen.
Bestehende Freigaben, die vor der App erstellt wurden: sudo -u www-data php occ shortcloud:backfill [--dry-run] [--user uid].
Weitere Befehle: occ shortcloud:add <url> --user uid [--slug name], occ shortcloud:list, occ shortcloud:delete <id|slug>.
Das Deaktivieren der App behält jeden gespeicherten Link; ein erneutes Aktivieren holt sie unverändert zurück.

Fehlerbehebung

Kurzlinks liefern „404 Not Found“: Die Rewrite-Regel ist nicht aktiv. Die Einstellungsseite und Verwaltungseinstellungen → Übersicht sagen es. Prüfe auf Apache mod_rewrite und AllowOverride All; füge auf nginx den Ausschnitt von der Einstellungsseite hinzu.
Die Regel war nach einem Nextcloud-Update verschwunden: Sie wird beim nächsten App-Update, bei der ersten Anfrage nach dem Versionswechsel oder durch die tägliche Prüfung wiederhergestellt; occ shortcloud:setup stellt sie sofort wieder her.
Ein Kurzlink antwortet „gone“: Seine Freigabe wurde gelöscht oder ist abgelaufen.
„Short links to this site are not allowed“ beim Verkürzen einer Adresse: Externe Ziele werden standardmäßig abgelehnt; erlaube den Host (oder jede Adresse) unter Targets.
„Short links to this address are blocked“ für einen erlaubten Host: Die Adresse steht auf der Missbrauchsliste. Die App hat keine eingebaute Liste; der Lizenzserver kann eine signierte Liste von Hosts und URL-Fragmenten liefern, von denen bekannt ist, dass sie für Phishing oder Malware genutzt werden — sie greift zusätzlich zu deiner eigenen Richtlinie. Sie ist standardmäßig leer — Linkverkürzer wie bit.ly sind nicht blockiert, weil viele Teams sie legitim nutzen — und wird nur für Ziele gefüllt, die tatsächlich missbraucht wurden. Wenn eine Adresse, die du brauchst, abgelehnt wird, schreib uns.