CommunityCodierung & Entwicklunggithub.com

steipete/ssh-doctor

SSH-Triage: Remote Login, launchd sshd, Verbindungsabbrüche vor der Authentifizierung, veraltete Sitzungen.

Was ist ssh-doctor?

SSH Doctor ist ein KI-Agenten-Skill für macOS, der bei der Diagnose und Behebung von SSH-Verbindungsproblemen hilft. Er deckt Szenarien ab, bei denen SSH-Verbindungen vor der Authentifizierung getrennt werden, der Remote-Login scheinbar aktiviert, aber nicht nutzbar ist, oder lokale/entfernte Mac-SSH-Diagnosen benötigt werden. Der Skill unterstützt Plattformen wie Claude Code, Cursor und Codex und führt den Benutzer durch strukturierte Schritte: lokale Loopback-Tests, Überprüfung der SSH-Konfiguration, Analyse von launchd- und sshd-Protokollen sowie Firewall-Prüfungen. Ein besonderer Fokus liegt auf der Erkennung und Behebung veralteter sshd-session-Prozesse, die durch launchd-Begrenzungen blockiert werden können. Der Skill enthält Sicherheitsregeln, wie das Vermeiden der Ausgabe von Geheimnissen und Token, und bietet spezifische Befehle zur sicheren Handhabung von OP_SERVICE_ACCOUNT_TOKEN-Profilblöcken. Mit präzisen Kommandozeilenwerkzeugen und klaren Bewertungskriterien ermöglicht SSH Doctor eine effiziente Fehlersuche und Problemlösung in macOS-SSH-Umgebungen.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/ssh-doctor

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

SSH Doctor

Verwenden, wenn SSH verbindet, dann vor der Authentifizierung schließt, Remote-Login scheinbar angekündigt, aber nicht nutzbar ist oder lokale/entfernte Mac-SSH-Diagnose benötigt wird.

Regeln

  • Keine Geheimnisse, Token, vollständige Umgebungsvariablen oder breite grep-Ausgaben von Geheimnissen ausgeben.
  • Zuerst lokal validieren: Loopback-Fehler bedeutet server-seitiges sshd/launchd/Konfiguration; Loopback-Erfolg plus Remote-Fehler bedeutet Netzwerk/Firewall/Filter/Listen-Pfad.
  • Verdächtige Konfigurationszeilen melden, bevor /etc/ssh/sshd_config geändert wird.
  • Nicht-interaktives SSH bevorzugen:
ssh -o RequestTTY=no -o RemoteCommand=none HOST 'hostname; id -un'

Basis

hostname; id -un; sw_vers
ipconfig getifaddr en0
ipconfig getifaddr en1 2>/dev/null || true
ipconfig getifaddr en7 2>/dev/null || true
sudo systemsetup -getremotelogin
sudo systemsetup -setremotelogin on
sudo launchctl print system/com.openssh.sshd 2>&1 | head -80
sudo launchctl kickstart -k system/com.openssh.sshd
sudo lsof -nP -iTCP:22 -sTCP:LISTEN
nc -vz 127.0.0.1 22
ssh -4 -F /dev/null -o RequestTTY=no -o RemoteCommand=none [email protected] 'hostname; id -un'

BatchMode=yes nur verwenden, wenn Passwort-Fallback hängen oder zur Eingabe auffordern würde.

Konfiguration

