Les longs liens de partage Nextcloud sont difficiles à vendre. Une URL comme https://cloud.example.com/index.php/s/aBcDeFg12345678 ressemble à ce qu'enverrait un escroc, se lit mal au téléphone et se coupe bizarrement sur un document imprimé. Si vous hébergez votre propre serveur, vous pouvez corriger cela sans confier vos liens à un raccourcisseur tiers : Shortcloud est un plugin Nextcloud qui attribue à chaque partage public une adresse courte sur votre domaine et la redirige vers le partage réel. Ce tutoriel détaille l'installation, la mise en place de la règle de réécriture et l'usage des fonctions du quotidien : liens courts automatiques pour les partages nouveaux et anciens, fins personnalisées, domaines courts supplémentaires, QR codes, partages expirés qui répondent 410 Gone, et suppression de /index.php dans vos adresses.
Tout ce qui suit provient de la documentation du produit. Pour la référence complète, consultez le guide d'utilisation et la page du produit.
Le problème résolu
Un lien court comme cloud.example.com/go/abc1234 se tape facilement, s'imprime facilement et semble appartenir à votre organisation. Shortcloud en crée un automatiquement pour chaque nouveau partage par lien public — que le partage ait été créé depuis l'interface web, le client de bureau ou un client mobile. Votre domaine reste votre domaine, et le redirecteur est votre propre serveur, pas un service de raccourcissement public.
Prérequis
- Nextcloud 32 à 34 avec PHP 8.1 ou plus récent.
- Une règle de réécriture dans votre serveur web. Sur Apache avec
mod_rewriteetAllowOverride All, l'application l'écrit elle-même dans le.htaccessde Nextcloud et la conserve lors des mises à jour. Sur nginx ou un hôte virtuel, la page de réglages affiche l'extrait à ajouter. - Pour un domaine court supplémentaire : un DNS pointant vers le serveur, un certificat TLS et un hôte virtuel (la page de réglages les affiche).
- Une clé de licence depuis votre compte MediaLab Works — vous pouvez démarrer l'essai gratuit de 30 jours depuis l'application.
Étape 1 — Installer et activer l'application
Téléchargez l'archive shortcloud-x.y.z.tar.gz depuis Licences dans votre compte, puis extrayez-la dans votre dossier d'applications pour 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
Vous pouvez aussi l'activer depuis la page Applications.
Étape 2 — Activer la licence
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.
Bon à savoir : la licence est vérifiée une fois par jour. Sans accès à Internet, l'application continue de fonctionner pendant 7 jours après la dernière vérification réussie ; passé ce délai, elle s'arrête jusqu'à pouvoir vérifier à nouveau. Sans licence valide, rien n'est supprimé — chaque lien court est conservé et refonctionne dès que la licence est valide, et seule la section Licence reste utilisable entre-temps.
Étape 3 — Vérifier que la règle de réécriture fonctionne
Nextcloud ne permet pas à une application tierce de répondre elle-même sur /go/…, donc une règle de réécriture y envoie ces requêtes. 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 : la page teste l'adresse courte en HTTP et vous 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'elle écrit ressemble à ceci :
# 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 le .htaccess, l'application le remet en place. Depuis un terminal, vous pouvez aussi utiliser occ shortcloud:setup (avec --check et --remove).
Étape 4 — Ajuster les réglages
La même page de réglages contrôle le comportement du raccourcisseur :
| Réglage | Signification |
|---|---|
| Pause | Aucun nouveau lien court ; les liens existants continuent de fonctionner. |
| Liens courts automatiques | Un pour chaque nouveau partage par lien public. |
| Préfixe de chemin | /go/ par défaut ; le modifier réécrit la règle. |
| Longueur des fins aléatoires | 7 par défaut, sans caractères ambigus. |
| Qui peut créer | Tout le monde, ou seulement certains groupes. Les administrateurs peuvent toujours. |
| Cibles | Seulement ce Nextcloud (par défaut), une liste d'hôtes, ou toute adresse. Les liens de partage sont toujours autorisés. |
| Fins réservées | Noms jamais attribués. |
| Domaines courts personnalisés | Hôtes supplémentaires, avec un préfixe facultatif. |
| URL sans /index.php | Masque /index.php dans toutes les adresses (les anciennes adresses continuent de fonctionner). |
Un point de départ raisonnable pour la plupart des auto-hébergeurs : laissez Cibles sur Seulement ce Nextcloud (pour que votre domaine ne devienne jamais un redirecteur ouvert), gardez le préfixe par défaut et activez URL sans /index.php.
Étape 5 — Partager des fichiers et copier le lien court
Partagez un fichier ou un dossier par lien comme d'habitude, puis ouvrez le menu … du partage par lien dans la barre latérale de partage et choisissez Copier le lien court. Lien court… permet de modifier la fin et affiche le QR code — pratique pour des documents imprimés, des diapositives ou une affiche lors d'un événement communautaire.
Les albums comptent aussi : les liens d'albums publics des applications Photos et Memories reçoivent également des liens courts.
Étape 6 — Attribuer des liens courts aux anciens partages
Les partages créés avant l'application n'ont pas encore de lien court. Rattrapez-les :
sudo -u www-data php occ shortcloud:backfill --dry-run
sudo -u www-data php occ shortcloud:backfill
Vous pouvez limiter l'exécution à un utilisateur avec --user uid, et testez toujours d'abord avec --dry-run.
Étape 7 — Fins personnalisées, domaines supplémentaires et liens manuels
- Fins personnalisées : le domaine est fixe, le reste vous appartient — par exemple
/go/rapport-annuel. - Domaines courts supplémentaires : par exemple
https://cc.link/abc1234, servis par le même serveur. Faites pointer son DNS vers le serveur, obtenez un certificat, ajoutez-le sous Domaines courts personnalisés, puis ajoutez l'hôte virtuel affiché par la page. Il n'a pas besoin d'être un domaine de confiance Nextcloud : seul le redirecteur y répond. - Toute adresse peut être raccourcie depuis la page Shortcloud (menu du haut), dans la limite de la politique que vous définissez. La page liste vos liens avec les visites et la dernière visite, et permet de mettre en pause ou de supprimer un lien.
- Depuis le terminal :
occ shortcloud:add <url> --user uid [--slug name],occ shortcloud:list,occ shortcloud:delete <id|slug>. Une API OCS est également disponible pour vos scripts.
Astuces et dépannage
- Les liens courts renvoient « 404 Not Found ». La règle de réécriture n'est pas active. La page de réglages et Paramètres d'administration → Vue d'ensemble l'indiquent. Sur Apache, vérifiez
mod_rewriteetAllowOverride All; sur nginx, ajoutez l'extrait de la page de réglages. - 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, à la première requête après le changement de version, ou par la vérification quotidienne ;
occ shortcloud:setupla restaure immédiatement. - Un lien court répond « gone ». Son partage a été supprimé ou a expiré — l'application répond 410 Gone au lieu de rediriger vers quelque chose qui n'existe plus. C'est le comportement prévu, pas un bug.
- « Les liens courts vers ce site ne sont pas autorisés » lors du raccourcissement d'une adresse : les cibles externes sont refusées par défaut. Autorisez l'hôte (ou toute 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 fournir une liste signée d'hôtes et de fragments d'URL connus pour servir au phishing ou à des logiciels malveillants, qui s'applique en plus de votre propre politique. Elle est vide par défaut — les raccourcisseurs comme bit.ly ne sont pas bloqués, car de nombreuses é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 via la page de contact.
- Confidentialité : pour chaque lien, l'application stocke le propriétaire, le domaine, la fin, la cible, le partage auquel il appartient, un libellé (le nom du fichier), le statut, le nombre de visites et la date de la dernière visite. Aucune donnée sur les visiteurs n'est stockée, vous pouvez donc laisser le compteur de visites activé.
- Mise en pause : mettre un lien en pause, ou suspendre la création pour tout le monde, ne casse jamais les liens existants. Désactiver l'application conserve tous les liens stockés ; la réactiver les rétablit tels quels.
- Limites par groupe : si seules certaines équipes doivent créer des liens, restreignez la création aux groupes choisis — les administrateurs peuvent toujours.
Conclusion
Un lien court sur votre propre domaine est un petit changement au bénéfice réel : des URL de partage que l'on ose cliquer, imprimer et recopier. Shortcloud garde le redirecteur sur votre serveur, crée automatiquement des liens courts pour les nouveaux partages, rattrape les anciens et reste honnête lorsqu'un partage n'existe plus. Installez-le, confirmez la règle de réécriture sur la page de réglages, et le prochain lien que vous partagerez sera bien plus facile à transmettre. Pour aller plus loin, consultez la base de connaissances et la FAQ ; le journal des modifications indique ce qui a changé à chaque version.