Loading...
Si vous avez déjà des applications en production sur un VPS — gérées avec PM2, servies via Nginx ou Apache, sécurisées avec SSL et pointées sur des domaines personnalisés — Klystrr vous permet de les importer sans toucher à ce qui fonctionne déjà.
Le scan n'écrit rien sur votre serveur. Votre application continue de tourner exactement comme avant.
Affichez le statut PM2, le port, le domaine et SSL en direct — sans configurer les déploiements.
Connectez votre dépôt Git et complétez la config de déploiement à votre propre rythme.
Ce guide est destiné aux développeurs qui ont déjà une ou plusieurs applications en production sur un VPS et souhaitent les intégrer à Klystrr sans perturber leur configuration actuelle.
Vous êtes probablement dans cette situation si vous avez :
Vous n'avez pas besoin de tout cela pour qu'un import fonctionne. Klystrr détectera ce qu'il peut et vous laissera compléter le reste manuellement.
Assurez-vous que les éléments suivants sont en place avant de commencer un import.
Votre VPS est connecté à Klystrr
Le serveur doit apparaître dans votre liste de serveurs Klystrr avec une connexion SSH fonctionnelle.
L'accès SSH est fonctionnel
Klystrr a besoin de se connecter au serveur pour exécuter le scan.
PM2 est installé sur le serveur
Si votre application utilise PM2 pour la gestion des processus.
Nginx ou Apache est installé
Si votre application est servie via un proxy inverse.
Git est installé sur le serveur
Si l'application a été déployée depuis un dépôt.
Accès à votre fournisseur DNS
Si les domaines font partie de la configuration et que vous prévoyez de les gérer.
Accès à votre compte GitHub ou GitLab
Si vous souhaitez que Klystrr gère les futurs déploiements de cette application.
Vous êtes responsable de votre propre serveur, de sa configuration, de ses identifiants, de ses fichiers d'application, de ses paramètres de domaine et de ses secrets. Klystrr opère sur les informations qu'il peut lire depuis votre serveur et n'assume aucune responsabilité pour les mauvaises configurations préexistantes.
L'import sûr est le flux d'import par défaut de Klystrr. Il est entièrement en lecture seule. Pendant un import sûr, Klystrr scanne votre serveur pour dresser un tableau de ce qui s'exécute. Il n'apporte aucune modification.
Klystrr ne fait spécifiquement PAS :
Le scan lit l'état du système et la configuration. Votre application continue de s'exécuter exactement comme avant, pendant et après le scan.
Le scan tente de détecter les informations suivantes depuis votre serveur. La détection peut être partielle selon la configuration de votre serveur, les permissions de fichiers et les outils installés.
Ouvrez votre liste de serveurs dans Klystrr et sélectionnez le serveur où l'application s'exécute. Confirmez que la connexion SSH est active.
Déclenchez le scan depuis la page de détail du serveur. Klystrr se connecte via SSH et inspecte PM2, Nginx, Apache, SSL, les métadonnées Git et les chemins du système de fichiers. Le scan s'exécute en arrière-plan et n'affecte pas les processus en cours.
Une fois le scan terminé, Klystrr affiche la liste des applications détectées sur le serveur. Chaque application montre les informations collectées : nom du processus, chemin, port, domaine et statut.
Choisissez l'application que vous souhaitez intégrer à Klystrr. Si une application n'a pas été détectée automatiquement, vous pouvez entrer ses détails manuellement.
Vérifiez les informations collectées par Klystrr. Corrigez ce qui a été détecté incorrectement ou est incomplet. Confirmez le chemin de l'application, le port, le domaine et le nom du processus PM2.
Assignez l'application importée à un nouveau projet Klystrr ou liez-la à un projet existant. C'est l'enregistrement que Klystrr utilisera pour suivre l'application.
Klystrr vous montre quelles parties de la configuration de déploiement sont manquantes : connexion du dépôt Git, commandes de build et de démarrage, variables d'environnement. Vous n'avez pas besoin de les compléter immédiatement.
Une fois importée, vous pouvez activer la supervision en temps réel. Cela permet à Klystrr d'afficher le statut PM2 en direct, le port, l'accessibilité du domaine et l'état SSL. L'activation ne modifie rien sur le serveur.
Quand vous êtes prêt pour que Klystrr gère les futurs déploiements, complétez la configuration complète : connexion du dépôt Git, commandes de build, et variables d'environnement.
Comprendre ces trois états évite toute confusion sur ce que Klystrr peut et ne peut pas faire à chaque étape.
Avant que Klystrr n'active l'action Déployer/Redéployer, les éléments suivants doivent être en place. Le bouton Déployer est intentionnellement désactivé jusqu'à ce que la configuration requise soit complète.
Pendant le scan, Klystrr peut détecter qu'un fichier .env est présent sur le serveur. Il ne lit que les noms des clés — jamais les valeurs.
DATABASE_URL = ••••••••
JWT_SECRET = ••••••••
API_KEY = ••••••••
Klystrr peut détecter des noms de domaine depuis votre configuration Nginx ou Apache. La détection est basée sur la lecture des directives server_name (Nginx) ou ServerName/ServerAlias (Apache).
Le DNS doit pointer vers le bon serveur
Klystrr lit la configuration depuis le serveur mais ne contrôle pas votre fournisseur DNS.
La propagation DNS prend du temps
Les modifications d'enregistrements DNS peuvent prendre de quelques minutes à plusieurs heures pour se propager globalement. Klystrr ne peut pas accélérer cela.
Les domaines personnalisés peuvent nécessiter une vérification
Selon votre configuration.
Klystrr ne gère pas automatiquement le DNS externe
À moins qu'une intégration de fournisseur DNS ne soit configurée séparément.
Quand le proxy Cloudflare est actif (nuage orange), les lookups DNS retournent les IPs de Cloudflare, pas votre IP VPS. C'est un comportement attendu. Klystrr utilise l'IP du serveur qu'il connaît déjà depuis votre connexion VPS.
Si des certificats SSL existent sur votre serveur d'origine, réglez le mode SSL/TLS de Cloudflare sur Full ou de préférence Full (strict). Utiliser le mode Flexible avec un certificat d'origine peut provoquer des boucles de redirection.
Le défi HTTP-01 de Certbot peut échouer si Cloudflare est en proxy et a des règles qui interfèrent avec le chemin /.well-known/acme-challenge/. Si c'est le cas, passez temporairement l'enregistrement DNS en DNS only pendant l'émission du certificat.
Klystrr détecte qu'un domaine utilise Cloudflare basé sur les plages d'IP et les en-têtes. L'intégration directe avec l'API Cloudflare pour la gestion automatisée du DNS ou des certificats n'est pas encore disponible.
Le scénario le plus courant. Klystrr détecte le processus PM2, lit le bloc server Nginx, identifie le domaine et le port upstream, et vérifie SSL. Après l'import, l'application est visible dans Klystrr. Connectez votre dépôt Git et configurez les commandes de déploiement quand vous êtes prêt.
Le flux est identique à Nginx. Klystrr lit le fichier VirtualHost Apache, détecte le domaine et la configuration proxy, et vérifie SSL. L'analyse de configuration Apache dépend des directives standard ProxyPass et ProxyPassReverse.
Si votre application s'exécute sur un port nu sans domaine configuré, Klystrr détectera le processus PM2 et le port d'écoute. La détection du domaine et SSL s'affichera comme non configurée. Vous pouvez ajouter un domaine ultérieurement.
Si l'application a été déployée manuellement sans cloner de dépôt Git, Klystrr ne détectera aucune métadonnée Git. C'est attendu. Vous pouvez toujours importer l'application — la gestion des déploiements nécessitera un dépôt connecté ultérieurement.
L'import fonctionne normalement. Klystrr lit la configuration de votre serveur directement via SSH et ne dépend pas du DNS public. La détection SSL lit le certificat d'origine directement, pas via le proxy Cloudflare. Tenez compte des limitations de mode SSL décrites dans la section Cloudflare.
Klystrr détecte si des certificats SSL sont présents sur le serveur. Il ne les modifie pas, ne les renouvelle pas et ne les révoque pas pendant l'import. Si vous redéployez ultérieurement via Klystrr, la configuration SSL fera partie de la configuration de déploiement.
Cliquez sur un problème pour développer le diagnostic et les solutions.
Avant et pendant la migration, suivez ces pratiques pour éviter de perturber votre application en cours d'exécution.
Si votre VPS est déjà connecté à Klystrr, vous pouvez démarrer un scan depuis la page de détail du serveur maintenant. Votre application continue de fonctionner tout au long du processus.