Comment installer Shlink sur Saplo (ton propre raccourcisseur de liens avec statistiques)

Sur un forfait payant, Bitly peut coûter bien plus de 100 euros par mois, avant même que tu dépasses la limite de liens raccourcis, car la facturation dépend du nombre d’adresses actives et des clics. Shlink est un raccourcisseur de liens open source, c’est le même principe que Bitly, mais il est hébergé sur ton propre Box, payé une seule fois, sans limite d’adresses ni facture mensuelle. Voici, étape par étape, comment installer Shlink sur Saplo.

Pourquoi héberger Shlink sur ton Box plutôt que sur Bitly

Les offres payantes de Bitly ont deux caractéristiques particulièrement pénibles lors des campagnes marketing et du suivi de liens à long terme :

• limitation du nombre de liens raccourcis et de clics par mois - le forfait gratuit suffit pour une seule campagne, pas pour toute une année de travail d'agence,
• données de clics conservées par une entreprise externe - les statistiques de trafic de tes campagnes restent sur les serveurs de Bitly, pas sur les tiens.

Shlink, c'est le même mécanisme de raccourcissement de liens et de comptage des clics que tu héberges sur ton Box. Aucune limite sur le nombre d'adresses, les données de clics restent sur ton infrastructure, et ton propre domaine de raccourcissement donne un aspect professionnel, au lieu d'un bit.ly générique.

Prérequis

Pour installer Shlink sur Saplo, tu as besoin de :

• une Box avec Docker activé (le moteur l'active automatiquement lors de l'installation depuis le Catalogue d'applications ; l'imbrication de conteneurs est nécessaire, et Saplo la propose par défaut),
• au moins 512 MB de RAM libre sur la Box et 2 GB d'espace disque,
• un domaine ou un sous-domaine *.saploapp.pl inclus dans le prix de chaque forfait, de préférence court, car il sera visible dans chaque lien raccourci.

Il vaut mieux distinguer immédiatement ce que Shlink est et ce qu'il n'est pas. Shlink est une API REST et un serveur de redirection de liens courts. Sur Saplo, tu l'obtiens avec son panneau d'administration officiel, accessible dans le navigateur à l'adresse de l'application et protégé par mot de passe. Tu n'as donc rien à installer ni à configurer. Pour l'installation proprement dite, tu n'as besoin d'aucune base de données externe, car, par défaut, Shlink conserve les données dans un fichier SQLite local, dans le volume de données. Tu peux toutefois choisir la base de données MySQL partagée de Saplo si tu prévois un trafic important.

Installation étape par étape

1. Dans le Panneau Saplo, accède au Catalogue d'applications et sélectionne Shlink (catégorie « Outils »).
2. Indique la Box sur laquelle l'application doit être installée, ainsi que le domaine ou le sous-domaine sous lequel les liens raccourcis fonctionneront, puis choisis la base de données : SQLite (par défaut, aucune infrastructure supplémentaire) ou MySQL (base de données Saplo mutualisée, préférable en cas de trafic important).
3. Confirme l'installation. Le moteur lance deux conteneurs Docker avec les images officielles shlinkio/shlink et shlinkio/shlink-web-client (panneau), génère une clé d'API et un mot de passe aléatoires pour le panneau, puis expose l'ensemble sous le domaine indiqué via nginx avec un SSL gratuit.
4. Le moteur attend que Shlink réponde effectivement à la requête de vérification de l'état de santé, et ce deux fois, avant de considérer l'installation comme terminée, car le premier lancement nécessite une migration du schéma de la base de données, qui peut prendre plus de quelques secondes.
5. Une fois l'installation terminée, dans les données initiales de l'application (fichier SHLINK-SETUP.txt), tu trouveras l'identifiant et le mot de passe du panneau, ainsi que la clé d'API.

Première configuration

Shlink, tout comme Grafana ou MinIO, génère automatiquement les identifiants lors de l'installation au lieu de vous les demander dans l'assistant.

1. Ouvrez les identifiants de départ de l'application dans le panneau Saplo (fichier SHLINK-SETUP.txt), vous y trouverez l'identifiant, le mot de passe et la clé API.
2. Cliquez sur Ouvrir à côté de l'application, connectez-vous et sélectionnez le serveur Mes liens. Le serveur est déjà associé à la clé API, vous n'avez rien à saisir.
3. Créez votre premier lien court dans l'onglet de création d'un lien, éventuellement avec votre propre code court plutôt qu'une suite aléatoire de caractères.
4. Consultez les statistiques de clics et le code QR du lien créé, ces deux fonctions sont intégrées et disponibles dès l'installation.

Les liens courts fonctionnent sur le même domaine sans mot de passe, le mot de passe protège uniquement le panneau. Votre propre code court ne peut pas s'appeler server, settings, assets ni icons, car ces adresses sont réservées au panneau.

Si vous préférez l'automatisation à la navigation dans l'interface, vous pouvez faire la même chose directement via l'API REST, par exemple en créant un lien court avec une seule commande :

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

Shlink sur Saplo contre Bitly

Questions fréquentes

Shlink propose-t-il un panneau web de connexion, comme WordPress ou Ghost ? Oui. Sur Saplo, à l'adresse de l'application, se trouve le panneau officiel de Shlink, protégé par un mot de passe. L'identifiant et le mot de passe figurent dans le fichier SHLINK-SETUP.txt. Tu peux également ajouter ce même serveur dans le client app.shlink.io ou l'administrer via l'API REST à l'aide de la clé contenue dans ce fichier.

Existe-t-il une limite au nombre de liens raccourcis ? Non, Shlink n'impose aucune limite sur le nombre d'adresses ou de clics, le seul facteur limitant étant la capacité du Box acheté.

Puis-je voir depuis quel pays le lien a été cliqué ? Par défaut, non. La géolocalisation des visites nécessite ta propre clé MaxMind gratuite, qui ne peut pas être créée automatiquement pendant l'installation. Sans elle, Shlink compte les clics normalement, mais sans indication du pays du visiteur.

Quelle est la différence entre SQLite et MySQL lors de l'installation ? SQLite est un fichier de base de données situé dans le volume de données, sans infrastructure supplémentaire, et il suffit dans la plupart des cas. MySQL est une base de données mutualisée sur Saplo, à privilégier uniquement lorsque le trafic de clics devient vraiment important.

Les données de Shlink sont-elles automatiquement sauvegardées ? Cela dépend du plan Box acheté. La sauvegarde fonctionne au niveau de l'ensemble du Box, comme pour les autres applications du catalogue. Ce n'est pas une fonctionnalité propre à Shlink.

Si tu as des questions sur la mise en place de Shlink sur ton propre Box ou la première configuration du panneau, écris-nous, nous t'aiderons à faire la configuration initiale.