Accueil/Article
Esadax JournalApps

Mec.

Qu'est-ce que Kutt? Kutt est une plateforme de raccourcissement d'URL moderne, open-source et auto-hébergée conçue pour créer, gérer et surveiller les liens raccourcis. Il permet

Mec. logo

Qu'est-ce que Kutt?

Kutt est une plateforme de raccourcissement d'URL moderne, open-source et auto-hébergée conçue pour créer, gérer et surveiller les liens raccourcis.

Il permet aux utilisateurs de transformer de longues URL en adresses courtes et mémorables en utilisant leurs propres domaines. Kutt fournit un tableau de bord centralisé pour gérer les liens, surveiller les statistiques de clics et contrôler l'accès aux URL raccourcies.

La plate-forme prend en charge les alias d'URL personnalisés, les liens protégés par mot de passe, les dates d'expiration et les analyses privées. Il fournit également une API RESTful pour intégrer la fonctionnalité de raccourcissement d'URL dans des applications externes, des scripts et des flux de travail automatisés.

Kutt est particulièrement utile pour les entreprises, les développeurs, les créateurs de contenu et les organisations qui souhaitent gérer des liens courts de marque tout en conservant le contrôle de leur infrastructure et de leurs données.

Histoire de Kutt

Kutt est un projet de raccourcissement d'URL open-source développé à l'origine par The Devs.

Le projet a été créé pour fournir une alternative moderne aux services commerciaux de raccourcissement d'URL, en mettant l'accent sur l'auto-hébergement, la personnalisation et la confidentialité.

Kutt a évolué pour prendre en charge les domaines personnalisés, la gestion des liens, les statistiques privées, l'administration des utilisateurs et les intégrations API.

L'application est construite avec Node.js et fournit une option de déploiement basée sur Docker, ce qui facilite son fonctionnement sur les serveurs personnels et l'infrastructure cloud.

Kutt est distribué sous la licence MIT.

Principales caractéristiques de Kutt

Kutt fournit un ensemble complet de fonctionnalités pour créer et gérer des URL raccourcies.

  • Raccourcissement d'URL: Convertissez les URL longues en liens courts et partageables.
  • Domaines personnalisés: Utilisez votre propre domaine pour les URL raccourcies de marque.
  • Alias d'URL personnalisés: Créez des liens courts mémorables avec des identifiants personnalisés.
  • Cliquez sur Analytics: Surveillez les statistiques pour les URL raccourcies individuelles.
  • Statistiques privées: Accédez aux informations de performance des liens via l'interface de gestion.
  • Liens protégés par mot de passe: Restreindre l'accès aux URL raccourcies à l'aide de mots de passe.
  • Expiration du lien: Configurez les dates d'expiration pour les liens temporaires.
  • Modification de lien: Modifier les URL de destination sans changer l'adresse courte existante.
  • Descriptions des liens : Ajoutez des descriptions pour organiser et identifier les liens raccourcis.
  • Gestion des utilisateurs: Gérer les comptes d'utilisateurs et lier la propriété via l'interface d'administration.
  • RESTful API: Créez, récupérez, modifiez et supprimez des URL raccourcies par programmation.
  • Contrôles d'enregistrement: Désactivez l'enregistrement public pour garder une instance privée.
  • Contrôles de lien anonyme: Exigez une authentification avant que les utilisateurs puissent créer des URL raccourcies.
  • OpenID Connect: Prend en charge les fournisseurs d'authentification externes via OIDC.
  • Thèmes personnalisés: Personnaliser l'apparence de l'application en utilisant CSS, images et modèles.
  • Extensions de navigateur: Intégrez le raccourcissement d'URL dans les navigateurs pris en charge.
  • Flexibilité de la base de données: Support SQLite, PostgreSQL et MySQL / MariaDB.
  • Prise en charge de Docker : Déployez l'application à l'aide d'images Docker officielles et de configurations Compose.

Cas d'utilisation

Kutt convient aux particuliers et aux organisations qui ont besoin d'un service de raccourcissement d'URL centralisé.

Les cas d'utilisation courants incluent:

  • Business Marketing: Créer des liens de marque pour les publicités, les bulletins d'information et les campagnes promotionnelles.
  • Gestion des médias sociaux: Générer des URL plus courtes pour le partage sur les réseaux sociaux.
  • Intégrations de développeurs: Intégrez le raccourcissement d'URL dans les applications via l'API REST.
  • Infrastructure interne: Hébergez un service privé de raccourcissement d'URL pour les employés et les applications internes.
  • Marketing d'affiliation: Organiser et gérer les liens de suivi pour les campagnes promotionnelles.
  • Publication de contenu: Créez des liens mémorables pour les articles, les vidéos et les ressources téléchargeables.
  • Partage temporaire: Générez des liens avec protection par mot de passe et dates d'expiration.
  • Automatisation des applications: Raccourcissez automatiquement les URL via des scripts et des intégrations externes.
  • Communication de marque: Utilisez des domaines personnalisés pour maintenir une image de marque cohérente sur les liens partagés.

