CommunityProgramación y desarrollogithub.com

steipete/ssh-doctor

Diagnóstico de SSH: Inicio de sesión remoto, launchd sshd, cierres previos a la autenticación, sesiones obsoletas.

¿Qué es ssh-doctor?

SSH Doctor es una habilidad especializada para diagnosticar y resolver problemas comunes de conexión SSH en macOS, especialmente cuando la conexión se cierra antes de la autenticación, el inicio de sesión remoto parece estar anunciado pero no funciona, o se necesita un diagnóstico completo del servidor SSH local o remoto. La habilidad está diseñada para plataformas como Claude Code, Cursor y Codex. Sigue un flujo de trabajo estructurado: primero valida la conexión local (localhost) para determinar si el problema está en el servidor sshd/launchd/configuración local, y luego en la red/firewall/filtro en caso de fallo remoto. Proporciona comandos para verificar la configuración del servicio SSH, buscar configuraciones sospechosas (como DenyUsers, AllowUsers restrictivos, MaxStartups o LoginGraceTime bajos), inspeccionar registros de sistema, identificar y eliminar sesiones sshd-session obsoletas que bloquean nuevas conexiones, y verificar el firewall de macOS. Además, incluye una sección para gestionar de forma segura tokens de cuenta de servicio de 1Password (OP_SERVICE_ACCOUNT_TOKEN) sin exponerlos. Finalmente, solicita un informe de cierre con la causa raíz, comandos modificados y validación.

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

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

SSH Doctor

Úsalo cuando SSH se conecta y se cierra antes de la autenticación, el inicio de sesión remoto parece anunciado pero no funciona, o se necesita diagnóstico de SSH en un Mac local o remoto.

Reglas

  • No imprimas secretos, tokens, entorno completo ni resultados amplios de búsqueda con grep.
  • Valida primero localmente: un fallo en bucle de retorno indica problema del servidor sshd/launchd/configuración; un éxito en bucle de retorno más un fallo remoto indica problema de red/firewall/filtro/ruta de escucha.
  • Reporta líneas de configuración sospechosas antes de modificar /etc/ssh/sshd_config.
  • Prefiere SSH no interactivo:
ssh -o RequestTTY=no -o RemoteCommand=none HOST 'hostname; id -un'

Línea base

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'

Usa BatchMode=yes solo cuando el fallo de contraseña pudiera colgar o solicitar entrada.

Configuración

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

Sospechoso:

  • DenyUsers que coincida con el usuario objetivo
  • AllowUsers / AllowGroups restrictivos
  • Bloque Match que se aplica accidentalmente
  • MaxStartups muy pequeño
  • LoginGraceTime muy pequeño
  • ListenAddress que falte la interfaz objetivo

Registros

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

Síntoma importante en Mac:

  • cliente: kex_exchange_identification: Connection closed by remote host
  • registro del servidor: Could not create new instance of inetd service: 67: Too many processes
  • launchctl print system/com.openssh.sshd: recuento de copia alto
  • muchos procesos sshd-session: USER con PID padre 1

Esto significa que launchd aceptó TCP pero se negó a generar más copias de sshd inetd.

Solución para sesiones sshd-session obsoletas

Inspecciona primero:

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

Si las sesiones obsoletas están claramente varadas y bloqueando nuevas conexiones SSH, termínalas según la coincidencia de línea de comandos seleccionada:

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}'

Si TERM deja bloqueadores, verifica nuevamente la propiedad y los shells activos antes de usar KILL.

Cortafuegos

Solo después de que el bucle de retorno funcione pero el remoto falle:

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

También verifica la dirección de escucha y la interfaz objetivo:

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

Bloque de perfil OP

Si se te pide asegurar que ~/.profile tenga un token OP_SERVICE_ACCOUNT_TOKEN gestionado por Codex copiado de otro host:

  • verifica la variable/marcadores exactos sin imprimir el valor
  • copia solo la línea/bloque coincidente
  • redirige a través de un archivo temporal con chmod 600
  • nunca hagas echo del token

Verificación de presencia:

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

Añadir desde el host remoto:

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"

Cierre

Informa:

  • causa raíz
  • comandos exactos que se cambiaron
  • salida de validación, censurada según sea necesario
  • si el remoto debe reintentar

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.

Skills relacionados