К основному содержанию
скилл CX Codex

ssh-doctor — скилл для Claude Code: что делает и как установить

Скилл ssh-doctor диагностирует сбои SSH на macOS: обрывы до авторизации, зависшие сессии sshd и проблемы службы Remote Login.

MIT 239 установок ★ 7 554 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add steipete/agent-scripts --skill ssh-doctor -a claude-code
Открыть на GitHub

Что делает ssh-doctor

Скилл проверяет серверную часть SSH на macOS по чёткому алгоритму. Сначала агент тестирует loopback-соединение через 127.0.0.1 на 22 порту, чтобы отделить сбои демона от сетевых фильтров. Если локальный вход работает, проверяются правила файрвола через socketfilterfw и pfctl, а также привязка сетевых интерфейсов.

При ошибках до авторизации скилл ищет зависшие процессы sshd-session, привязавшиеся к PID 1. При высоком значении copy count в launchd сервис перестаёт порождать новые копии inetd с ошибкой Too many processes. Скилл находит такие сессии через ps и lsof, после чего аккуратно завершает их сигналами TERM или KILL.

Для работы на целевой машине потребуются права sudo: проверки запускают launchctl, systemsetup и чтение системного журнала. Скилл также следит за секретами и не выводит токены или переменные окружения в консоль.

Какие задачи решает

  • устранить сброс SSH-соединения до авторизации на macOS
  • найти и завершить зависшие процессы sshd-session
  • проверить статус Remote Login и перезапустить службу com.openssh.sshd
  • выявить блокирующие директивы AllowUsers и MaxStartups в sshd_config

Примеры запросов агенту

  • Запусти диагностику SSH на этом Маке, подключение сбрасывается до ввода пароля.
  • Проверь зависшие сессии sshd и состояние службы Remote Login.
  • Посмотри ошибки com.openssh.sshd в системном логе и перезапусти сервис.

Как установить ssh-doctor

1Через Skills CLI (Vercel)

npx skills add steipete/agent-scripts --skill ssh-doctor -a claude-code

2Вручную: положить файлы

~/.claude/skills/ssh-doctor/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ssh-doctor/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о ssh-doctor

Как установить ssh-doctor в Claude Code?

Выполните команду npx skills add steipete/agent-scripts --skill ssh-doctor -a claude-code. Либо сохраните файл по пути ~/.claude/skills/ssh-doctor/SKILL.md.

Что делает скилл ssh-doctor?

Он выполняет пошаговую диагностику SSH-сервера на macOS. Скилл проверяет loopback, инспектирует настройки sshd_config, отслеживает ошибки launchd и находит зависшие процессы сессий.

Как скилл устраняет ошибку inetd Too many processes?

Скилл инспектирует launchctl print system/com.openssh.sshd и выявляет брошенные процессы sshd-session. Затем он завершает их сигналом TERM, освобождая лимит процессов для новых подключений.

Исходный текст

SKILL.md · MIT
---
name: ssh-doctor
description: "SSH triage: Remote Login, launchd sshd, pre-auth closes, stale sessions."
---

# SSH Doctor

Use when SSH connects then closes before auth, Remote Login seems advertised but unusable, or local/remote Mac SSH needs diagnosis.

## Rules

- Do not print secrets, tokens, full env, or broad secret grep output.
- Validate locally first: loopback failure means server-side sshd/launchd/config; loopback success plus remote failure means network/firewall/filter/listen path.
- Report suspicious config lines before changing `/etc/ssh/sshd_config`.
- Prefer non-interactive SSH:

```bash
ssh -o RequestTTY=no -o RemoteCommand=none HOST 'hostname; id -un'
```

## Baseline

```bash
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'
```

Use `BatchMode=yes` only when password fallback would hang or prompt.

## Config

```bash
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
```

Suspicious:

- `DenyUsers` matching target user
- restrictive `AllowUsers` / `AllowGroups`
- `Match` block accidentally applying
- tiny `MaxStartups`
- tiny `LoginGraceTime`
- `ListenAddress` missing target interface

## Logs

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

Important Mac symptom:

- client: `kex_exchange_identification: Connection closed by remote host`
- server log: `Could not create new instance of inetd service: 67: Too many processes`
- `launchctl print system/com.openssh.sshd`: high `copy count`
- many `sshd-session: USER` processes parented by PID 1

