Konfigurationsreferenz

Obwohl PhanTerm empfiehlt, die meisten Verwaltungsaufgaben über die TUI-Oberfläche zu erledigen, werden alle zugrunde liegenden Daten in einer für Menschen lesbaren, strukturierten Textform gespeichert. Dies erleichtert Power-Usern die Durchführung von Backups, Versionskontrolle und sogar das Schreiben externer Automatisierungsskripte.

Pfade der Konfigurationsdateien

Alle Daten werden im privaten Konfigurationsverzeichnis des Benutzers gespeichert.

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

Liste der Kerndateien

Dateiname	Zweck	Formatbeschreibung
config.yaml	Globale Einstellungen	Enthält Grundeinstellungen wie Sprache, Update-Schalter und Parallelitätsbeschränkungen.
connections.yaml	Host-Liste	Ihre Serverliste. Wenn sensible Felder wie Passwörter vom Systemschlüsselbund abhängen, werden sie leer oder als spezielle Referenz angezeigt; andernfalls wird der stark verschlüsselte AES-Geheimtext gespeichert.
known_hosts.yaml	Vertrauenswürdige Fingerabdrücke	Speichert alle zuvor verifizierten Host-Adressen, Algorithmus-Typen und SHA-256-Fingerabdrücke.
snippets.yaml	Snippet-Bibliothek	Speichert alle benutzerdefinierten Befehls-Snippets und Tag-Metadaten.
master.key	AES-Fallback-Schlüssel	[Streng geheim] Bitte bewahren Sie diese Datei sicher auf und übermitteln Sie sie niemals an ein öffentliches Code-Repository.

Tipp

Alle YAML-Konfigurationsdateien sind so konzipiert, dass sie “unbekannte Felder tolerieren”. Dies bedeutet, dass Sie alte, ungenutzte Felder aus früheren Versionen sicher in Ihren Konfigurationsdateien belassen können. PhanTerm wird diese beim Parsen elegant überspringen, ohne dass es zu Programmabstürzen kommt.

Anpassen der config.yaml

Die config.yaml ermöglicht die Steuerung des globalen Verhaltens der Anwendung. Sie können diese Datei manuell bearbeiten, um das Verhalten von PhanTerm anzupassen. Wenn die Datei nicht existiert, generiert PhanTerm beim nächsten Start automatisch eine Konfigurationsdatei mit Standardwerten.

Beispielkonfiguration

Das Folgende ist eine typische Beispielkonfiguration für config.yaml:

# Einstellung der Sprache der Benutzeroberfläche, derzeit werden 'en' (Englisch) und 'zh' (Chinesisch) unterstützt.
locale: "en"

# Automatischer Update-Kanal: 'stable' (Stabile Version) oder 'beta' (Testversion)
update_channel: "stable"

# Ob beim Start automatisch nach Updates gesucht werden soll
check_updates_on_startup: true

# Erweiterte Konfiguration für Multi-Exec parallele Stapelausführung [Pro]
multi_exec:
  # Maximale Parallelität beim Initiieren von temporären Verbindungen zu mehreren gespeicherten Servern (Standard: 10, Bereich: 1-10)
  temp_connect_concurrency: 10

  # Maximales Timeout für die Befehlsausführung auf jedem Zielserver in Sekunden (Standard: 300, d. h. 5 Minuten)
  target_timeout_seconds: 300

Beschreibung der konfigurierbaren Elemente

• locale: Definiert die Anzeigesprache der TUI-Oberfläche. Wenn leer oder nicht unterstützt, wird auf die englische Standardoberfläche zurückgegriffen.
• update_channel und check_updates_on_startup: Steuern, wie die Anwendung neue Versions-Pushs erhält.
• multi_exec: Dieser Abschnitt ist speziell für die Steuerung des zugrunde liegenden Verhaltens der Multi-Exec-Funktion vorgesehen. Sie können temp_connect_concurrency anpassen, um die Belastung durch parallele Verbindungen basierend auf der Netzwerkumgebung zu steuern. Alternativ können Sie target_timeout_seconds erhöhen, um sicherzustellen, dass zeitintensive Skripte (wie das Packen großer Dateien oder vollständige System-Upgrades) erfolgreich abgeschlossen und nicht gewaltsam abgebrochen werden.