Avantages de Kutt

  • Raccourcissement d'URL open-source et auto-hébergé
  • Prend en charge les domaines personnalisés et les liens de marque
  • Fournit des statistiques de clics privés
  • Permet des alias d'URL personnalisés
  • Prend en charge la protection par mot de passe et l'expiration des liens
  • Inclut l'édition et la gestion des liens
  • Fournit une API RESTful pour les intégrations
  • Prend en charge plusieurs backends de base de données
  • Comprend la gestion des utilisateurs et des accès
  • Prend en charge l'authentification OpenID Connect
  • Offre des thèmes et des modèles personnalisables
  • Peut être déployé en utilisant Docker
  • Offre un meilleur contrôle sur les URL raccourcies et les données associées

Comment installer Kutt

Pour installer Kutt via Esadax, suivez ces étapes:

  1. Achetez l'application via Esadax.
  2. Après l'achat, vous serez invité à fournir les paramètres de configuration requis.
  3. Entrez vos valeurs de configuration, y compris le domaine public et les paramètres d'authentification si nécessaire.
  4. Configurez la connexion à la base de données si vous utilisez une base de données externe.
  5. Configurez Redis si activé par le package de déploiement.
  6. Cliquez sur Déployer pour lancer l'application.
  7. Accédez à l'interface Kutt via son URL d'application attribuée.
  8. Terminez la configuration initiale du compte administrateur.
  9. Configurez votre domaine personnalisé si nécessaire.
  10. Commencez à créer des URL raccourcies et à surveiller leurs performances.

Une fois déployé, Kutt fournit un tableau de bord centralisé pour la gestion des liens, des utilisateurs et des analyses.

Gestion des URL

Kutt fournit un tableau de bord pour créer, organiser et gérer les URL raccourcies.

Les utilisateurs peuvent créer des liens en soumettant une URL de destination et en configurant éventuellement des paramètres supplémentaires.

Les options de lien disponibles comprennent:

  • Identifiants d'URL courtes personnalisés
  • Protection par mot de passe
  • Descriptions des liens
  • Dates d ' expiration
  • Modification de l'URL de destination

Les utilisateurs peuvent examiner leurs liens existants, mettre à jour les adresses de destination ou supprimer les liens qui ne sont plus nécessaires.

Cela rend Kutt adapté à la gestion de grandes collections d'URL raccourcies sans dépendre de services de raccourcissement externes.

Soutien de domaine personnalisé

L'une des principales caractéristiques de Kutt est la possibilité d'utiliser des domaines personnalisés pour les liens raccourcis.

Au lieu de partager des liens via un domaine de raccourcissement générique, les organisations peuvent configurer leurs propres domaines pour créer des URL de marque.

Par exemple :

  • https://example.com/documentation
  • https://links.example.com/product
  • https://go.example.com/campaign

Pour configurer un domaine personnalisé:

  1. Configurez le domaine ou sous-domaine souhaité dans votre fournisseur DNS.
  2. Pointez l'enregistrement DNS vers le serveur hébergeant Kutt.
  3. Configurez le domaine dans l'application Kutt.
  4. Définissez le domaine par défaut approprié dans la configuration de déploiement.
  5. Configurez HTTPS et des certificats TLS valides pour le domaine.
  6. Vérifiez que les liens générés utilisent le domaine configuré.

Kutt prend également en charge HTTPS pour les liens de domaine personnalisés via son option de configuration CUSTOM_DOMAIN_USE_HTTPS.

Les certificats TLS pour les domaines personnalisés doivent être configurés séparément.

Analyse et statistiques

Kutt fournit des statistiques privées pour les URL raccourcies, permettant aux utilisateurs de surveiller les performances des liens.

L'interface d'analyse aide les utilisateurs à comprendre comment leurs liens partagés sont consultés.

Les utilisateurs peuvent consulter les statistiques associées à leurs URL raccourcies et identifier les liens qui reçoivent le plus d'activité.

Les analyses sont utiles pour :

  • Surveillance de l'activité de clic de lien
  • Comparaison des performances de différentes URL
  • Évaluer les campagnes marketing
  • Identifier les ressources partagées populaires
  • Mesurer l’engagement généré par les liens publiés

Les statistiques sont accessibles via l'interface de gestion de l'application.

API et intégrations

Kutt fournit une API RESTful qui permet aux applications externes d'interagir avec la plateforme de raccourcissement d'URL.

