- Shell 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
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> |
||
| .forgejo/workflows | ||
| tests | ||
| .gitattributes | ||
| .gitignore | ||
| CHANGELOG.md | ||
| LICENSE | ||
| README.md | ||
| sshm | ||
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 --setuperneut ausführen. Die Blöcke haben Fassung 6 und werden mit Backup ersetzt. Bis dahin weisensshm -kund eine gescheiterte Anmeldung einmal darauf hin.- Keine Key-Liste mehr in
~/.ssh/config. Der Block setzt nur nochAddKeysToAgent(ab Fassung 5 mit Ablaufzeit, siehe Setup im Detail). Keys mit eigenem Namen (nichtid_ed25519usw.) kommen übersshm -k NAMEoder das vom Lernmodus bzw. der Key-Suche nachgetragene-i. Wer mit plainsshauf die Liste angewiesen war, setztIdentityFileim eigenenHost-Block. - Debian 13 (Distro-
ssh-agent.socket):--setupstoppt und entfernt eine vorhandenesshm-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 -lbzw.-enennt betroffene Einträge. sshm -kohne Argument lädt nur noch Standard-Keys und per-igenannte, 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 0ist ungültig (kleinster Zeitraum1); 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 auchMatch exec, schon bei--check,-lund im Menü überssh -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 %pwertet 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:22ist mehrdeutig,-alehnt es ab, bestehende Einträge gelten als Adresse ohne Port. - ConnectTimeout: 10 s, wenn weder OPTS noch
~/.ssh/configeinen 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, sonsten_US.UTF-8— unabhängig vom Locale des Aufrufs, auch für die Dubletten-Prüfung bei-aund--import);Ümlundümlsind so in genau ihrer Schreibweise erreichbar,ÜMList mehrdeutig. Mehrdeutig → Rückfrage am Terminal (nur eine der gezeigten Nummern bzw. Namen, sonst wie bei leerer Eingabe rc 1), ohne Terminal und in--runFehler mit Kandidaten,--checkprü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“));--runnimmt Teilstrings nur nach Bestätigung (Listeweb → webshop-prod,[j/N]), ohne Terminal bricht es ab. -alehnt 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.1oder-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/-enennen 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-amelden-l/-e; solch ein Eintrag startet nicht (Direktstart, Menü,-fmit rc 1,--runüberspringt ihn,--checkzeigt „nicht prüfbar“). - Schreiben (
-a,--import, Lernmodus) läuft atomar und unterflockaufhosts.lock, ohneflocküber ein Sperrverzeichnishosts.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 -fist ssh's-f, nicht der Dateibrowser. ~^Zin der Sitzung hält sshm samt ssh an wie bei plain ssh;fgsetzt 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, auchecho 1 | sshmaus dem Plain-Menü):cmdbzw. ohne Terminalbatch,--lastund--reportzä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: direktssh, 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-Zeileto=….
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(sonstsh) ohne Login-Umgebung: keinPATHaus~/.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 beitar(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,ServerAliveInterval15 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 permktemp -d): Erst das vollständig empfangene Element ersetzt das Ziel permv; 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, dentarohne Fehler annimmt, ersetzt so nichts. Bei Abbruch, Fehler oder vollem Datenträger entfernt die Gegenseite das Staging-Verzeichnis (nach Ctrl-C, sobald ihrtardas Ende des Stroms sieht), das Ziel bleibt unverändert („nichts übernommen, Ziel unverändert“). Ohnemktempauf der Gegenseite scheitert der Upload mit Meldung. Nach einemkill -9oder 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 unterold); der nächste Upload in denselben Ordner nennt eigene Reste einzeln mit fertigemrm -rf-Befehl (vorherold/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 perscp). Ein geholter Ordner mit solchen Namen darin wird ganz abgelehnt (Meldung mit Anzahl und erstem Namen), nicht teilweise übernommen. Meldungen der Gegenseite (z. B. vontarodermkdir) 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 permv -Tan den Zielnamen — legt ein anderer User dort zwischendurch einen Ordner an, scheitertmv, statt die Datei hineinzuschieben. Kenntmvkein-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=0verhindert 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=Nin 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
-iliest 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/configschon perIdentityFilenennt, oder wenn sich die Datei inzwischen verschoben hat. Agent-Keys ohne Dateinamen werden über den Fingerprint einer Datei in~/.sshzugeordnet. - 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 amPRIVATE KEY-Header) zu testen: jeder Key genau einmal, in möglichst wenigen Verbindungen (IdentitiesOnly,BatchMode, je Versuch höchstens 30 s). Keys ausIdentityFileder 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-keytestet 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 beiSSHM_LEARN=0oder 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 beiSSHM_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~/.sshzählen nicht, Einträge ohne Key-Login (PubkeyAuthentication=no) auch nicht. Nennen~/.ssh/configund die System-Config wederIdentityFilenochPubkeyAuthenticationnochPreferredAuthentications, entscheidet allein das OPTS-Feld — dann kostet die Prüfung auch bei Tausenden Einträgen kaum Zeit; sonst fragt sshmssh -Gpro Eintrag. Das Menü prüft höchstens einmal am Tag und hört beim ersten Eintrag ohne festen Key auf,sshm -lprüft immer und zählt alle. IdentitiesOnly=yesnie global: Es heißt „nur Keys aus Config/-i“, bricht reine Agent-Keys (Forwarding auf Jumphosts) und hilft nur zusammen mit einem-ipro 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 wiessh-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 undsshm --setupausfü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. inSSHM_HISTORY_MONTHS) löscht nichts nach Alter und wird gemeldet. ~/.ssh/config:Host *mitAddKeysToAgent <Ablaufzeit>(ab OpenSSH 8.9, sonst bzw. bei0yes) — keineIdentityFile-Liste. ssh nimmt die Standard-Keys, andere kommen über den Agent oder das-iam Eintrag. Die Zeile gilt für jedes plainssh: Mityeslanden 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, dortyessetzen — er bricht an der Zeitangabe. Setzt der AdminAddKeysToAgentin/etc/ssh/ssh_config(bzw.ssh_config.d/*.confsamtInclude), schreibt sshm keine Zeile („vom Admin gesetzt … bleibt“), die eigene Config gälte sonst vor seiner. Läuft--setupin einer ssh-Sitzung (SSH_CONNECTIONgesetzt, typisch Server/Jumphost), ebenfalls keine Zeile, nur ein Kommentar: Bei Zugang perssh -Alandeten dort entsperrte Keys im Agent der Workstation. Keys dort persshm -kbzw.ssh-addladen;--setupnennt das im Plan und in der Ausgabe.- Rechte:
~/.ssh(700),~/.ssh/config,.bashrcundconfig.fish(600) setzt sshm nur, wenn es sie anlegt; vorhandene behalten ihre Rechte. Zu offene Rechte an~/.sshbzw.~/.ssh/configmeldet--setupmitchmod-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
AddKeysToAgenteffektiv aufyes, setzt sshm-o AddKeysToAgent=<Ablaufzeit>; in einer ssh-Sitzung (SSH_CONNECTION) an einem fremden, meist weitergeleiteten Agentno— Keys eines Jumphosts landen nicht im Agent des Desktops.no,ask,confirmund 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 ohnetimeout(dann wartet sshm selbst). - Agent, je nach System:
- Distro-Socket (
ssh-agent.socketauf$XDG_RUNTIME_DIR/openssh_agent, Debian 13): keine eigene Unit; Socket bei Bedarf aktivieren, eine altesshm-agent.serviceentfernen. Drop-in~/.config/systemd/user/ssh-agent.service.d/sshm.confstartet den Agent mit-t <Ablaufzeit>. Hält der laufende Agent schon Keys, wird er nicht neu gestartet (greift nach dem nächsten Login). Hatssh-agent.serviceschon 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 --ttlgreift die neue Zeit mitsystemctl --user restart sshm-agent. - ohne systemd: der Shell-Block startet den Agent (
ssh-agent -t <Ablaufzeit>).
- Distro-Socket (
- Shell-Blöcke in
~/.bashrcundconfig.fish(unter$XDG_CONFIG_HOME/fish, sonst~/.config/fish), nur in interaktiven Shells.config.fishnur, wenn fish genutzt wird (Login-Shell oder dieser fish-Ordner vorhanden). Andere Login-Shells (zsh, tcsh, dash …) richtet--setupnicht ein und sagt das. Mit systemd-Agent (Distro-Socket bzw.sshm-agent.service) gibt es eine Zeile fürSSH_AUTH_SOCKin der Syntax der Shell aus (exportbzw.setenv, lässt ein gesetztesSSH_AUTH_SOCKstehen) — 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_SOCKwird nur gesetzt, wenn kein funktionierender Agent erreichbar ist (ssh-add -lrc 0/1 untertimeout 2). Reihenfolge: vorhandenesSSH_AUTH_SOCK(ssh -A, gnome-keyring, KeePassXC …) → Distro-Agent → sshm-Agent ($XDG_RUNTIME_DIR/ssh-agent.sock, ohneXDG_RUNTIME_DIR~/.ssh/agent.sock, nie/tmp).XDG_RUNTIME_DIRzählt nur als eigener Ordner ohne Symlink — nachsuohne-odersudo -Ezeigt es auf den eines anderen Users, dann gilt~/.ssh/agent.sock. Gehört~/.ssheinem 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 --rescanschreibt nur den ssh_config-Block neu (Agent und Shell-Blöcke bleiben).sshm --uninstallentfernt Blöcke, Drop-in (mit Backup) undsshm-agent.service, löscht Dateien, die nur aus dem Block bestanden, und das dann leeressh-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 einemrm -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-Fgesetzt ist; ProxyCommand bleibt ungeschützt). Ausnahme: Askpass (SSH_ASKPASS_REQUIRE=forceoderDISPLAYmit 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;--setupohne 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.