Tous les produits
Search
Centre de documentation

Elastic Compute Service:Connect to an instance by using Workbench CLI

Dernière mise à jour :Oct 19, 2026

Accédez à une instance ECS Linux dépourvue d'adresse IP publique depuis votre ligne de commande locale, sans mot de passe. Effectuez des connexions interactives, exécutez des commandes à distance et transférez des fichiers. Workbench CLI est également nativement adapté aux agents d'IA : sa sortie JSON structurée permet aux agents d'analyser directement les résultats et de déterminer le succès ou l'échec en fonction des codes de sortie des commandes.

Présentation de Workbench CLI

Important

Workbench CLI prend actuellement en charge la connexion uniquement aux instances Linux (via le protocole SSH). Il ne prend pas en charge la connexion aux instances Windows. Pour vous connecter à une instance Windows, consultez la rubrique Connexion à une instance à l'aide de Workbench.

Workbench CLI (la commande est workbench) est un outil en ligne de commande fourni par Alibaba Cloud ECS pour se connecter aux instances. Il convient aux utilisateurs suivants :

  • Utilisateurs humains : Lorsqu'aucune adresse IP publique n'est attribuée à une instance, utilisez la ligne de commande pour effectuer une connexion interactive, exécuter des commandes à distance et transférer des fichiers (téléchargement et envoi), en alternative à une connexion SSH directe.

  • Agents d'IA : Grâce à la sortie JSON structurée (--output json) et à la transmission des codes de sortie, les outils de programmation IA (tels que Wukong et opencode) peuvent appeler directement la commande workbench pour gérer les instances ECS, sans adaptation supplémentaire.

Les fonctionnalités principales de Workbench CLI sont les suivantes :

  • Connexion interactive : La commande workbench connect ouvre une session PTY et prend en charge trois méthodes d'authentification : sans mot de passe, par mot de passe et par clé.

  • Exécution de commandes à distance : La commande workbench exec exécute une seule commande sur une instance et renvoie le résultat au format texte ou JSON.

  • Transfert de fichiers : Les commandes workbench upload et workbench download transfèrent des fichiers entre votre ordinateur et une instance en utilisant OSS comme relais.

  • Gestion des sessions et du daemon : Les commandes workbench session et workbench daemon servent au diagnostic et au nettoyage manuel. Aucune intervention n'est requise pour une utilisation quotidienne.

  • Assistant IA en session : Dans une session interactive connect, appuyez sur Tab ou Ctrl+A pour invoquer l'assistant IA et utiliser le langage naturel afin que l'IA exécute des commandes sur l'instance.

Comparaison avec les autres méthodes de connexion aux instances ECS

Alibaba Cloud ECS propose trois méthodes de connexion basées sur Workbench ou Session Manager qui ne nécessitent pas d'adresse IP publique. Le tableau suivant compare ces méthodes.

Fonctionnalité

Workbench (web)

Workbench CLI

CLI Session Manager (ali-instance-cli)

Interaction

Interface graphique du navigateur

Ligne de commande locale

Ligne de commande locale

Adresse IP publique requise

Non

Non

Non

Systèmes d'exploitation d'instance pris en charge

Linux et Windows

Linux uniquement (via le protocole SSH)

Linux et Windows

Commandes à distance et transfert de fichiers

Opérations manuelles dans le terminal web

Commandes natives : exec, upload et download

Sessions de terminal uniquement ; nécessite des scripts supplémentaires

Conçu pour les agents d'IA

Non

Oui (sortie JSON structurée et transmission des codes de sortie)

Non

Scénarios typiques

Dépannage ponctuel et accès au bureau Windows

Scripts d'exploitation et de maintenance quotidiens et assistants de programmation IA

Scripts existants nécessitant uniquement des sessions de terminal

Recommandations pour sélectionner une méthode :

  • Si vous avez besoin d'une interface graphique ou si vous devez vous connecter à une instance Windows, utilisez la méthode décrite dans la rubrique Connexion à une instance à l'aide de Workbench.

  • Pour gérer des instances Linux depuis la ligne de commande ou via des outils de programmation IA, utilisez Workbench CLI.

  • Si vous disposez déjà de scripts ali-instance-cli et n'avez besoin que de sessions de terminal, vous pouvez continuer à les utiliser. Pour plus d'informations, consultez la rubrique Connexion à une instance à l'aide d'ali-instance-cli.