L'API peut être utilisée pour automatiser la création et la gestion des liens sans accéder manuellement à l'interface Web.

Les scénarios d'intégration courants incluent:

  • Création d'URL raccourcies à partir de scripts.
  • Générer des liens automatiquement à partir d'applications web.
  • Récupération d'informations sur les URL raccourcies existantes.
  • Mise à jour des URL de destination par programmation.
  • Suppression des URL raccourcies.
  • Intégrer le raccourcissement d'URL dans les systèmes de gestion de contenu.
  • Création de tableaux de bord personnalisés et de flux de travail automatisés.

L'authentification API utilise les informations d'identification générées via l'application Kutt.

Kutt prend également en charge les intégrations avec des outils tels que ShareX et les extensions de navigateur pour un raccourcissement de lien pratique.

Sécurité / Administration / Configuration

Kutt fournit des fonctionnalités d'administration et de contrôle d'accès pour gérer les utilisateurs et contrôler qui peut créer des URL raccourcies.

Les options de sécurité comprennent:

  • Désactiver l'enregistrement des utilisateurs publics.
  • Restreindre la création de liens anonymes.
  • Configurez l'authentification via OpenID Connect.
  • Protégez les liens individuels avec des mots de passe.
  • Définissez des dates d'expiration pour les liens temporaires.
  • Configurez l'authentification API.
  • Activez la limitation de débit pour les routes API prises en charge.
  • Configurez HTTPS via un proxy inverse.
  • Protégez les comptes administratifs avec des identifiants sécurisés.

Pour les déploiements publics, tenez compte des pratiques suivantes :

  • Utilisez un secret JWT fort et généré aléatoirement.
  • Activez HTTPS pour tous les accès aux applications.
  • Désactivez l'enregistrement lorsque les comptes publics ne sont pas requis.
  • Restreindre la création de liens anonymes lors de l'utilisation d'un service privé.
  • Activez la limitation du débit pour réduire les abus.
  • Configurez correctement les paramètres du proxy de confiance.
  • Surveillez les liens soumis et supprimez les redirections malveillantes.
  • Limitez l'accès à la base de données et à Redis aux services de confiance.
  • Gardez Kutt et ses dépendances à jour.
  • Maintenir des sauvegardes régulières de la base de données.

Les raccourcisseurs d'URL peuvent être utilisés à mauvais escient pour distribuer des liens de phishing et rediriger les utilisateurs vers des sites Web malveillants. Les déploiements publics devraient inclure des procédures appropriées de signalement des abus et de modération.

Meilleures pratiques pour Kutt

  • Utilisez un domaine ou un sous-domaine dédié pour les URL raccourcies.
  • Choisissez des alias d'URL personnalisés reconnaissables et cohérents.
  • Activez HTTPS pour tous les domaines configurés.
  • Configurez l'expiration des liens pour les ressources temporaires.
  • Utilisez la protection par mot de passe pour les destinations sensibles.
  • Désactiver l'inscription publique lors de l'exploitation d'un service interne.
  • Restreindre la création de liens anonymes le cas échéant.
  • Activez la limitation de débit pour les instances publiques.
  • Protégez les identifiants API et les secrets JWT.
  • Surveillez régulièrement les statistiques des liens.
  • Examinez les liens signalés et les activités suspectes.
  • Sauvegardez la base de données et la configuration de l'application.
  • Gardez l'application et les dépendances à jour.

Paramètres de configuration

Après avoir acheté cette application sur Esadax, vous serez invité à fournir les paramètres de configuration requis par le déploiement.

Esadax ajoute les variables fournies au déploiement afin que l'application puisse être lancée avec la configuration requise.

Kutt prend en charge la configuration via des variables d'environnement ou un fichier .env.

Voici les paramètres de configuration courants pris en charge par le déploiement officiel de Kutt :

