Was macht remote-ssh?
Codex-kompatible Agenten-Fähigkeit für konservative SSH-basierte Entwicklungs- und Test-Workflows.
Übersicht
Diese Fähigkeit ermöglicht KI-Agenten, SSH-Verbindungen zu entfernten Servern herzustellen und darauf Befehle auszuführen. Sie ist so konzipiert, dass sie konservativ und zuverlässig ist, um unerwartete Fehler zu vermeiden.
Verwendung
Voraussetzungen
- SSH-Schlüssel oder Passwort-Authentifizierung
- Konfigurierte Umgebungsvariablen für Host, Benutzer und optional Port
Umgebungsvariablen
| Variable | Beschreibung | Erforderlich |
|---|---|---|
SSH_HOST | Hostname oder IP-Adresse | Ja |
SSH_USER | Benutzername | Ja |
SSH_PORT | Port (Standard: 22) | Nein |
SSH_KEY_PATH | Pfad zum privaten SSH-Schlüssel | Nein |
Beispielbefehle
# Einfacher Befehl auf Remote-Server
ssh $SSH_USER@$SSH_HOST 'ls -la'
# Ausführen eines Skripts
ssh $SSH_USER@$SSH_HOST 'bash -s' < ./script.sh
Sicherheitshinweise
- Verwenden Sie nach Möglichkeit SSH-Schlüssel anstelle von Passwörtern.
- Beschränken Sie die Befehle, die der Agent ausführen darf, durch spezifische Skripte.
- Überprüfen Sie die SSH-Konfiguration auf unnötige Berechtigungen.
Fehlerbehandlung
Im Falle eines Verbindungsfehlers gibt der Skill eine klare Fehlermeldung zurück. Stellen Sie sicher, dass der SSH-Dienst auf dem entfernten Server läuft und die Firewall-Regeln korrekt sind.