Agent distant Klipper Cloud
L'agent distant Klipper Cloud permet aux appareils FLYOS-FAST connectés à Internet de se connecter à Klipper Cloud, afin de lier et d'accéder à distance à l'ordinateur hôte actuel sur la plateforme cloud. L'image bêta FLYOS-FAST v1.4.0 génère les identifiants locaux de l'appareil au premier démarrage, mais l'accès distant est désactivé par défaut et doit être activé activement par l'utilisateur.
Cette fonctionnalité n'est actuellement confirmée que dans l'image bêta FLYOS-FAST v1.4.0. Une fois activée, l'appareil se connectera activement au service distant ; gardez-la désactivée lorsque l'accès distant n'est pas nécessaire.
L'ID de l'appareil, les identifiants locaux, la configuration de l'agent et les journaux contenant ces informations ne doivent pas être publiés sur des forums, des groupes de discussion ou tout autre emplacement public.
Avant de déplacer, chauffer ou exécuter du G-code à distance, vous devez vérifier que l'environnement de l'imprimante est sûr sur place et conserver des mesures permettant une coupure de courant immédiate ou un arrêt d'urgence. La latence du réseau, les interruptions de connexion ou la désynchronisation des états peuvent affecter les résultats des opérations. Il n'est pas recommandé de démarrer une impression à distance sans surveillance et sans possibilité de gérer les anomalies.
Description des fonctionnalités
- Une fois l'agent distant activé, vous pouvez lier l'ordinateur hôte actuel conformément aux instructions de la plateforme Klipper Cloud.
- La désactivation de l'agent distant arrête uniquement la connexion distante au cloud, sans affecter l'accès au réseau local de Fluidd, Mainsail, Moonraker et SSH.
- La présence d'un processus agent en arrière-plan ne signifie pas que l'accès distant est activé ; le processus agent peut simplement attendre l'autorisation de l'utilisateur.
- L'ID de l'appareil est utilisé pour identifier l'ordinateur hôte actuel. Il ne s'agit pas de l'ID USB de la carte mère, de l'UUID CAN ou de l'ID MCU dans la configuration de l'imprimante.
Procédure complète d'activation
1. Activer le service distant
Exécutez via SSH :
/data/klipper-cloud-agent/klipper-cloud-agent --enable-remote
Si aucune erreur n'est signalée après l'exécution de la commande, attendez que l'agent se connecte au cloud. N'exécutez pas la commande d'activation de manière répétée et consécutive.
2. Vérifier l'ID de l'appareil
Assurez-vous que le service cloud est activé et que l'ordinateur hôte peut accéder à Internet, puis exécutez :
/data/klipper-cloud-agent/klipper-cloud-agent --device-id
Une fois que la commande a correctement renvoyé l'ID de l'appareil, liez l'appareil conformément aux instructions de la plateforme Klipper Cloud. Lors de la copie, sélectionnez uniquement l'ID de l'appareil lui-même ; n'envoyez pas de capture d'écran complète du terminal à d'autres personnes.
L'image ci-dessus est une illustration des opérations dans le terminal ; l'ID de l'appareil est masqué. Veuillez vous référer au contenu réellement renvoyé par votre propre appareil.
3. Terminer la liaison sur la plateforme cloud
Ouvrez Gestion des appareils Klipper Cloud et connectez-vous avec votre propre compte. Lors de la première utilisation, veuillez d'abord lire les instructions d'utilisation, les conditions de service et les règles de confidentialité de la page.
Après la connexion, localisez la zone d'ajout d'appareils sous Mes appareils sur le côté gauche :
- Saisissez l'ID complet de l'appareil renvoyé par
--device-iddans Saisir l'ID de l'appareil KD-…. - Cliquez sur Ajouter.
- Attendez que l'appareil apparaisse dans la liste de gauche et confirmez que le statut affiche En ligne.
- Après avoir cliqué sur l'appareil, vous pouvez ouvrir l'interface de gestion de l'appareil distant sur la page ; pour ouvrir une fenêtre indépendante, cliquez sur Ouvrir dans une nouvelle fenêtre en haut à droite.
Les captures d'écran de la page de gestion des appareils ont été masquées pour le compte, le nom de l'appareil, l'ID de l'appareil et l'interface d'impression distante. Ne publiez pas publiquement des captures d'écran de pages contenant des informations réelles.
Après la liaison, vérifiez également les points suivants :
- L'appareil affiché sur la plateforme cloud correspond à l'ordinateur hôte actuel.
- La page distante peut lire l'état actuel de l'imprimante.
- Fluidd ou Mainsail sur le réseau local fonctionnent toujours correctement.
N'utilisez pas d'ID d'appareil fourni par d'autres personnes et ne liez pas votre propre appareil à un compte non fiable.
Désactivation du service distant
Lorsque l'accès distant n'est plus nécessaire, exécutez :
/data/klipper-cloud-agent/klipper-cloud-agent --disable-remote
Après la désactivation, l'accès au réseau local de Fluidd, Mainsail, Moonraker et SSH reste inchangé. Si vous prévoyez de transférer, réparer ou réinstaller l'appareil, vous devez également dissocier l'appareil sur la plateforme Klipper Cloud ; exécuter uniquement la commande de désactivation ne signifie pas dissocier la relation avec le compte cloud.
Dissociation de la plateforme cloud
Lorsque vous prévoyez de transférer, réparer ou ne plus utiliser l'appareil actuel, vous devez simultanément désactiver le service distant côté appareil et dissocier la plateforme :
- Exécutez d'abord
--disable-remoteen SSH. - Cliquez avec le bouton droit sur l'appareil dans la liste de gauche sur un ordinateur ; sur un téléphone ou un appareil tactile, appuyez longuement sur l'appareil.
- Sélectionnez Supprimer/Dissocier.
- Saisissez le nom actuel de l'appareil pour confirmer, comme indiqué sur la page.
La dissociation supprime la relation entre le compte actuel et l'appareil. La configuration enregistrée côté appareil, les fichiers d'impression et l'accès au réseau local ne sont pas supprimés pour autant.
Référence rapide des commandes
| Opération | Commande | Conditions d'utilisation |
|---|---|---|
| Vérifier le programme agent | test -x /data/klipper-cloud-agent/klipper-cloud-agent && echo "klipper-cloud-agent est installé" | Exécuter après connexion SSH |
| Activer le service distant | /data/klipper-cloud-agent/klipper-cloud-agent --enable-remote | L'ordinateur hôte est déjà connecté au réseau |
| Vérifier l'ID de l'appareil | /data/klipper-cloud-agent/klipper-cloud-agent --device-id | Le service distant est activé et le réseau fonctionne correctement |
| Désactiver le service distant | /data/klipper-cloud-agent/klipper-cloud-agent --disable-remote | À exécuter lorsque l'accès au cloud n'est plus nécessaire |