sudo sshd -T 2>&1 | egrep -i '^(allowusers|denyusers|allowgroups|denygroups|listenaddress|maxstartups|logingracetime|usepam|passwordauthentication|pubkeyauthentication|authenticationmethods)'
sudo egrep -n '^[[:space:]]*(AllowUsers|DenyUsers|AllowGroups|DenyGroups|Match|MaxStartups|LoginGraceTime|ListenAddress|AuthenticationMethods|UsePAM|PasswordAuthentication|PubkeyAuthentication)\b' /etc/ssh/sshd_config /etc/ssh/sshd_config.d/* 2>/dev/null || true

Verdächtig:

  • DenyUsers mit übereinstimmendem Zielbenutzer
  • restriktive AllowUsers / AllowGroups
  • Match-Block, der versehentlich zutrifft
  • winzige MaxStartups
  • winzige LoginGraceTime
  • ListenAddress ohne Zielschnittstelle

Protokolle

sudo log show --last 30m --predicate 'process == "sshd" OR process == "launchd"' --style compact | tail -160

Wichtiges Mac-Symptom:

  • Client: kex_exchange_identification: Connection closed by remote host
  • Server-Protokoll: Could not create new instance of inetd service: 67: Too many processes
  • launchctl print system/com.openssh.sshd: hohe copy count
  • viele sshd-session: USER-Prozesse mit PID 1 als Elternprozess

Dies bedeutet, dass launchd TCP akzeptiert hat, sich aber weigert, weitere sshd-inetd-Kopien zu erstellen.

Behebung veralteter sshd-session

Zuerst überprüfen:

sudo launchctl print system/com.openssh.sshd 2>&1 | egrep 'active count|copy count|state =|last exit code|runs ='
ps -axo pid,ppid,uid,user,state,lstart,etime,comm,args | awk '/sshd-session:/ && !/awk/ {print}'
sudo lsof -nP -c sshd-session -iTCP 2>/dev/null | head -120

Wenn veraltete Sitzungen eindeutig verloren sind und neue SSH blockieren, beenden Sie diese durch ausgewählte Befehlszeilenübereinstimmung:

ps -axo pid=,args= | awk '/sshd-session: / && !/awk/ {print $1}' | xargs sudo kill -TERM
sleep 2
ps -axo pid=,args= | awk '/sshd-session: / && !/awk/ {print}'

Wenn TERM Blocker zurücklässt, Besitzer und aktive Shells vor Verwendung von KILL erneut überprüfen.

Firewall

Nur nachdem Loopback funktioniert, aber Remote fehlschlägt:

sudo /usr/libexec/ApplicationFirewall/socketfilterfw --getglobalstate
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --listapps | grep -i ssh -A2 -B2 || true
sudo pfctl -sr 2>/dev/null | head -80
sudo pfctl -si 2>/dev/null | head -80

Auch Listen-Adresse und Zielschnittstelle überprüfen:

ifconfig | awk '/^[a-z0-9]+:/{iface=$1; sub(":","",iface)} iface ~ /^en[0-9]+$/ && /inet / {print iface, $2}'
sudo lsof -nP -iTCP:22 -sTCP:LISTEN

OP-Profilblock

Wenn aufgefordert, sicherzustellen, dass ~/.profile einen von Codex verwalteten OP_SERVICE_ACCOUNT_TOKEN enthält, der von einem anderen Host kopiert wurde:

  • genaue Variable/Markierungen überprüfen, ohne Wert auszugeben
  • nur die übereinstimmende Zeile/den Block kopieren
  • über eine temporäre Datei mit chmod 600 umleiten
  • niemals den Token ausgeben

Präsenzprüfung:

awk 'BEGIN{b=0;e=0;x=0} /BEGIN Codex-managed OP_SERVICE_ACCOUNT_TOKEN/ {b=1} /END Codex-managed OP_SERVICE_ACCOUNT_TOKEN/ {e=1} /^[[:space:]]*(export[[:space:]]+)?OP_SERVICE_ACCOUNT_TOKEN=/ {x=1} END{print "marker_begin", b; print "marker_end", e; print "exact_var", x}' ~/.profile

Von Remote-Host anhängen:

tmpfile=$(mktemp /tmp/codex-op-token.XXXXXX)
chmod 600 "$tmpfile"
ssh -o RequestTTY=no -o RemoteCommand=none HOST 'awk '\''/^[[:space:]]*(export[[:space:]]+)?OP_SERVICE_ACCOUNT_TOKEN=/ {print; exit}'\'' ~/.profile' > "$tmpfile"
if [ -s "$tmpfile" ]; then
  {
    printf '\n# BEGIN Codex-managed OP_SERVICE_ACCOUNT_TOKEN\n'
    sed -n '1p' "$tmpfile"
    printf '# END Codex-managed OP_SERVICE_ACCOUNT_TOKEN\n'
  } >> ~/.profile
fi
rm -f "$tmpfile"

Abschluss

Berichten:

  • Grundursache
  • genaue geänderte Befehle
  • Validierungsausgabe, nach Bedarf redigiert
  • ob Remote erneut versuchen soll

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Verwandte Skills