Paramètre Description :
JWT_SECRET Secret utilisé pour signer les jetons d'authentification. Requis pour les déploiements de production.
PORT Port utilisé par l'application. La valeur par défaut est 3000.
SITE_NAME Nom affiché dans l'interface de l'application.
DEFAULT_DOMAIN Domaine utilisé lors de la génération des URL raccourcies.
LINK_LENGTH Longueur par défaut des identifiants URL courts générés automatiquement.
DISALLOW_REGISTRATION Désactive l'enregistrement des utilisateurs publics.
DISALLOW_LOGIN_FORM Désactive la connexion par e-mail et mot de passe lorsque l'authentification OIDC est activée.
DISALLOW_ANONYMOUS_LINKS Empêche les utilisateurs de créer des liens sans authentification.
TRUST_PROXY Contrôle si Kutt fait confiance aux en-têtes de proxy lorsqu'il opère derrière un proxy inverse.
DB_CLIENT Pilote de base de données, tel que better-sqlite3, pg ou mysql2.
DB_HOST Nom du serveur de base de données.
DB_PORT Port du serveur de base de données.
DB_NAME Nom de la base.
DB_USER Nom d'utilisateur de la base de données.
DB_PASSWORD Mot de passe de base de données.
DB_FILENAME Emplacement du fichier de base de données SQLite lors de l'utilisation de SQLite.
REDIS_ENABLED Active la mise en cache Redis.
REDIS_HOST Nom d'hôte du serveur Redis.
REDIS_PORT Port du serveur Redis.
REDIS_PASSWORD Mot de passe d'authentification Redis.
CUSTOM_DOMAIN_USE_HTTPS Génère des URL HTTPS pour les domaines personnalisés.
ENABLE_RATE_LIMIT Active la limitation de débit pour les routes API prises en charge.
MAIL_ENABLED Active la fonctionnalité e-mail.
MAIL_HOST Nom d'hôte du serveur SMTP.
MAIL_PORT Port du serveur SMTP.
MAIL_USER Nom d'utilisateur d'authentification SMTP.
MAIL_PASSWORD Mot de passe d'authentification SMTP.
MAIL_FROM Adresse e-mail de l'expéditeur.
OIDC_ENABLED Active l'authentification OpenID Connect.
OIDC_ISSUER URL d'émetteur OpenID Connect.
OIDC_CLIENT_ID Identifiant client OpenID Connect.
OIDC_CLIENT_SECRET OpenID Connect client secret.
REPORT_EMAIL Adresse e-mail utilisée pour recevoir les rapports de liens soumis.
CONTACT_EMAIL E-mail de contact du support affiché par l'application.

Toutes les variables d'environnement sont facultatives sauf JWT_SECRET en production. Les autres paramètres dépendent de la configuration de déploiement sélectionnée.

La base de données par défaut est SQLite, utilisant le pilote better-sqlite3. PostgreSQL, MySQL/MariaDB et Redis peuvent être configurés si nécessaire.

Une fois les valeurs requises configurées, cliquez sur Déployer pour lancer Kutt.

Base de données et stockage

Kutt prend en charge plusieurs configurations de base de données, ce qui le rend adapté à différentes tailles de déploiement.

Les bases de données prises en charge comprennent:

  • SQLite: Base de données par défaut pour les installations simples et légères.
  • PostgreSQL: Convient aux déploiements de production nécessitant un service de base de données dédié.
  • MySQL/MariaDB: Autres moteurs de bases de données relationnelles.

Redis peut éventuellement être activé pour la mise en cache.

Pour les déploiements Docker, Kutt fournit plusieurs configurations Compose:

  • docker-compose.yml - Configuration SQLite par défaut.
  • docker-compose.sqlite-redis.yml - SQLite avec Redis.
  • docker-compose.postgres.yml - PostgreSQL avec Redis.
  • docker-compose.mariadb.yml - MariaDB avec Redis.

Assurez-vous que le stockage persistant est configuré pour la base de données SQLite lorsque vous utilisez le moteur de base de données par défaut.

Pour les déploiements PostgreSQL et MariaDB, assurez-vous que les volumes de base de données et les sauvegardes sont gérés indépendamment.

Personnalisation et thèmes

Kutt prend en charge la personnalisation via un répertoire /custom dédié.

Les administrateurs peuvent modifier l'apparence et certains modèles d'application sans modifier le code source de l'application.

Les options de personnalisation comprennent:

  • Feuilles de style CSS personnalisées
  • Logos et images de remplacement
  • Favicons personnalisés
  • Modèles HTML personnalisés
  • Contenu de pied de page personnalisé
  • Actifs de thème supplémentaires

Cela permet aux organisations d'adapter l'interface de raccourcissement d'URL à leurs exigences visuelles et de marque.

Les modifications apportées aux ressources personnalisées peuvent nécessiter le redémarrage du conteneur d’application.

IV. CONCLUSION

Kutt est une plateforme de raccourcissement d'URL moderne et open source qui fournit des domaines personnalisés, une gestion des liens, des analyses privées et des intégrations API.

Avec la prise en charge des liens protégés par mot de passe, des dates d'expiration, des alias d'URL personnalisés, de l'administration des utilisateurs et de plusieurs serveurs de bases de données, il fournit les outils essentiels pour exploiter un service de raccourcissement d'URL centralisé.

Son architecture auto-hébergée donne aux organisations et aux particuliers le contrôle de leurs liens raccourcis, de leur infrastructure et de leurs données analytiques.

Kutt est une solution pratique pour les entreprises, les développeurs et les organisations à la recherche d'une alternative flexible aux plateformes commerciales de raccourcissement d'URL.

S’abonner