Gitea-Repo fix
Dieser Commit ist enthalten in:
committet von
Server Deploy
Ursprung
c21be47428
Commit
623bbdf5dd
105
SSH_CLAUDE_ANLEITUNG.txt
Normale Datei
105
SSH_CLAUDE_ANLEITUNG.txt
Normale Datei
@ -0,0 +1,105 @@
|
||||
# Anleitung: Claude über SSH aus TaskMate starten
|
||||
|
||||
## Voraussetzungen
|
||||
- SSH-Client auf dem eigenen Computer
|
||||
- Zugang zu TaskMate
|
||||
|
||||
## Schritt 1: SSH-Schlüsselpaar erstellen
|
||||
|
||||
### Windows (PowerShell/Terminal):
|
||||
```
|
||||
ssh-keygen -t rsa -b 4096 -f %USERPROFILE%\.ssh\taskmate_claude
|
||||
```
|
||||
|
||||
### Mac/Linux:
|
||||
```
|
||||
ssh-keygen -t rsa -b 4096 -f ~/.ssh/taskmate_claude
|
||||
```
|
||||
|
||||
**Wichtig:**
|
||||
- Bei der Frage nach einem Passwort ein sicheres Passwort vergeben und merken
|
||||
- Es werden zwei Dateien erstellt:
|
||||
- `taskmate_claude` (privater Schlüssel - GEHEIM HALTEN!)
|
||||
- `taskmate_claude.pub` (öffentlicher Schlüssel)
|
||||
|
||||
## Schritt 2: Öffentlichen Schlüssel übermitteln
|
||||
|
||||
Den Inhalt der Datei `taskmate_claude.pub` an den Administrator senden:
|
||||
|
||||
### Windows:
|
||||
```
|
||||
type %USERPROFILE%\.ssh\taskmate_claude.pub
|
||||
```
|
||||
|
||||
### Mac/Linux:
|
||||
```
|
||||
cat ~/.ssh/taskmate_claude.pub
|
||||
```
|
||||
|
||||
Der Administrator muss diesen öffentlichen Schlüssel auf dem Server hinterlegen.
|
||||
|
||||
## Schritt 3: SSH-Konfiguration einrichten
|
||||
|
||||
Eine Konfigurationsdatei erstellen für einfacheren Zugriff:
|
||||
|
||||
### Windows:
|
||||
Datei `%USERPROFILE%\.ssh\config` bearbeiten
|
||||
|
||||
### Mac/Linux:
|
||||
Datei `~/.ssh/config` bearbeiten
|
||||
|
||||
Folgenden Inhalt hinzufügen:
|
||||
```
|
||||
Host taskmate-claude
|
||||
HostName [SERVER-IP oder DOMAIN]
|
||||
User [BENUTZERNAME]
|
||||
Port [SSH-PORT, standard 22]
|
||||
IdentityFile ~/.ssh/taskmate_claude
|
||||
```
|
||||
|
||||
**Hinweis:** Die Werte in eckigen Klammern müssen vom Administrator bereitgestellt werden.
|
||||
|
||||
## Schritt 4: Verbindung testen
|
||||
|
||||
```
|
||||
ssh taskmate-claude
|
||||
```
|
||||
|
||||
Bei der ersten Verbindung:
|
||||
1. Die Fingerprint-Warnung mit "yes" bestätigen
|
||||
2. Das beim Erstellen des Schlüssels vergebene Passwort eingeben
|
||||
|
||||
## Schritt 5: Integration in TaskMate
|
||||
|
||||
Nach erfolgreicher SSH-Konfiguration:
|
||||
1. In TaskMate einloggen
|
||||
2. Zur Kachel "TaskMate -> Claude starten" navigieren
|
||||
3. Die Funktion sollte nun verfügbar sein
|
||||
|
||||
## Sicherheitshinweise
|
||||
|
||||
- **Privaten Schlüssel niemals weitergeben!** (Datei ohne .pub Endung)
|
||||
- Das Passwort für den SSH-Schlüssel sicher aufbewahren
|
||||
- Bei Verlust des privaten Schlüssels muss ein neues Schlüsselpaar erstellt werden
|
||||
|
||||
## Fehlerbehebung
|
||||
|
||||
### "Permission denied"
|
||||
- Prüfen ob der richtige Schlüssel verwendet wird
|
||||
- Prüfen ob das Passwort korrekt ist
|
||||
|
||||
### "Connection refused"
|
||||
- Server-IP/Domain und Port prüfen
|
||||
- Firewall-Einstellungen prüfen
|
||||
|
||||
### "Host key verification failed"
|
||||
- Die Datei `~/.ssh/known_hosts` prüfen
|
||||
- Ggf. alten Eintrag für den Server entfernen
|
||||
|
||||
## Benötigte Informationen vom Administrator
|
||||
|
||||
Der Administrator muss folgende Daten bereitstellen:
|
||||
1. Server-IP oder Domain
|
||||
2. SSH-Port (falls nicht Standard 22)
|
||||
3. Benutzername für SSH-Zugang
|
||||
4. Bestätigung dass der öffentliche Schlüssel hinterlegt wurde
|
||||
In neuem Issue referenzieren
Einen Benutzer sperren