Limites

  • Système d'exploitation de l'instance : Seules les instances Linux sont prises en charge (via le protocole SSH). Les instances Windows ne sont pas prises en charge.

  • Agent Cloud Assistant : L'instance cible doit avoir l'agent Cloud Assistant installé et en cours d'exécution correcte. Les instances ECS créées à partir d'images publiques officielles après le 1er décembre 2017 disposent de l'agent Cloud Assistant préinstallé par défaut. Dans le cas contraire, vous devez l'installer manuellement.

  • Règles de groupe de sécurité : Lors de la première connexion, la CLI ajoute automatiquement une règle de groupe de sécurité interne pour l'instance (port TCP 22, avec 100.104.0.0/16 autorisé). Si votre compte ne dispose pas des autorisations de groupe de sécurité, ajoutez la règle manuellement dans la console ECS.

  • Connectivité réseau : Votre ordinateur doit pouvoir accéder à *.aliyuncs.com et au point de terminaison WebSocket backend de Workbench. Les commandes upload et download nécessitent que l'instance puisse accéder au point de terminaison OSS interne de la région correspondante.

Important

Les instances Windows ne sont actuellement pas prises en charge par Workbench CLI. N'utilisez pas workbench connect pour les instances Windows.

Démarrage rapide

Effectuez votre première connexion en 5 minutes en suivant les trois étapes ci-dessous. Pour des instructions détaillées sur l'installation, les identifiants et les commandes, consultez les rubriques Installation de Workbench CLI et configuration des identifiants et Gestion des instances ECS à l'aide de Workbench CLI.

Étape 1 : Installer Workbench CLI

Sélectionnez une commande d'installation en fonction du système d'exploitation de votre ordinateur. Le script d'installation détecte automatiquement l'architecture (amd64 ou arm64) et installe l'outil dans le chemin système par défaut.

Linux ou macOS

curl -fsSL https://workbench-cli.oss-cn-hangzhou.aliyuncs.com/install.sh | bash

Windows

irm https://workbench-cli.oss-cn-hangzhou.aliyuncs.com/install.ps1 | iex

Étape 2 : Configurer une paire AccessKey

Exécutez la commande suivante et saisissez l'AccessKey ID et l'AccessKey secret lorsque vous y êtes invité.

workbench config

Une fois la configuration terminée, les identifiants sont enregistrés dans ~/.workbench/config.json et les permissions du fichier sont automatiquement définies sur 0600 (lecture et écriture pour l'utilisateur actuel uniquement). Dans les environnements de production, nous vous recommandons d'utiliser les identifiants de rôle RAM plutôt qu'une paire AccessKey statique. Pour plus d'informations sur la méthode de configuration, consultez la rubrique Installation de Workbench CLI et configuration des identifiants.

Étape 3 : Se connecter à une instance

Exécutez la commande suivante pour vous connecter à l'instance cible. Remplacez i-bp1a2b3c4d5e6f par votre ID d'instance.

workbench connect -i i-bp1a2b3c4d5e6f

La région est automatiquement déduite du préfixe de l'ID d'instance, il n'est donc généralement pas nécessaire de la spécifier manuellement à l'aide de -r. Une fois dans le shell interactif, appuyez sur Tab pour afficher le panneau de commandes slash (telles que /upload, /download et /agent), et appuyez sur Ctrl+D pour quitter la session.

Présentation des commandes

Commande

Description

workbench list ecs

Interroge la liste des instances ECS par région, état ou tag.

workbench connect

Ouvre une session PTY interactive pour se connecter à une instance. Prend en charge l'authentification sans mot de passe, par mot de passe et par clé.

workbench exec

Exécute une seule commande sur une instance et renvoie le résultat. Prend en charge la sortie texte et JSON.

workbench upload / workbench download

Télécharge ou envoie des fichiers entre votre ordinateur et une instance en utilisant OSS comme relais.

workbench session

Interroge et ferme manuellement les sessions. Aucune intervention n'est requise pour une utilisation quotidienne.

workbench daemon

Affiche ou arrête le daemon en arrière-plan. Il démarre automatiquement lors du premier appel et s'arrête automatiquement après 60 secondes d'inactivité.

workbench config

Configure les identifiants. Prend en charge cinq modes (AK, StsToken, RamRoleArn, CredentialsCmd et CredentialsURI) et plusieurs profils.

workbench upgrade

Met à jour vers la dernière version ou une version spécifiée.

workbench version

Affiche le numéro de version actuel, le commit et la date de build.

Toutes les commandes précédentes prennent en charge les paramètres globaux --output json, --region et --profile. Pour connaître la liste complète des paramètres, les exemples et la structure de sortie JSON de chaque commande, consultez la rubrique Gestion des instances ECS à l'aide de Workbench CLI.

Références