tomekness/agent-ssh-access

Was macht agent-ssh-access?

Sicherer, protokollierter SSH-Zugriff auf entfernte Linux-Server und Raspberry Pis für KI-Agenten – kompatibel mit Claude Code, OpenCode und jedem Agenten, der Skills oder benutzerdefinierte Anweisungen unterstützt.

Übersicht

Diese Skill ermöglicht KI-Agenten, SSH-Verbindungen zu entfernten Servern herzustellen und dort Befehle auszuführen, während alle Aktionen protokolliert werden. Sie ist ideal für Entwickler, die ihre KI-Assistenten in die Lage versetzen möchten, Aufgaben wie Deployment, Systemwartung oder Fehlerbehebung auf entfernten Maschinen durchzuführen.

Voraussetzungen

• Ein Linux-Server oder Raspberry Pi mit SSH-Server (z. B. OpenSSH)
• Ein Benutzerkonto auf dem entfernten System (idealerweise ein dedizierter agent-Benutzer)
• SSH-Schlüsselpaar für die Authentifizierung
• sudo-Berechtigungen für den Agenten-Benutzer (optional, für privilegierte Befehle)

Installation

1. SSH-Schlüssel generieren (falls nicht vorhanden):

   ssh-keygen -t ed25519 -C "agent-key" -f ~/.ssh/agent_key
   

2. Öffentlichen Schlüssel auf dem entfernten Server installieren:

   ssh-copy-id -i ~/.ssh/agent_key.pub benutzer@entfernter-server
   

3. SSH-Konfiguration auf dem Client einrichten (~/.ssh/config):

   Host entfernt-server
       HostName example.com
       User agent
       IdentityFile ~/.ssh/agent_key
       StrictHostKeyChecking no
       UserKnownHostsFile /dev/null
   

   Hinweis: Deaktivieren Sie StrictHostKeyChecking nur in kontrollierten Umgebungen.

4. Agenten-Benutzer auf dem Server vorbereiten (optional):

   sudo useradd -m agent
   sudo usermod -aG sudo agent
   echo 'agent ALL=(ALL) NOPASSWD: /usr/bin/apt, /usr/bin/systemctl, /usr/bin/docker' | sudo tee /etc/sudoers.d/agent
   

Verwendung

Mit Claude Code

Fügen Sie die folgende Konfiguration zu Ihrem Projekt hinzu:

{
  "skills": [
    {
      "name": "agent-ssh-access",
      "source": "tomekness/agent-ssh-access"
    }
  ]
}

Mit OpenCode

Platzieren Sie die folgende Anweisung in Ihrer opencode.md-Datei:

Für SSH-Zugriff auf entfernte Server verwenden Sie die SSH-Konfiguration aus `~/.ssh/config`.

Mit anderen Agenten

Fügen Sie die Anweisungen in die benutzerdefinierten Anweisungen oder die Skill-Konfiguration Ihres Agenten ein.

Protokollierung

Alle über diese Skill ausgeführten SSH-Befehle werden protokolliert. Aktivieren Sie die Protokollierung auf dem Server:

# In /etc/ssh/sshd_config
LogLevel VERBOSE
Subsystem sftp /usr/lib/openssh/sftp-server -l INFO

Sicherheitshinweise

• Verwenden Sie immer SSH-Schlüssel, keine Passwörter.
• Beschränken Sie sudo-Berechtigungen auf das Nötigste.
• Überwachen Sie die Protokolle regelmäßig auf ungewöhnliche Aktivitäten.
• Ändern Sie den Standard-SSH-Port, wenn möglich.

Lizenz

MIT