Shortcloud — installer le raccourcisseur de liens Nextcloud

Installation

Connectez-vous à votre compte MediaLab Works, ouvrez Licences et téléchargez l’archive de l’application shortcloud-x.y.z.tar.gz (disponible avec un abonnement actif, une licence à vie dans sa période de mises à jour, ou pendant l’essai gratuit de 30 jours).
Extrayez-la dans le dossier apps/ (ou custom_apps/) de Nextcloud, de sorte à obtenir apps/shortcloud/, appartenant à l’utilisateur du serveur web :
```
cd /var/www/nextcloud/apps
sudo tar -xzf ~/shortcloud-x.y.z.tar.gz
sudo chown -R www-data:www-data shortcloud
```
Activez-la : sudo -u www-data php occ app:enable shortcloud, ou depuis la page Applications.
Ouvrez Paramètres d’administration → Shortcloud → Licence, collez votre clé de licence et enregistrez. L’application contacte le serveur de licences, lie la clé à cette instance Nextcloud et affiche la licence comme Active.

Licence

La licence est vérifiée une fois par jour. Sans Internet, l’application continue de fonctionner 7 jours après la dernière vérification réussie ; après cela, elle est arrêtée jusqu’à pouvoir vérifier à nouveau.

Sans licence valide, l’application est arrêtée : les tâches de fond (synchronisation des albums, vérification des règles) ne s’exécutent pas, ses pages, ses adresses courtes et son API répondent avec la raison, et seule la section Licence continue de fonctionner (vous pouvez y commencer l’essai, saisir la clé ou renouveler). Rien n’est supprimé : chaque lien court est conservé et refonctionne dès que la licence est valide.

Configuration

La règle de réécriture. Nextcloud ne laisse pas une application tierce répondre elle-même à /go/…, donc une règle de réécriture envoie ces requêtes vers l’application. Sur Apache avec un .htaccess accessible en écriture, l’application l’écrit lors de la première requête après l’activation. Ouvrez Paramètres d’administration → Shortcloud : il teste l’adresse courte sur HTTP et indique si la règle fonctionne, propose Installer la règle de réécriture, et affiche l’extrait pour nginx ou un hôte virtuel. Le bloc qu’il écrit :

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

Le bloc survit à occ upgrade et occ maintenance:update:htaccess ; si une mise à jour du cœur remplace .htaccess, l’application le remet en place. Depuis un terminal : occ shortcloud:setup (--check, --remove).

Paramètres sur la même page :

Paramètre	Signification
Pause	Aucun nouveau lien court ; les existants continuent de fonctionner.
Liens courts automatiques	Un pour chaque nouveau partage par lien public.
Préfixe du chemin	`/go/` par défaut ; le changer réécrit la règle.
Longueur des terminaisons aléatoires	7 par défaut, sans caractères se ressemblant.
Qui peut créer	Tout le monde, ou seulement des groupes choisis. Les administrateurs peuvent toujours.
Cibles	Seul ce Nextcloud (par défaut), une liste d’hôtes, ou n’importe quelle adresse. Les liens de partage sont toujours autorisés.
Terminaisons réservées	Des noms jamais attribués.
Domaines courts personnalisés	Des hôtes supplémentaires, avec un préfixe facultatif.
Jolies URL	Masque `/index.php` dans chaque adresse (les anciennes adresses continuent de fonctionner).

Un domaine court supplémentaire : pointez son DNS vers le serveur, obtenez un certificat, ajoutez-le sous Domaines courts personnalisés, puis ajoutez l’hôte virtuel que la page affiche. Il n’a pas besoin d’être un domaine de confiance de Nextcloud : seul le redirecteur y répond.

Utilisation quotidienne

Partagez un fichier ou un dossier par lien comme d’habitude, puis utilisez Copier le lien court dans le menu … du partage par lien. Lien court… permet de changer la terminaison et affiche le QR code.
La page Shortcloud (menu du haut) liste vos liens avec les visites et la dernière visite, et permet de raccourcir toute adresse autorisée, de mettre un lien en pause ou de le supprimer.
Les partages existants faits avant l’application : sudo -u www-data php occ shortcloud:backfill [--dry-run] [--user uid].
Autres commandes : occ shortcloud:add <url> --user uid [--slug name], occ shortcloud:list, occ shortcloud:delete <id|slug>.
Désactiver l’application conserve chaque lien stocké ; la réactiver les fait réapparaître inchangés.

Dépannage

Les liens courts renvoient « 404 Not Found » : la règle de réécriture n’est pas active. La page des paramètres et Paramètres d’administration → Vue d’ensemble le disent. Sur Apache, vérifiez mod_rewrite et AllowOverride All ; sur nginx, ajoutez l’extrait de la page des paramètres.
La règle a disparu après une mise à jour de Nextcloud : elle est restaurée lors de la prochaine mise à jour de l’application, lors de la première requête après le changement de version, ou par la vérification quotidienne ; occ shortcloud:setup la restaure aussitôt.
Un lien court répond « gone » : son partage a été supprimé ou a expiré.
« Les liens courts vers ce site ne sont pas autorisés » en raccourcissant une adresse : les cibles externes sont refusées par défaut ; autorisez l’hôte (ou n’importe quelle adresse) sous Cibles.
« Les liens courts vers cette adresse sont bloqués » pour un hôte autorisé : l’adresse figure sur la liste anti-abus. L’application n’a pas de liste intégrée ; le serveur de licences peut livrer une liste signée d’hôtes et de fragments d’URL connus pour servir à l’hameçonnage ou aux logiciels malveillants, qui s’applique par-dessus votre propre politique. Elle est vide par défaut — les raccourcisseurs comme bit.ly ne sont pas bloqués, car beaucoup d’équipes les partagent légitimement — et n’est remplie que pour des cibles réellement abusées. Si une adresse dont vous avez besoin est refusée, écrivez-nous.