This means launchd accepted TCP but refused to spawn more sshd inetd copies.

## Stale sshd-session Fix

Inspect first:

```bash
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
```

If stale sessions are clearly stranded and blocking new SSH, terminate by selected command-line match:

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

If `TERM` leaves blockers, re-check ownership and active shells before using `KILL`.

## Firewall

Only after loopback works but remote fails:

```bash
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
```

Also check listen address and target interface:

```bash
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 Profile Block

If asked to ensure `~/.profile` has a Codex-managed `OP_SERVICE_ACCOUNT_TOKEN` copied from another host:

- verify exact variable/markers without printing value
- copy only the matching line/block
- redirect through a `chmod 600` temp file
- never echo the token

Presence check:

```bash
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
```

Append from remote host:

```bash
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"
```

## Closeout

Report:

- root cause
- exact commands changed
- validation output, redacted as needed
- whether remote should retry

© steipete · MIT · steipete/agent-scripts

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
ssh Dicklesworthstone Помогает агенту подключаться к серверам по SSH, пробрасывать порты, синхронизировать файлы через rsync и управлять ключами. Пригодится при деплое и удалённой отладке. CX Codex +1 705установок ssh-configuration devops-skills Скилл ssh-configuration настраивает OpenSSH на клиенте и сервере, помогает выпускать ключи Ed25519, пробрасывать порты и поднимать бастион-хосты для безопасного удалённого доступа. CX Codex +1 527установок ssh-remote oakoss Скилл ssh-remote помогает ассистенту настраивать SSH-подключения, генерировать ключи Ed25519, пробрасывать порты и безопасно передавать файлы. CX Codex +1 183установок ssh-access-forensics Problem99-io Скилл ssh-access-forensics для Claude Code расследует подозрительные SSH-сессии, новые публичные ключи и правки sshd. Помогает разобрать инцидент сразу после взлома или аномального входа. CX Codex +1 ★ 71звёзд репо SSH — policy-gated remote access tufantunc SSH — policy-gated remote access — MCP-сервер для Claude Code: даёт агенту SSH к удалённым хостам, классифицирует вызовы, проверяет роль и записывает решения в журнал. CX Codex +1 ★ 896звёзд репо mcp-ssh-manager bvisible MCP-сервер mcp-ssh-manager даёт агенту доступ к SSH-подключениям, командам, файлам и базам данных. Режимы доступа задаются отдельно для каждого сервера. CX Codex +1 ★ 546звёзд репо

Из того же набора20

Весь набор →
browser-use Скилл browser-use для Claude Code и Codex — управляет реальным профилем Chrome пользователя с сохранёнными логинами и расширениями. Запускается через плагин Codex, расширение OpenClaw или прямое подключение DevTools. CX Codex +1 278установок github-deep-review Скилл github-deep-review для глубокого разбора GitHub-проблем и PR. Читает код, ищет корень бага, предлагает лучший фикс и называет, что именно нужно проверить перед слиянием. CX Codex +1 275установок native-app-performance Скилл native-app-performance для анализа производительности нативных приложений через xctrace и Time Profiler. Записывает трассы, извлекает горячие места стека и показывает узкие места без открытия Instruments. CX Codex +1 251установок instruments-profiling Скилл instruments-profiling для Claude Code профилирует macOS- и iOS-приложения через Instruments и xctrace, записывает трассы и выгружает стеки. Помогает искать медленные участки. CX Codex +1 242установок domain-dns-ops Скилл domain-dns-ops для Claude Code ведёт операции с доменами, зонами Cloudflare и редиректами. Настраивает новые домены и проверяет DNS и HTTPS. CX Codex +1 192установок discord-clawd Скилл discord-clawd для отправки вопросов Discord-бэкированному агенту через OpenClaw реле. Не для поиска в архивах — используйте для прямого общения с сессией. CX Codex +1 122установок openclaw-relay Скилл openclaw-relay для Claude Code, Codex, Cursor и других агентных сред — пересылает промпты и сообщения в сессии OpenClaw через локальный acpx или SSH-транспорт. Работает с именованными алиасами сессий из config/session_aliases.json. CX Codex +1 120установок mac-maintenance Скилл mac-maintenance запускает рутинную очистку macOS: обновляет Homebrew, подтягивает чистые git-репозитории и очищает корзину Finder. CX Codex +1 117установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой