sshm: simple SSH launcher
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Lyra 06eae92ceb
All checks were successful
release / release (push) Successful in 1s
ShellCheck / shellcheck (push) Successful in 21s
sshm 2.2.7
CHANGELOG nach Gegenprüfung 2.2.7 berichtigt (Trap-Bereich nur bei kill,
1 s an Rückfragen, _dir_private-Umfang).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-13 23:23:53 +01:00
.forgejo/workflows shellcheck-Workflow zurück auf actions/checkout@v4 2026-10-31 13:32:06 +01:00
tests Teil 17: Hygiene Verbinden bis main 2026-11-13 22:16:45 +01:00
.gitattributes Create .gitattributes 2026-07-09 20:14:31 +02:00
.gitignore Interne Doku aus dem Repo nehmen (bleibt lokal, docs/ ignoriert) 2026-11-12 20:55:58 +01:00
CHANGELOG.md sshm 2.2.7 2026-11-13 23:23:53 +01:00
LICENSE Initial commit 2026-07-09 19:43:52 +02:00
README.md Doku Beraterrunde 14d: CHANGELOG 2.2.5, README, decisions 2026-11-12 18:39:57 +01:00
sshm sshm 2.2.7 2026-11-13 23:23:53 +01:00

sshm — SSH-Verbindungsmanager

Tastaturgesteuertes SSH-Menü für die Kommandozeile: Hosts-Datei statt Alias-Pflege, fzf-Suche, Direktstart per Nummer oder Name, Dateibrowser, Kommandos auf mehreren Hosts, Verbindungslog mit Zeitauswertung und ein Lernmodus, der den passenden Key selbst findet.

Quickstart

Voraussetzungen: bash ≥ 4.2, ssh; fzf ≥ 0.35 empfohlen (Pflicht für den Dateibrowser).

install -D -m 755 sshm ~/.local/bin/sshm   # oder: sudo install -m 755 sshm /usr/local/bin/sshm
sshm --setup                               # ssh_config + ssh-agent, zeigt vorher die Änderungen
# neues Terminal öffnen (Agent aus dem Setup)
sshm -a 'web|admin@10.0.0.10||Nginx'       # Eintrag anlegen — oder sshm -e (Editor)

Die sechs häufigsten Aufrufe:

sshm                              # Menü (fzf), nach der Session zurück ins Menü
sshm web                          # direkt verbinden: Nummer, exakter Name, sonst Teilstring
sshm web uptime                   # Remote-Befehl, Exit-Code des Befehls (auch: sshm web -- uptime)
sshm web -L 8080:localhost:80     # Optionen nach dem Namen gehen wörtlich an ssh
sshm -f web                       # Dateibrowser: holen/hochladen, auch per sudo
sshm --run 'uptime' web db        # Kommando nacheinander auf mehreren Hosts (-s/-S: per sudo)

Beim ersten Connect ohne festen Key liest sshm mit, welchen Key der Server annimmt, und trägt ihn als -o IdentitiesOnly=yes -i … am Eintrag nach. Keys mit eigenem Namen vorab in den Agent laden: sshm -k NAME (ohne Argument: Standard-Keys plus alle per -i genannten).

Alles Weitere steht in der Referenz unten; Bestandsnutzer bis 1.14 lesen zuerst Upgrade von ≤ 1.14.


Upgrade von ≤ 1.14

  • sshm --setup erneut ausführen. Die Blöcke haben Fassung 6 und werden mit Backup ersetzt. Bis dahin weisen sshm -k und eine gescheiterte Anmeldung einmal darauf hin.
  • Keine Key-Liste mehr in ~/.ssh/config. Der Block setzt nur noch AddKeysToAgent (ab Fassung 5 mit Ablaufzeit, siehe Setup im Detail). Keys mit eigenem Namen (nicht id_ed25519 usw.) kommen über sshm -k NAME oder das vom Lernmodus bzw. der Key-Suche nachgetragene -i. Wer mit plain ssh auf die Liste angewiesen war, setzt IdentityFile im eigenen Host-Block.
  • Debian 13 (Distro-ssh-agent.socket): --setup stoppt und entfernt eine vorhandene sshm-agent.service (mit Backup) — darin geladene Keys sind weg, danach neu laden (sshm -k). Die Ablaufzeit übernimmt ein Drop-in am Distro-Agent.
  • OPTS werden nicht mehr per Shell ausgewertet. $(…), Backticks und $VARIABLE (außer $HOME) gehen wörtlich an ssh, ~user, {a,b} und Globs werden nicht expandiert. sshm -l bzw. -e nennt betroffene Einträge.
  • sshm -k ohne Argument lädt nur noch Standard-Keys und per -i genannte, nicht alles aus ~/.ssh.
  • Ohne Terminal kein Passwort-Login (siehe Ohne Terminal).
  • Direktstart (sshm web, --last, -f web) gibt keine Hostliste mehr auf stdout aus; sshm --report 0 ist ungültig (kleinster Zeitraum 1); IPv6 mit Port nur noch als [addr]:port.
  • Konfig aus Version ≤ 1.3.0: mv ~/.config/ssh-menu ~/.config/sshm.

Referenz

Aufrufe

sshm                                       Menü (fzf, ohne fzf nummerierte Liste)
sshm <num|name> [ssh-optionen…] [[--] befehl…]
                                           Eintrag direkt starten, siehe „Durchreichen“
sshm -f | --files [num|name]               Dateibrowser (im Menü: CTRL-F auf einem Eintrag)
sshm --run [-s|-S] [--] 'CMD' [host…]      Kommando nacheinander auf mehreren Hosts
sshm --check [num|name…]                   Erreichbarkeit (nur TCP), ohne Argument alle Einträge
sshm --last                                letzten interaktiven Eintrag aus dem Log erneut verbinden (ohne Fehlversuche)
sshm --find-key <num|name>                 passenden Key aus ~/.ssh suchen und eintragen
sshm --history [N]                         Verbindungslog, letzte N Zeilen (Default 10)
sshm --report [woche|monat|alle|TAGE] [--csv]   Verbindungszeiten je Tag/Host
sshm -l | --list                           Liste ohne Connect, mit Konfig-Warnungen
                                           (am Terminal OPTS gekürzt; voll: sshm -l | cat)
sshm -e | --edit                           Hosts-Datei im Editor
sshm -a | --add 'NAME|ZIEL|OPTS|BESCHR'    Eintrag anhängen (geprüft)
sshm --import                              Host-Aliasse aus ~/.ssh/config übernehmen
sshm --setup [--ttl DAUER] [--history-months N]
                                           ssh_config, ssh-agent, Shell-Blöcke einrichten
sshm -k | --keys [KEY…]                    Keys in den Agent laden bzw. verlängern
sshm --rescan                              nur den ssh_config-Block neu schreiben
sshm --uninstall                           Setup-Blöcke, Drop-in und Unit entfernen
sshm --completion [bash|fish]              Completion-Code ausgeben (Default bash)
sshm --update [-y]                         neue Version holen und einspielen
sshm -V | --version   /   -h | --help

Was mit - beginnt und keine sshm-Option ist, endet vor dem Namen mit „Unbekannte Option“ (rc 1); überzählige Argumente (sshm --setup x) ebenso.

Hosts-Datei

Pfad ~/.config/sshm/hosts (Rechte 600). Fehlt sie, legt sshm bzw. sshm -f am Terminal ein kommentiertes Template an und öffnet den Editor ($EDITOR mit Argumenten, sonst nano, vi); sshm -a legt es an und fügt den Eintrag hinzu, jeder andere Aufruf legt nur das Template an und endet mit rc 1.

Rechte: Was sshm neu anlegt (Ordner unter ~/.config/sshm und ~/.local/state/sshm, Hosts-Datei, settings, History), entsteht privat: Ordner 700, Dateien 600. Vorhandene Rechte ändert sshm nie. sshm --check und sshm --update (nach dem Einspielen) nennen zu offene Rechte an Hosts-Datei, settings, Config- und State-Ordner samt chmod-Vorschlag — für Gruppe oder alle beschreibbar bzw. fremder Besitzer, beim State-Ordner und der History auch lesbar für andere; als root zusätzlich jeden übergeordneten Ordner bis /, der nicht root gehört oder beschreibbar ist (sudo -E, su ohne Login). Die Hosts-Datei verweigert sshm wie ssh eine unsichere ~/.ssh/config (ihre OPTS können Befehle ausführen): Gehören Datei oder Ordner (bei einem Symlink auch Ziel und dessen Ordner) weder dir noch root oder sind sie für andere bzw. eine fremde Gruppe beschreibbar (g+w der privaten Gruppe des Besitzers ist erlaubt, wie bei Debians OpenSSH), endet jeder Aufruf, der sie liest (Menü, -l, -f, --run, --check, --last, Direktstart, -e, -a, --import), mit rc 1 und je Pfad einem Vorschlag (chmod go-w …, sudo chown …); -k lädt dann keine -i-Keys aus ihr, die Shell-Completion bleibt still leer. Als root gilt das auch für jeden Ordner darüber bis / — sudo -E sshm mit der Hosts-Datei eines Users läuft also nicht.

# NAME     | [USER@]HOST[:PORT]        | SSH-OPTIONEN                          | BESCHREIBUNG
Webserver  | admin@192.168.1.10        |                                       | Nginx
Datenbank  | deploy@db.example.com:222 | -o IdentitiesOnly=yes -i ~/.ssh/id_db | PostgreSQL
Sonderfall | user@10.0.0.9             | -i "~/.ssh/mein key"                  |
V6Server   | user@[2001:db8::10]:2222  |                                       |
# Test     | user@test                 |                                       | deaktiviert
  • OPTS-Feld: Kein Shell-Code: sshm wertet nichts aus. Die Optionen gehen aber unverändert an ssh — ProxyCommand, LocalCommand, KnownHostsCommand, -F/Include (dort auch Match exec, schon bei --check, -l und im Menü über ssh -G) führen Befehle aus. Die Hosts-Datei ist so vertrauenswürdig wie ~/.ssh/config. Zerlegt wie die Shell — Leerraum trennt, '…' literal, "…" mit \", \\, \$, \`, \ außerhalb von Quotes escapt. Ersetzt werden nur ~ bzw. ~/… am Wortanfang und $HOME/${HOME}. $VAR, $(…) in Quotes und Backticks gehen wörtlich an ssh (Hinweis bei -l/-e; ProxyCommand=nc $X %p wertet ssh selbst aus). Unquotiert ; & < > ( ), $(, # am Wortanfang und \ am Zeilenende sind Syntaxfehler — der Eintrag startet nicht.
  • Port: Ein Port im Ziel gewinnt gegen -p/-o Port= im OPTS-Feld (Warnung bei Widerspruch). IPv6 mit Port nur als [addr]:port; u@::1:22 ist mehrdeutig, -a lehnt es ab, bestehende Einträge gelten als Adresse ohne Port.
  • ConnectTimeout: 10 s, wenn weder OPTS noch ~/.ssh/config einen setzen.
  • Nummer oder Name: Ein Argument nur aus Ziffern ist immer die Nummer. Genaue Schreibweise vor exaktem Namen ohne Groß-/Kleinschreibung vor Teilstring (gefaltet unter C.UTF-8, sonst en_US.UTF-8 — unabhängig vom Locale des Aufrufs, auch für die Dubletten-Prüfung bei -a und --import); Üml und üml sind so in genau ihrer Schreibweise erreichbar, ÜML ist mehrdeutig. Mehrdeutig → Rückfrage am Terminal (nur eine der gezeigten Nummern bzw. Namen, sonst wie bei leerer Eingabe rc 1), ohne Terminal und in --run Fehler mit Kandidaten, --check prüft alle Treffer. Ein Teilstring-Treffer mit Befehl bzw. -f/-W (oder stdin aus einer Pipe) nennt den Eintrag auf stderr (→ webshop-prod (Teilstring „web“)); --run nimmt Teilstrings nur nach Bestätigung (Liste web → webshop-prod, [j/N]), ohne Terminal bricht es ab.
  • -a lehnt ab: Zeilenumbrüche, mehr als vier Felder, Ziel mit Leerzeichen, ohne Host oder mit führendem -, Port außerhalb 1–65535, Namen nur aus Ziffern oder mit #/- am Anfang, vorhandene Namen, Steuerzeichen, mehrdeutiges IPv6, nicht zerlegbare OPTS und OPTS mit einem Wort, das weder ssh-Option noch deren Argument ist (z. B. 127.0.0.1 oder -p 22 u@h — ssh nähme es als Ziel und verbände mit einem anderen Host) bzw. mit unbekannter Option.
  • Beim Laden werden Zeilen ohne |, ohne Name oder Ziel, mit Steuerzeichen in Name/Ziel oder Ziel mit - übersprungen — -l/-e nennen Zeile und Grund (die Nummern der übrigen Einträge bleiben) und warnen außerdem vor mehr als vier Feldern und vor Namen, die mehrfach bzw. nur in Groß-/Kleinschreibung verschieden vorkommen. Ein BOM wird ignoriert. Ziel ohne Host bzw. User (@h, u@), ungültiger Port und ein OPTS-Wort wie bei -a melden -l/-e; solch ein Eintrag startet nicht (Direktstart, Menü, -f mit rc 1, --run überspringt ihn, --check zeigt „nicht prüfbar“).
  • Schreiben (-a, --import, Lernmodus) läuft atomar und unter flock auf hosts.lock, ohne flock über ein Sperrverzeichnis hosts.lock.d (verwaist nach einem Absturz: der nächste Lauf entfernt es und meldet das); bei Fehlern bleibt die Datei unverändert, Symlinks bleiben Symlinks.

--import übernimmt konkrete Host-Zeilen aus ~/.ssh/config einmalig (ohne Wildcards, Match, Include), ein Eintrag pro Zeile: Name ist der erste Alias, der taugt (nicht nur Ziffern, ohne Leerzeichen oder |), die übrigen stehen in der Beschreibung (Host h141 h141-alt → h141, „auch: h141-alt“). Gibt es einen der Aliasse schon als Namen, wird die ganze Zeile übersprungen. Ziel ist der Alias selbst, damit ProxyJump, IdentityFile usw. aus dem Block wirksam bleiben; das aufgelöste user@host:port steht in der Beschreibung. Alle neuen Einträge in einem Zug oder keiner.

Durchreichen: sshm <name> [ssh-optionen…] [[--] befehl…]

Grammatik wie bei ssh nach dem Ziel; -- ist optional (sshm web uptime = sshm web -- uptime). sshm kennt die Optionsbuchstaben von ssh (OpenSSH 10), um zu entscheiden, wo der Befehl beginnt; unbekannte Buchstaben sind ein Fehler.

  • Optionen gehen ohne Shell-Auswertung an ssh und haben Vorrang vor OPTS und ~/.ssh/config.
  • Nach dem Namen gehört alles ssh: sshm web -f ist ssh's -f, nicht der Dateibrowser.
  • ~^Z in der Sitzung hält sshm samt ssh an wie bei plain ssh; fg setzt die Sitzung fort.
  • Mit Befehl sowie -f/-W: keine Zusammenfassung, keine Notiz; rc ist der des Befehls, History mit Kennzeichnung (siehe Verbindungslog). Befehlswörter verbindet ssh wie bei plain ssh. Ebenso ohne Befehl, wenn stdin kein Terminal ist (echo uptime | sshm web, auch echo 1 | sshm aus dem Plain-Menü): cmd bzw. ohne Terminal batch, --last und --report zählen sie nicht.
  • -f (Tunnel im Hintergrund): ohne Mitschnitt und Transferstatistik, die end-Zeile hat keine Dauer. Nur der Lernmodus (Eintrag ohne -i) schneidet mit — dann hält das Hintergrund-ssh den Deskriptor des Mitschnitts bis zu seinem Ende offen (folgenlos, einer pro Tunnel).
  • -v, -q, -E, -o LogLevel=…: ohne Mitschnitt, also ohne Lernmodus und Transferstatistik.
  • -i, -F, -o, -l, -p, -J: kein Lernmodus (ein so akzeptierter Key gehört nicht fest an den Eintrag).
  • -G, -O, -V, -Q: direkt ssh, ohne History.
  • Nur für <num|name>; --last, -f <name> und --find-key <name> nehmen keine weiteren Argumente.
  • Ändern durchgereichte Optionen das Ziel (-p, -l, -J, -o Port=…), nennt eine gescheiterte Verbindung zusätzlich „tatsächlich: user@host:port“, die fail-Zeile to=….

Verbindungslog und Zusammenfassung

~/.local/state/sshm/history (neu angelegt: Datei 600, Verzeichnis 700; Rotation unter flock bzw. dem Sperrverzeichnis history.lock.d). Je Verbindung eine start- und eine end-Zeile, geschrieben nach Sessionende. Kann sshm nicht schreiben (Rechte, Datenträger voll, Sperre), meldet es das einmal pro Lauf auf stderr und verbindet trotzdem; ist die Datei nicht lesbar, enden --history und --last mit „History nicht lesbar“ und rc 1:

2026-07-10 14:02:11  start  Webserver  admin@192.168.1.10
2026-07-10 14:31:47  end    Webserver  admin@192.168.1.10  duration=29m36s exit=0 sent=48.3KiB received=1.2MiB
2026-07-10 09:14:02  fail   Jumphost   admin@jump.example  reason=unreachable exit=255

Dieselbe Zeile erscheint nach der Session als Zusammenfassung im Terminal. Aus dem Menü gestartet, kehrt sshm danach ins Menü zurück (SSHM_LOOP=0 schaltet das ab).

Was keine Sitzung ist, trägt eine Kennzeichnung: als Wort in der start-Zeile, als mode=… am Ende von end- und fail-Zeilen.

Kennzeichnung Verbindung Klasse
— Sitzung interaktiv
files Dateibrowser interaktiv
cmd Befehl bzw. -W mit Terminal (sshm db psql) interaktiv
batch Befehl bzw. -W ohne Terminal (cron, Skript) maschinell
bg Tunnel mit -f (end-Zeile ohne Dauer) maschinell
run sshm --run maschinell

Zeilen ohne Kennzeichnung aus älteren Versionen zählen als interaktiv. --report und --last werten nur interaktive Zeilen aus. sshm kürzt die Datei je Klasse, in ihrer Reihenfolge: interaktive Zeilen nach Alter — älter als 12 Monate fällt weg (Stichtag zählt noch dazu), einstellbar 3, 6, 12, 24 Monate oder 0 = unbegrenzt über sshm --setup --history-months N (history_months= in ~/.config/sshm/settings, Vorrang hat SSHM_HISTORY_MONTHS) —, maschinelle nach Zahl: ab 1200 bleiben die neuesten 1000. Ein cron-Job pro Minute verdrängt so keine Sitzungen. Eine Zeile ohne gültiges Datum gilt als so alt wie die Zeile davor. Ein abgebrochenes Anhängen (Datenträger voll) setzt sshm mit truncate auf die alte Größe zurück; ohne truncate bleibt der Rest als eigene Zeile, die nächste beginnt immer auf einer neuen.

Kam die Verbindung nie zustande, steht genau eine fail-Zeile da. reason:

reason Bedeutung
unreachable Host nicht erreichbar
auth Anmeldung gescheitert; dazu methods=… (vom Server erlaubt), keys=N (angebotene Keys), key=accepted (Key angenommen, Passphrase falsch bzw. ohne Terminal nicht abfragbar)
hostkey Hostkey-Prüfung gescheitert; sshm nennt den ssh-keygen -R-Befehl
rejected Server verwarf die Verbindung vor der Anmeldung (PerSourcePenalties, fail2ban REJECT)
jumphost Eintrag über ProxyJump/ProxyCommand, Ende vor der Anmeldung am Ziel — Ursache steht in der Meldung des Jumphost-ssh darüber
interrupted Ctrl-C am Passwort-Prompt bzw. vor dem Kommando
sudo, lost nur --run -s/-S, siehe dort
unknown nicht einzuordnen (immer bei SSHM_STATS=0)

Bei auth erklärt ein Hinweis im Terminal den häufigsten Fall (nur Key erlaubt, keiner passt; Key akzeptiert, Passphrase fehlt; Passwort abgeschaltet ohne Terminal; Trennung nach zu vielen Keys wegen MaxAuthTries). Erkannt wird eine stehende Verbindung an Authenticated to … im Debug-Mitschnitt (über einen Multiplex-Master an dessen Session-Zusage, dann ohne sent/received); ohne Mitschnitt bleibt nur rc 255. fail-Zeilen sind in --history rot, im Info-Fenster des Menüs mit ✗, und --report ignoriert sie. Gilt wegen durchgereichter Optionen ein anderes Ziel als im Eintrag, steht es als to=user@host:port dabei (das Ziel-Feld bleibt das des Eintrags). Steuerzeichen in Name/Ziel stehen im Log als ?.

Die Menüzeile zeigt Nummer, Name, Ziel und Beschreibung, die OPTS (auch das vom Lernmodus nachgetragene -i) dahinter; die fzf-Suche (Menü und --run-Auswahl) trifft nur Nummer, Name, Ziel und Beschreibung, nicht die OPTS. Das Info-Fenster rechts im fzf-Menü zeigt Beschreibung, Optionen und die letzten Verbindungen zum Eintrag; bei schmalen Terminals (unter ca. 100 Spalten) ausgeblendet, CTRL-/ schaltet um.

Zeiten auswerten (--report) und Notizen

SSHM_NOTE=1 fragt nach jeder Session eine Notiz ab (note="…" in der end-Zeile; Ctrl-C oder EOF = ohne Notiz; TERM/HUP am Prompt oder Fenster geschlossen: ohne Notiz, die History-Zeilen stehen, rc 143/129). sshm --report summiert je Tag und Host:

$ sshm --report woche
Zeitraum: 2026-07-05 – 2026-07-11

  2026-07-09  Webserver              1×  45m10s
  2026-07-10  Webserver              2×  1h31m07s

Summen:
  Webserver                          3×  2h16m17s
  Gesamt                             3×  2h16m17s

Zeitraum in Kalendertagen einschließlich heute: woche = 7, monat = 30, 1 = heute, alle ohne Grenze (0 ist ungültig). Die Kopfzeile nennt den angefragten Zeitraum (bei alle ab dem ersten Tag mit Daten). Reicht die History nicht so weit zurück, steht darunter „History beginnt erst am JJJJ-MM-TT — ältere Verbindungen fehlen …“ (bei --csv auf stderr). Sessions über Mitternacht werden je Tag aufgeteilt, in den Summen einmal gezählt. --csv liefert datum,host,verbindungen,sekunden. Zeilen mit mehr als 366 Tagen Dauer werden übersprungen (Anzahl auf stderr). Gezählt werden Sitzungen, Dateibrowser und Befehle mit Terminal; die übrigen Verbindungen im Zeitraum nennt die Textausgabe nur als Anzahl („Nicht gezählt: N Befehle ohne Terminal, Tunnel und --run“).

Erreichbarkeit (--check, SSHM_PROBE)

--check prüft alle Einträge per TCP (parallel, bis 16 gleichzeitig, je 2 s), mit Argumenten nur die genannten (sshm --check web 3: Nummern und Namen wie beim Direktstart; ein Teilstring trifft alle passenden Einträge, die sshm als „Teilstring-Treffer“ auf stderr nennt; jeder Eintrag einmal, Kopf „Erreichbarkeits-Check (N von M Einträgen)“). Ziel vorher per ssh -G aufgelöst. Einträge über -J/ProxyJump/ProxyCommand werden übersprungen, ebenso solche mit ungültigem Eintrag (OPTS oder Ziel; „ungültig (starten nicht)“) — beides getrennt gezählt. Übersprungene über Jumphost/Proxy sind kein Fehler, ungültige schon (rc 1). Hostkey und Login prüft das nicht. Werkzeug: timeout + /dev/tcp (IPv6-fähig), sonst nc.

rc Bedeutung
0 alle erreichbar
1 mindestens einer nicht erreichbar oder ungültig (startet nicht)
2 Check nicht möglich (weder timeout noch nc; Name ohne Treffer, Nummer außerhalb)

SSHM_PROBE=1 prüft vor jedem Connect; nicht erreichbar → [j/N], ohne Terminal Abbruch (rc 1).

Kommando auf mehreren Hosts (--run)

sshm --run 'uptime'                            # Hosts per fzf-Mehrfachauswahl (TAB/EINFG)
sshm --run 'systemctl status nginx' web db 3
sshm --run -s 'apt update && apt upgrade -y'   # remote per sudo, ein Passwort
sshm --run -S 'systemctl restart nginx' web db # remote per sudo, Passwort pro Host
  • Sequenziell, Ausgabe je Host mit Überschrift, rc je Host. Bei mehreren Hosts am Ende eine Übersicht, z. B. 3 ok · 1 exit≠0 (web2) · 1 Verbindung verloren (web4) · 1 sudo abgelehnt (db1: Passwort abgelehnt) · 1 übersprungen (db2: kein Passwort) · 1 ohne Verbindung (web3). Gesamt-rc 0 nur, wenn alle erfolgreich. Jeder Lauf steht im Log (run).
  • „Verbindung verloren“: ssh brach während des Kommandos ab (Timeout, Reset, Master weg) — ob das Kommando fertig wurde, ist offen; im Log exit=255 lost=1.
  • Ctrl-C, TERM oder HUP brechen den laufenden Host ab (rc 130/143/129, Hinweis „läuft dort ggf. weiter“) und beenden den Lauf nach seiner Log-Zeile; ein Kommando, das schon fertig war, behält seinen rc.
  • stdout/stderr der Kommandos gehen unverändert ans Terminal — wie bei ssh.
  • Remote läuft bash (sonst sh) ohne Login-Umgebung: kein PATH aus ~/.profile, keine Aliasse, keine fish-Syntax. Das Kommando kommt unverändert an, auch bei dash oder fish als Login-Shell. stdin ist /dev/null.
  • Ohne eigene Werte: ConnectTimeout=10, ServerAliveInterval=15, ServerAliveCountMax=3.
  • Doppelt vergebene Namen sind ein Fehler mit Kandidaten. Teilstrings zeigt sshm vor dem ersten Host als Liste und fragt [j/N] (vor sudo-Prüfung und Passwort); ohne Terminal Abbruch mit rc 1 — dort exakte Namen oder Nummern angeben. Die fzf-Auswahl fragt nicht nach.
  • Ctrl-C beendet den Lauf (rc 130); das Kommando auf der Gegenseite läuft ggf. weiter.

-s (sudo, ein Passwort): Erst verbindet sshm alle gewählten Hosts und prüft sudo -n true, dann kommt ein Prompt, der die Empfänger nennt (sudo-Passwort für 3 Hosts (web1, db1, db2); ab 6 Hosts stehen alle Namen als Block über dem Prompt, sudo-Passwort für diese 38 Hosts). Am Terminal zeigt die Prüfung eine Fortschrittszeile (· 12/40 web12), Fehler als eigene Zeilen, danach eine Zusammenfassung (sudo-Prüfung: 38 verlangen ein Passwort, 2 ohne Passwort (db1, db2)); ohne Terminal eine Zeile pro Host. Hosts mit NOPASSWD bekommen es nie; braucht keiner eins, entfällt der Prompt. Danach verbindet sshm je Host neu (Hosts mit Passwort-Login fragen also zweimal), prüft das Passwort per sudo -k -S true und startet erst dann das Kommando. Abgelehnt → Meldung mit Host; galt es schon auf einem anderen Host, wird nur dieser übersprungen, sonst höchstens eine Neueingabe (leer bzw. erneut abgelehnt: die restlichen Hosts mit Passwort-sudo überspringen) — sonst sammelte ein zentrales Konto einen Fehlversuch pro Host.

-S (sudo, Passwort pro Host): Abfrage für jeden Host, der eins verlangt; der Prompt nennt den Host, leer = Host überspringen, abgelehnt → eine Neueingabe. -s und -S schließen sich aus.

Jeder Empfänger sieht das Passwort im Klartext — wer auf einem der Hosts root ist, kann es mitlesen (sudo-Konfiguration, PAM, eigenes sudo im PATH). Bei vielen Hosts besser NOPASSWD für genau die nötigen Befehle (/etc/sudoers.d/) oder pam_ssh_agent_auth (sudo prüft den weitergeleiteten Agent statt eines Passworts).

Beide: pro Host eine eigene Multiplex-Verbindung, nie mehr als eine gleichzeitig; stirbt sie, scheitert der nächste Schritt (reason=lost) statt einer Ersatzverbindung. Das Passwort steht nie in Argumenten, Umgebung oder Dateien. sudo-Fehlschläge: reason=sudo sudo=wrongpw|denied|tty|nopw|error. Erkennt sudo und sudo-rs. Die Meldung von sudo bei error zeigt sshm mit ? statt Steuerzeichen, ebenso Banner und Warnungen beim Verbindungsaufbau; die Ausgabe der sudo-Prüfung selbst verwirft es (nur der Exit-Code zählt). Die Ausgabe des Kommandos geht dagegen ungefiltert durch, wie bei ssh.

Dateibrowser (-f)

sshm -f web        # Browser für Eintrag "web"
sshm -f            # Menü im Browser-Modus
Taste Aktion
ENTER Verzeichnis öffnen bzw. Auswahl zur Gegenseite kopieren
TAB / EINFG Mehrfachauswahl
CTRL-T Seite wechseln (remote ⇄ lokal), beide frei navigierbar
CTRL-Y Auswahl kopieren, Ordner rekursiv
CTRL-N neuer Ordner auf der aktuellen Seite
CTRL-R sudo-Modus an/aus (⚡sudo im Prompt)
CTRL-/ Kopierziel-Fenster ein/aus
ESC beenden
Ctrl-C laufende Übertragung bzw. Rückfrage abbrechen, zurück in die Liste (übrige markierte Einträge werden genannt, nicht übertragen); in der Liste selbst beendet es wie ESC
  • Das Fenster „Kopierziel“ zeigt das Verzeichnis der Gegenseite samt Inhalt. Maus: Klick wählt, Doppelklick = ENTER.
  • Existiert das Ziel schon (Datei, Ordner oder Symlink), fragt sshm pro Element [j/N]; Nein, Enter, Ctrl-C lassen es unangetastet. Remote wird mit den Rechten des Uploads geprüft. In beide Richtungen ersetzt „j“ einen vorhandenen Ordner (kein Zusammenmischen; die Rückfrage sagt „Der vorhandene Ordner wird samt Inhalt gelöscht, nicht zusammengeführt“). Eine hochgeladene Datei ersetzt das Ziel wie bei tar (neue Datei: Hardlinks behalten den alten Inhalt); ist das Ziel ein echter Ordner, bricht sshm ab („Ziel ist ein Ordner“). Ein Symlink am Zielnamen wird beim Hochladen entfernt und ersetzt, nie verfolgt — auch nicht einer auf einen Ordner; gehört er in einem Sticky-Ordner (/tmp) einem anderen User, bricht sshm ab („am Zielnamen liegt ein Symlink, der sich nicht entfernen lässt … nicht gefolgt“).
  • Übertragung als tar-Stream über eine Multiplex-Verbindung (ein Login, ServerAliveInterval 15 s × 3, falls nicht gesetzt). Geholte Dateien gehören dem lokalen User. Verbindung weg → „Verbindung verloren“, Ende mit rc 255; Ctrl-C bricht eine Übertragung ab, entfernt halbe Dateien und kehrt in die Liste zurück; TERM bzw. HUP beenden den Browser (rc 143/129), auch kurz nach einem Ctrl-C; vor jeder Übertragung steht eine Zeile ⇣ NAME … bzw. ⇡ NAME … (ohne Fortschrittsanzeige). Dateien und Ordner lädt sshm über ein Staging-Verzeichnis neben dem Ziel hoch (.sshm-up.*, remote per mktemp -d): Erst das vollständig empfangene Element ersetzt das Ziel per mv; ein vorhandener Ordner geht dafür erst ins Staging und kommt zurück, wenn das scheitert. Vollständig heißt: eine Endmarke hinter dem Element kam an — ein an einer Dateigrenze abgerissener Strom, den tar ohne Fehler annimmt, ersetzt so nichts. Bei Abbruch, Fehler oder vollem Datenträger entfernt die Gegenseite das Staging-Verzeichnis (nach Ctrl-C, sobald ihr tar das Ende des Stroms sieht), das Ziel bleibt unverändert („nichts übernommen, Ziel unverändert“). Ohne mktemp auf der Gegenseite scheitert der Upload mit Meldung. Nach einem kill -9 oder einem Netzabriss (bis sshd den toten Client bemerkt — ClientAliveInterval, sonst TCP-Keepalive nach Stunden) kann ein .sshm-up.* liegen bleiben — ein versteckter Ordner, kein halbes Ziel (beim Ersetzen eines Ordners darin ggf. der alte unter old); der nächste Upload in denselben Ordner nennt eigene Reste einzeln mit fertigem rm -rf-Befehl (vorher old/ prüfen), fremde nur als Anzahl.
  • Server-Daten gelten als nicht vertrauenswürdig: Namen mit /, ./.. oder Steuerzeichen blendet der Browser aus, lokal ebenso Namen mit Steuerzeichen (beide Seiten: Hinweiszeile mit Anzahl; solche Dateien per scp). Ein geholter Ordner mit solchen Namen darin wird ganz abgelehnt (Meldung mit Anzahl und erstem Namen), nicht teilweise übernommen. Meldungen der Gegenseite (z. B. von tar oder mkdir) erscheinen gesammelt nach dem jeweiligen Schritt, Steuerzeichen darin wie in lokalen Pfaden als ?; die Ausgabe der Prüfkommandos (Anmeldung, sudo) erreicht das Terminal nicht. Geholt wird über ein privates Staging-Verzeichnis (.sshm-dl.* im Zielordner); übernommen wird nur genau das angeforderte Element — ohne Gerätedateien, setuid/setgid und Symlinks, die aus ihm hinauszeigen. Ein Symlink selbst wird nicht geholt.
  • Geteilte Zielordner (/tmp, Gruppenordner): Das Element kommt per mv -T an den Zielnamen — legt ein anderer User dort zwischendurch einen Ordner an, scheitert mv, statt die Datei hineinzuschieben. Kennt mv kein -T (macOS, BSD/OPNsense remote), lehnt sshm Ordner ab, in die Gruppe oder andere schreiben dürfen oder die das Sticky-Bit tragen („Zielordner … ist für andere beschreibbar und mv kennt kein -T“) — dann GNU coreutils installieren oder einen eigenen Ordner wählen.
  • sudo-Modus: Passwort einmal abgefragt, nur im Speicher der Sitzung, per stdin an sudo; timestamp_timeout=0 verhindert Uploads im sudo-Modus.
  • Rechte beim Hochladen (mit und ohne sudo-Modus, symmetrisch zum Holen): aus der Quelle minus umask der Gegenseite, setuid/setgid fallen weg (tar --no-same-permissions); ein ersetzter Ordner trägt danach die Rechte des hochgeladenen.
  • Holen/Bringen, kein Dateimanager: kein Umbenennen/Löschen, keine Dateinamen mit Zeilenumbruch.
  • Log: files=N in der end-Zeile.

Keys

Server erlauben meist sechs Anmeldeversuche (MaxAuthTries), jeder angebotene Key zählt. sshm hält die Zahl klein:

  • Lernmodus: Bei Einträgen ohne -i liest sshm im Debug-Mitschnitt den zuletzt akzeptierten Key und trägt ihn nach erfolgreicher Session als -o IdentitiesOnly=yes -i '…' nach. Nicht bei Passwort-Login, gescheiterter Anmeldung, einem Key, den ~/.ssh/config schon per IdentityFile nennt, oder wenn sich die Datei inzwischen verschoben hat. Agent-Keys ohne Dateinamen werden über den Fingerprint einer Datei in ~/.ssh zugeordnet.
  • Key-Suche: Scheitert die Anmeldung an „Too many authentication failures“ bzw. „Permission denied (publickey…)“, bietet sshm am Terminal an, die privaten Keys aus ~/.ssh (erkannt am PRIVATE KEY-Header) zu testen: jeder Key genau einmal, in möglichst wenigen Verbindungen (IdentitiesOnly, BatchMode, je Versuch höchstens 30 s). Keys aus IdentityFile der Config gehen nicht doppelt raus, ebenso wenig die, die der Server beim Fehlversuch eben schon abgelehnt hat (per Fingerprint bzw. Pfad aus dem Mitschnitt; die Rückfrage nennt ihre Zahl, sind es alle, entfällt sie). --find-key testet alle. Treffer wird eingetragen, dann wird verbunden — mit Befehl, durchgereichten Optionen (-L, -t …) und Exit-Code wie beim ersten Versuch. Nur für Einträge ohne -i, nicht bei SSHM_LEARN=0 oder abgeschaltetem Pubkey-Login. Hat ssh dabei auch ein Passwort versucht, sagt die Rückfrage dazu, dass vermutlich das Passwort falsch war. sshm --find-key <name> startet die Suche ohne vorherigen Fehlversuch (etwa bei Hosts mit Passwort-Fallback, auch bei SSHM_LEARN=0): dieselbe Rückfrage, derselbe Nachtrag, danach keine Verbindung. Jeder abgelehnte Key ist serverseitig ein Fehlversuch, und der Server sieht alle angebotenen Public Keys (die Rückfrage nennt beides).
  • Pfade mit |, %, ${ oder Steuerzeichen trägt sshm nicht ein, sondern meldet sie.
  • Warnung bei Einträgen ohne festen Key, wenn ssh ihnen sechs oder mehr Keys anbietet: Keys im Agent plus vorhandene Standard-Keys (id_ed25519 …), ein Standard-Key im Agent einmal. Weitere Dateien in ~/.ssh zählen nicht, Einträge ohne Key-Login (PubkeyAuthentication=no) auch nicht. Nennen ~/.ssh/config und die System-Config weder IdentityFile noch PubkeyAuthentication noch PreferredAuthentications, entscheidet allein das OPTS-Feld — dann kostet die Prüfung auch bei Tausenden Einträgen kaum Zeit; sonst fragt sshm ssh -G pro Eintrag. Das Menü prüft höchstens einmal am Tag und hört beim ersten Eintrag ohne festen Key auf, sshm -l prüft immer und zählt alle.
  • IdentitiesOnly=yes nie global: Es heißt „nur Keys aus Config/-i“, bricht reine Agent-Keys (Forwarding auf Jumphosts) und hilft nur zusammen mit einem -i pro Host.

sshm -k [KEY…] lädt Keys in den Agent, ohne zu verbinden (eine Passphrase-Abfrage für alle). KEY ist ein Name in ~/.ssh oder ein Pfad. Ohne Argument: id_rsa, id_ecdsa, id_ecdsa_sk, id_ed25519, id_ed25519_sk und alle per -i in der Hosts-Datei genannten; die übrigen gefundenen Keys nennt es nur. Bereits geladene zeigt es mit Restlaufzeit:

  = ~/.ssh/id_ed25519 (bereits geladen, noch 1h12m05s)
  = ~/.ssh/firmenkey (bereits geladen, Restlaufzeit unbekannt)
  Enter = verlängern … 3

Restlaufzeit = gemerkte Ladezeit ($XDG_RUNTIME_DIR/sshm-keys) + TTL aus der Kommandozeile des Agents. „unbekannt“: von jemand anderem geladen (typisch ssh per AddKeysToAgent); „ohne Ablauf“: Agent ohne -t. Enter im Countdown lädt neu und setzt die Ablaufzeit zurück (bei mehreren mit Auswahl); ohne Terminal oder bei unbekannter TTL kein Countdown. Läuft der Agent ohne -t, lädt -k mit ssh-add -t <Ablaufzeit> (nicht an fremden Agents wie gnome-keyring). Ein hängender Agent führt nach 5 s zum Abbruch.

Setup im Detail

sshm --setup fragt am Terminal nach der Ablaufzeit für Keys im Agent, zeigt vorher, was es ändert, und fragt [j/N] (ohne Terminal keine Rückfrage). Jeder User richtet sich selbst ein: --setup, --uninstall und --import brechen mit rc 1 ab, wenn $HOME (bzw. ein gesetztes XDG_CONFIG_HOME) nicht dem ausführenden User gehört — typisch sudo -E sshm --setup oder su ohne -; dann als der User selbst ausführen (sudo -iu NAME sshm --setup). Es schreibt:

  • Ablaufzeit nach ~/.config/sshm/settings (agent_ttl=2h; Format wie ssh-add -t, 0 = unbegrenzt) und backt sie in alle Dateien unten. Vorschlag: SSHM_AGENT_TTL, sonst der gespeicherte Wert, sonst 2h. Ohne gespeicherten Wert übernimmt das Setup einen von Hand geänderten aus Drop-in, Unit oder Blöcken, statt ihn mit der neuen Fassung zu verlieren. Ändern ohne TTL-Frage: sshm --setup --ttl 8h (der Plan wird trotzdem bestätigt), oder die Zeile in der Datei ändern und sshm --setup ausführen.
  • History-Aufbewahrung nur mit --history-months 3|6|12|24|0 (history_months=, ohne Eintrag 12 Monate; wirkt ab dem nächsten Eintrag, kein erneutes Setup nötig). Ein ungültiger Wert (von Hand bzw. in SSHM_HISTORY_MONTHS) löscht nichts nach Alter und wird gemeldet.
  • ~/.ssh/config: Host * mit AddKeysToAgent <Ablaufzeit> (ab OpenSSH 8.9, sonst bzw. bei 0 yes) — keine IdentityFile-Liste. ssh nimmt die Standard-Keys, andere kommen über den Agent oder das -i am Eintrag. Die Zeile gilt für jedes plain ssh: Mit yes landen Keys unbefristet in jedem Agent, an dem ssh gerade hängt — an einem weitergeleiteten (ssh -A) auch auf dem Rechner, von dem aus man sich angemeldet hat. Teilt ein älterer Client (< OpenSSH 8.9) die Datei, dort yes setzen — er bricht an der Zeitangabe. Setzt der Admin AddKeysToAgent in /etc/ssh/ssh_config (bzw. ssh_config.d/*.conf samt Include), schreibt sshm keine Zeile („vom Admin gesetzt … bleibt“), die eigene Config gälte sonst vor seiner. Läuft --setup in einer ssh-Sitzung (SSH_CONNECTION gesetzt, typisch Server/Jumphost), ebenfalls keine Zeile, nur ein Kommentar: Bei Zugang per ssh -A landeten dort entsperrte Keys im Agent der Workstation. Keys dort per sshm -k bzw. ssh-add laden; --setup nennt das im Plan und in der Ausgabe.
  • Rechte: ~/.ssh (700), ~/.ssh/config, .bashrc und config.fish (600) setzt sshm nur, wenn es sie anlegt; vorhandene behalten ihre Rechte. Zu offene Rechte an ~/.ssh bzw. ~/.ssh/config meldet --setup mit chmod-Vorschlag — und eigens, wenn ssh die Config deshalb ablehnt („Bad owner or permissions“: für alle beschreibbar, fremder Besitzer, bei Debian/Ubuntu g+w nur außerhalb der privaten Gruppe).
  • sshm-eigene Verbindungen begrenzen das ohnehin: Steht AddKeysToAgent effektiv auf yes, setzt sshm -o AddKeysToAgent=<Ablaufzeit>; in einer ssh-Sitzung (SSH_CONNECTION) an einem fremden, meist weitergeleiteten Agent no — Keys eines Jumphosts landen nicht im Agent des Desktops. no, ask, confirm und Zeitangaben bleiben, ein Wert vom Admin ebenfalls. Antwortet der Agent nicht (gestoppt), warnt sshm nach 2 s einmal und verbindet ohne Agent, statt zu hängen — auch ohne timeout (dann wartet sshm selbst).
  • Agent, je nach System:
    • Distro-Socket (ssh-agent.socket auf $XDG_RUNTIME_DIR/openssh_agent, Debian 13): keine eigene Unit; Socket bei Bedarf aktivieren, eine alte sshm-agent.service entfernen. Drop-in ~/.config/systemd/user/ssh-agent.service.d/sshm.conf startet den Agent mit -t <Ablaufzeit>. Hält der laufende Agent schon Keys, wird er nicht neu gestartet (greift nach dem nächsten Login). Hat ssh-agent.service schon ein -t, kein Drop-in. Maskierter Socket gilt als abgewählt → eigene Unit.
    • systemd ohne Distro-Socket: ~/.config/systemd/user/sshm-agent.service (ssh-agent -D -t <Ablaufzeit> -a %t/ssh-agent.sock, Restart=always) — endet mit der letzten Session. Nach --setup --ttl greift die neue Zeit mit systemctl --user restart sshm-agent.
    • ohne systemd: der Shell-Block startet den Agent (ssh-agent -t <Ablaufzeit>).
  • Shell-Blöcke in ~/.bashrc und config.fish (unter $XDG_CONFIG_HOME/fish, sonst ~/.config/fish), nur in interaktiven Shells. config.fish nur, wenn fish genutzt wird (Login-Shell oder dieser fish-Ordner vorhanden). Andere Login-Shells (zsh, tcsh, dash …) richtet --setup nicht ein und sagt das. Mit systemd-Agent (Distro-Socket bzw. sshm-agent.service) gibt es eine Zeile für SSH_AUTH_SOCK in der Syntax der Shell aus (export bzw. setenv, lässt ein gesetztes SSH_AUTH_SOCK stehen) — eintragen muss man sie selbst. Ohne systemd reicht eine Zeile nicht (die Shell muss den Agent starten), Vorlage ist dann der Block in ~/.bashrc. SSH_AUTH_SOCK wird nur gesetzt, wenn kein funktionierender Agent erreichbar ist (ssh-add -l rc 0/1 unter timeout 2). Reihenfolge: vorhandenes SSH_AUTH_SOCK (ssh -A, gnome-keyring, KeePassXC …) → Distro-Agent → sshm-Agent ($XDG_RUNTIME_DIR/ssh-agent.sock, ohne XDG_RUNTIME_DIR ~/.ssh/agent.sock, nie /tmp). XDG_RUNTIME_DIR zählt nur als eigener Ordner ohne Symlink — nach su ohne - oder sudo -E zeigt es auf den eines anderen Users, dann gilt ~/.ssh/agent.sock. Gehört ~/.ssh einem anderen User, startet der Block keinen Agent (Meldung). Ein hängender Agent wird gemeldet, ein zweiter nicht daneben gestartet. Verwaiste Agents räumt der Block nur an seinem eigenen Socket-Pfad weg. Dazu die bash-Completion (lädt beim ersten TAB) bzw. fish-Completion.

Blöcke sind mit # >>> sshm setup >>> / # <<< sshm setup <<< markiert und tragen # sshm-setup-version: N. Erneutes --setup lässt aktuelle Blöcke in Ruhe und ersetzt ältere an Ort und Stelle; eigene Änderungen im Block gehen dabei verloren (stehen im Backup). Fehlt zu einer Startmarke die Endmarke (vor der nächsten Startmarke bzw. dem Dateiende), fassen --setup und --uninstall die Datei nicht an — kein Backup, „✗ DATEI: sshm-Block ab Zeile N ohne Endmarke“, rc 1. Unit und Drop-in werden nur bei älterer Fassung neu geschrieben. Weicht die eingebackene Ablaufzeit vom gespeicherten Wert ab, werden auch aktuelle Blöcke, Unit und Drop-in neu geschrieben. Jede Änderung: Backup <datei>.sshm-bak.<zeit> (Drop-in: ssh-agent.service.d.sshm.conf.sshm-bak.<zeit> neben dem .d-Verzeichnis), dann atomar (Tmp-Datei im Zielverzeichnis, mv; Rechte, Owner und Symlinks bleiben). Scheitert ein Schritt, bleibt die Datei unverändert, „✗“ und rc 1. Von den Backups einer Datei behält sshm das älteste (meist der Zustand vor sshm) und die drei neuesten; jedes gelöschte nennt es („↳ altes Backup entfernt: …“). Angefasst werden nur reguläre Dateien namens <datei>.sshm-bak.JJJJMMTT-HHMMSS[.n], nichts sonst daneben. Ebenso bei --uninstall und für die Vorversion bei --update.

  • sshm --rescan schreibt nur den ssh_config-Block neu (Agent und Shell-Blöcke bleiben).
  • sshm --uninstall entfernt Blöcke, Drop-in (mit Backup) und sshm-agent.service, löscht Dateien, die nur aus dem Block bestanden, und das dann leere ssh-agent.service.d/, und listet die liegengebliebenen Backups. Am Terminal zeigt es vorher den Plan (Block ohne Endmarke: „wird nicht angefasst“) und fragt [j/N]; ohne Terminal ohne Rückfrage. Zum Schluss nennt es Hosts-Datei/Einstellungen und History mit einem rm -rf-Vorschlag.

Ohne Terminal

„Ohne Terminal“ heißt: kein /dev/tty (cron, systemd-Unit, setsid, Rollout-Skripte ohne Terminal).

  • Kein Passwort-/keyboard-interactive-Login — ssh schickte sonst leere Passwörter (Fehlversuche, Sperre durch PerSourcePenalties/fail2ban). Gilt auch für den Jumphost eines ProxyJump (per privater -F-Config, nicht wenn schon -F gesetzt ist; ProxyCommand bleibt ungeschützt). Ausnahme: Askpass (SSH_ASKPASS_REQUIRE=force oder DISPLAY mit ausführbarem Askpass). Key-Logins sind nicht betroffen; nach einem Fehlschlag sagt sshm, warum.
  • Key mit Passphrase: nicht abfragbar, Diagnose „ohne Terminal keine Abfrage“, key=accepted.
  • Keine Key-Suche, kein Editor beim ersten Start, keine Rückfragen (mehrdeutiger Name → Fehler, SSHM_PROBE → Abbruch), kein -k-Countdown; --setup ohne Rückfrage.

Umgebungsvariablen

Schalter verstehen 1/yes/true/on und 0/no/false/off; andere Werte meldet sshm beim Start, dann gilt der Default.

Variable Default Wirkung
SSHM_PROBE 0 TCP-Check vor jedem Connect
SSHM_LEARN 1 Lernmodus und Key-Suche
SSHM_STATS 1 Debug-Mitschnitt für Transferstatistik und Diagnose (--run schneidet immer mit; der Lernmodus braucht ihn ebenfalls)
SSHM_LOOP 1 nach der Session zurück ins Menü
SSHM_NOTE 0 Notiz nach Sessionende
SSHM_HISTORY_MONTHS history_months aus ~/.config/sshm/settings, sonst 12 Aufbewahrung der interaktiven History in Monaten (3, 6, 12, 24; 0 = unbegrenzt); ungültig → nichts nach Alter gelöscht, mit Meldung
SSHM_AGENT_TTL agent_ttl aus ~/.config/sshm/settings, sonst 2h Ablaufzeit der Keys im Agent: Vorschlag für --setup, -o AddKeysToAgent bei sshm-Verbindungen, sshm -k an einem Agent ohne -t (Format wie ssh-add -t, 0 = unbegrenzt)
NO_COLOR — keine Farben (in Pipes ohnehin nicht)
EDITOR nano, vi Editor für -e und den ersten Start

Mitschnitte und FIFO liegen privat unter $XDG_RUNTIME_DIR (sonst $TMPDIR, /tmp); fehlt ein Temp-Verzeichnis, läuft der Connect ohne Lernmodus und Statistik weiter; Menü, --run-Auswahl, --run -s und Dateibrowser brechen mit Meldung ab. $TMPDIR zählt nur, wenn es ein absoluter Pfad ohne Symlink ist, uns oder root gehört und Gruppe/andere dort nicht schreiben dürfen (oder mit Sticky-Bit wie /tmp) — sonst still /tmp; --check nennt den Grund. --update lädt in ein eigenes Verzeichnis (700) und liest die geprüfte Datei nur von dort. Relative XDG_*-Werte gelten als ungesetzt, ein relatives HOME bricht ab.

Completion

--setup richtet sie für bash und fish ein (Namen und Flags, aktuell aus der Hosts-Datei; nach -f/--find-key ein Name, nach --check nur Namen, bei --run Namen erst nach dem Kommando). Ohne Setup: eval "$(sshm --completion bash)" in ~/.bashrc bzw. sshm --completion fish | source in config.fish.

Aktualisieren (--update)

sshm --update                                   # zeigt Versionen, fragt vor dem Einspielen
sshm --run '~/.local/bin/sshm --update -y' web db   # mehrere Hosts, ohne Rückfrage

Quelle sind die Versions-Tags (vX.Y.Z) auf git.dynnet.de, nie ein Stand auf main. Die Datei aus dem Tag muss bash -n bestehen und ihre SSHM_VERSION zum Tag passen; eingespielt wird atomar über den aufgelösten Pfad, Rechte bleiben, die Vorversion liegt als sshm.sshm-bak.<zeit> daneben. Ohne Schreibrecht (/usr/local/bin) legt sshm die geprüfte Datei als ~/.cache/sshm/sshm-<version> ab (Ordner 700, Datei 600), zeigt den Befehl echo '<sha256> <datei>' | sha256sum -c && sudo install -m 755 <datei> <ziel> (ohne sha256sum nur sudo install …) und endet mit rc 1; das nächste --update räumt dort eingespielte bzw. überholte Dateien weg. HTTPS mit Zertifikatsprüfung über curl/wget, keine Signatur. Im --run-Beispiel steht der volle Pfad, weil ~/.local/bin dort nicht im PATH ist. Danach sshm --setup, falls sich die Blöcke geändert haben.

Installation im Detail

Paket Pflicht Zweck
bash ≥ 4.2 ✓ wird beim Start geprüft; macOS: brew install bash
ssh ✓ OpenSSH-Client
fzf ≥ 0.35 empfohlen Menü mit Suche, Pflicht für -f; älter gilt als „kein fzf“
timeout oder nc optional --check, SSHM_PROBE
flock optional Sperren für Hosts-Datei und Log (ohne: Sperrverzeichnis per mkdir)
truncate optional setzt die History nach einem gescheiterten Anhängen zurück

~/.local/bin im PATH: fish (CachyOS) hat es; Debian nimmt es für bash per ~/.profile erst auf, wenn der Ordner beim Login existiert — nach install -D neu einloggen. fish auf Debian liest ~/.profile nicht: dort einmalig fish_add_path ~/.local/bin; zsh ebenso wenig (path+=(~/.local/bin) in ~/.zshrc). Das Script braucht LF-Zeilenenden (.gitattributes sichert das ab).

Deinstallieren: sshm --uninstall, dann rm ~/.local/bin/sshm und optional rm -rf ~/.config/sshm ~/.local/state/sshm.


MIT-Lizenz, siehe LICENSE. Lyra, Draven / DravenTec.