Référence de Configuration

Bien que PhanTerm recommande d’effectuer la grande majorité du travail de gestion via l’interface TUI, toutes les données sous-jacentes sont persistées sous forme de texte brut structuré lisible par l’homme. Cela facilite les sauvegardes, le contrôle de version et même l’écriture de scripts d’automatisation externes pour les utilisateurs avancés.

Chemin des Fichiers de Configuration

Toutes les données sont stockées dans le répertoire de configuration privé de l’utilisateur.

Windows : %APPDATA%\phanterm\
Linux/macOS : ~/.config/phanterm/

Liste des Fichiers Principaux

Nom du fichier	Utilisation	Description du format
`config.yaml`	Préférences globales	Contient des paramètres de base tels que la région linguistique, le commutateur de mise à jour et la limite de concurrence.
`connections.yaml`	Liste des hôtes	Votre inventaire de serveurs. Les champs sensibles tels que les mots de passe s’afficheront vides ou comme des références spéciales s’ils dépendent du trousseau de clés du système, sinon ils stockeront le texte chiffré fortement sécurisé par AES.
`known_hosts.yaml`	Bibliothèque d’empreintes de confiance	Enregistre toutes les adresses d’hôtes, les types d’algorithmes et les empreintes SHA-256 que vous avez précédemment vérifiés.
`snippets.yaml`	Bibliothèque d’extraits de commandes	Stocke tous les extraits de commandes personnalisés et leurs métadonnées d’étiquettes.
`master.key`	Clé de secours AES	[Top Secret] Veuillez conserver ce fichier en lieu sûr et ne le soumettez jamais à un dépôt de code public.

Personnaliser `config.yaml`

config.yaml permet de contrôler le comportement global de l’application. Vous pouvez modifier manuellement ce fichier pour personnaliser le comportement de PhanTerm. Si le fichier n’existe pas, PhanTerm générera automatiquement un fichier de configuration avec des valeurs par défaut au prochain démarrage.

Exemple de Configuration

Voici une version typique de démonstration de config.yaml :

# Paramètre de langue de l'interface, prend actuellement en charge 'en' (anglais) et 'zh' (chinois)
locale: "en"

# Canal de mise à jour automatique : 'stable' (version stable) ou 'beta' (version bêta)
update_channel: "stable"

# Vérifier automatiquement les mises à jour au démarrage
check_updates_on_startup: true

# Configuration avancée de l'exécution par lot parallèle Multi-Exec [Pro]
multi_exec:
  # Nombre maximal de connexions simultanées lors de l'initiation de connexions temporaires vers plusieurs serveurs enregistrés (Par défaut : 10, Plage : 1-10)
  temp_connect_concurrency: 10

  # Délai d'attente maximal pour l'exécution d'une commande sur chaque serveur cible, en secondes (Par défaut : 300, soit 5 minutes)
  target_timeout_seconds: 300

Description des Éléments Configurables

locale : Définit la langue d’affichage de l’interface TUI. Si le champ est vide ou correspond à une langue non prise en charge, l’interface reviendra à l’anglais par défaut.
update_channel et check_updates_on_startup : Contrôlent la manière dont l’application reçoit les nouvelles versions.
multi_exec : Cette section est spécifiquement dédiée au contrôle du comportement sous-jacent de la fonctionnalité Multi-Exec. Vous pouvez ajuster temp_connect_concurrency en fonction de l’environnement réseau pour contrôler la charge de l’établissement des connexions parallèles, ou augmenter target_timeout_seconds pour permettre à certains scripts extrêmement longs (tels que l’empaquetage de gros fichiers ou les mises à niveau complètes du système) de se terminer avec succès sans être interrompus de force.