-
sshm 2.0.0
Stablereleased this
2026-11-08 14:32:55 +01:00 | 80 commits to main since this releaseBestandsinstallationen: danach
sshm --setuperneut ausführen; was sich für sie ändert,
fasst die README unter „Upgrade von ≤ 1.14" zusammen.Neu
- Remote-Befehl und ssh-Optionen durchreichen:
sshm <name> [ssh-optionen…] [[--] befehl…]— dieselbe Grammatik wie ssh nach dem Ziel,
alsosshm web uptime,sshm web -- ls -l /tmpodersshm web -L 8080:localhost:80.
Optionen gehen wörtlich (ohne Shell-Auswertung) an ssh und haben Vorrang vor OPTS und
~/.ssh/config; unbekannte Optionsbuchstaben lehnt sshm ab, statt zu raten, wo der Befehl
beginnt. Mit Befehl (sowie-f/-W) keine Zusammenfassung und keine Notiz-Abfrage,
Exit-Code ist der des Befehls, History wie sonst.-v,-q,-Eund-o LogLevel=…
schalten den Mitschnitt (und damit Lernmodus und Transferstatistik) für diesen Aufruf ab;
-i,-F,-o,-l,-pund-Jnur den Lernmodus;-G,-O,-Vund-Qlaufen
direkt als ssh ohne History. Nach dem Namen gehört alles ssh:sshm web -fist ssh's
Hintergrund-Option, nicht der Dateibrowser. --setupzeigt am Terminal vorher, was es ändert, und fragt[j/N]; ohne Terminal
(Rollout-Skripte) wie bisher ohne Rückfrage.- Drop-in für den Distro-Agent:
~/.config/systemd/user/ssh-agent.service.d/sshm.conf
startet ihn mit-t(SSHM_AGENT_TTL, Default 2h), damit die Ablaufzeit der früheren
eigenen Unit erhalten bleibt.--uninstallentfernt es wieder.
Geändert
--setupbeschädigt plain ssh und fremde Agents nicht mehr. Die Blöcke haben jetzt
Fassung 4;--setupersetzt ältere an Ort und Stelle (mit Backup), bis dahin weistsshm -k
bzw. eine gescheiterte Anmeldung einmal darauf hin.~/.ssh/config: nur nochAddKeysToAgent yesunterHost *. Die Liste aller Keys als
IdentityFilegalt kumulativ für jeden Host, auch für Host-Blöcke danach und den
ProxyJump; ab sechs Keys endete plainsshin „Too many authentication failures". Keys
mit eigenem Namen kommen über den Agent (sshm -k NAME) oder das vom Lernmodus
nachgetragene-i. Wer sich auf die Liste verlassen hat: Key einmal per Key-Suche bzw.
-kfinden lassen.- Shell-Blöcke (bash und fish gleich):
SSH_AUTH_SOCKwird nur noch gesetzt, wenn kein
funktionierender Agent erreichbar ist. Reihenfolge: vorhandenesSSH_AUTH_SOCK
(weitergeleiteter Agent perssh -A, gnome-keyring, KeePassXC …) → Distro-Agent
$XDG_RUNTIME_DIR/openssh_agent→ sshm-Agent. Bisher bog der Block jede interaktive Shell
auf den sshm-Agent um, nachssh -Ahieß es „The agent has no identities". - Distro-Agent statt eigener Unit: Bringt die Distro
ssh-agent.socketmit (Debian 13),
installiert--setupkeinesshm-agent.servicemehr, aktiviert bei Bedarf den
Distro-Socket und entfernt eine vorhandene eigene Unit (mit Backup; darin geladene Keys
sind danach weg). Bisher liefen zwei Agents mit verschiedenen Keys. Hält ein laufender
Distro-Agent schon Keys, startet--setupihn nicht neu (das Drop-in greift nach dem
nächsten Login). --rescanschreibt nur noch den ssh_config-Block neu — eine Key-Liste gibt es dort nicht
mehr.
sshm -kohne Argument lädt nicht mehr alle Keys aus~/.ssh, sondern die Standard-Keys
(die auchssh-addohne Argument nähme) und die per-iin der Hosts-Datei genannten. Die
übrigen nennt es nur; laden mitsshm -k NAME. Jeder Key im Agent ist bei jedem Server ein
weiterer Anmeldeversuch.- Was im OPTS-Feld nicht mehr ausgewertet wird, meldet
sshm -lbzw.-e:$VARIABLE
(außer$HOME),$(…)und`…`gehen wörtlich an ssh, unquotiert sind$(…)sowie
; & < > ( )und#am Wortanfang ein Syntaxfehler — der Eintrag startet dann nicht.
Ebenfalls nicht mehr expandiert:~user(ssh expandiert das in-iselbst) und{a,b}.
-alehnt nicht zerlegbare OPTS ab. - Ohne Terminal kein Passwort-Login mehr (kein
/dev/tty: cron, systemd-Unit,setsid):
ssh las das Passwort dann aus stdin und schickte leere Passwörter — zwei Fehlversuche pro
Verbindung, die beiPerSourcePenalties(OpenSSH ≥ 9.8) bzw. fail2ban zur Sperre beitragen.
sshm schaltet Passwort- und keyboard-interactive-Login ohne Terminal ab (nicht bei Askpass),
auch für den Jumphost eines ProxyJump, und sagt nach dem Fehlschlag, warum. Key-Logins sind
nicht betroffen. - Namen und Ziele mit Steuerzeichen (Tab, ESC, NUL) lehnen
-aund--importab, beim
Laden werden sie mit Warnung übersprungen. Ein Tab im Namen zerlegte bisher die
History-Zeile, der Eintrag fehlte in--report. - IPv6 mit Port nur noch in Klammern eindeutig:
-alehnt Ziele wieu@::1:22ab (Adresse
::1:22oder[::1]:22?), bestehende Einträge dieser Form melden-l/-eals mehrdeutig.
Sie gelten weiter als Adresse ohne Port. - Direktstart gibt die Hostliste nicht mehr aus (
sshm web,--last,-f web) — stdout
gehört der Session bzw. dem Remote-Befehl. Die Liste des Menüs ohne fzf geht nach stderr,
wenn stdout kein Terminal ist, ebenso die Auswahl bei mehrdeutigen Namen. - Keine Hostkey-Lernmeldungen mehr: „Learned new hostkey" und „Adding new key … to
known_hosts" (UpdateHostKeys, Stufe VERBOSE) blendet sshm aus wie plain ssh. Bei
UpdateHostKeys askbleiben sie als Kontext der Rückfrage sichtbar. sshm --report 0ist ungültig (bisher still dasselbe wiealle). Kleinster Zeitraum ist
1(heute), alles weiterhin peralle.- Schneller bei großen Hosts-Dateien: Bei 3000 Einträgen braucht
-l0,22 s statt 3,2 s,
der Direktstart 0,14 s statt 1,5 s (bash liest Pipes byteweise — die Einträge werden jetzt in
einem Block gelesen),--check22 s statt 65 s (ssh -Gläuft mit dem TCP-Check parallel
statt seriell vorab).
Behoben
Datenverlust und Robustheit:
- Kein Datenverlust mehr bei vollem oder fehlendem Temp-Verzeichnis bzw. Datenträger.
--setup,--rescan,--uninstall,-a,--import, der Lernmodus und die Unit schreiben
jetzt atomar: neuer Inhalt in eine Tmp-Datei im Verzeichnis des Ziels, jeder Schritt geprüft,
dannmv. Bisher machteTMPDIR=/nonexistent sshm --rescanaus~/.ssh/configeine leere
Datei, ein vollesTMPDIRließ--uninstall~/.ssh/configund~/.bashrcals „sonst
leer" löschen, und der Lernmodus schnitt die Hosts-Datei auf vollem Datenträger ab — jeweils
mit „✓" und rc 0. Jetzt bleibt die Datei bei jedem Fehler unverändert, sshm meldet „✗" auf
stderr und endet mit rc 1. Symlinks (stow/chezmoi) bleiben Symlinks, Rechte und (als root)
Owner bleiben erhalten. - Ohne Backup kein Umschreiben: Scheitert die
.sshm-bak.*-Sicherung, bleibt die Datei
unangetastet; ein halbes Backup wird entfernt. -aund--importmelden keinen Erfolg mehr ohne Schreiben (z. B. schreibgeschützte
Hosts-Datei: bisher „Permission denied", dann „Hinzugefügt", rc 0).--importschreibt alle
neuen Einträge in einem Zug oder keinen.- Parallele sshm-Läufe: History-Rotation und Lernmodus-Nachtrag laufen unter
flock(fehlt
flock, ohne Sperre wie bisher). 30 parallele Läufe an der Rotationsschwelle kürzten die
History bisher auf ein Dutzend Zeilen, parallele Connects verloren gelernte Keys. - Unlesbare Hosts-Datei: klare Meldung und rc 1 statt leerer Liste mit rc 0. Ein
schreibgeschütztes Konfig-Verzeichnis meldet nicht mehr „Konfiguration angelegt", ohne etwas
angelegt zu haben. - Voller bzw. fehlender Temp-Ordner beim Connect: eine Meldung statt rund 90× „printf: write
error"; der Connect läuft ohne Lernmodus und Transferstatistik weiter. --uninstalllässt keine führende Leerzeile in~/.ssh/configmehr zurück und listet am
Ende die liegengebliebenen.sshm-bak.*-Backups.- BOM am Anfang der Hosts-Datei landete im ersten Namen; er wird jetzt ignoriert (und beim
nächsten Schreiben durch den Lernmodus entfernt). --historymit NUL-Byte im Log meldete nur „binary file matches"; Steuerzeichen
erscheinen jetzt als?.
Hänger:
- Hängender ssh-agent blockiert nichts mehr: Shell-Start (bash, fish) und
sshm -kfragen
den Agent untertimeoutab (2 bzw. 5 s). Ein per SIGSTOP angehaltener Agent hielt bisher
jede neue Shell und-kfest; jetzt meldet die Shell „antwortet nicht" und startet daneben
keinen zweiten Agent. --runhängt nicht mehr bei Netzverlust: OhneServerAliveIntervalaus OPTS bzw.
~/.ssh/configsetzt sshm jetzt — wie im Dateibrowser —ServerAliveInterval=15/
ServerAliveCountMax=3(mit-sfür den Master). Bisher galt nurConnectTimeout; nach
einem Paketverlust mitten im Kommando lief der Lauf unbegrenzt weiter.--reporthängt nicht mehr an einer kaputten History-Zeile: Eine Dauer wie
duration=99999999999hließ die Tagesschleife praktisch endlos laufen (GB an Speicher).
Zeilen mit mehr als 366 Tagen Dauer werden übersprungen und auf stderr gezählt. Der
Exit-Code von awk geht jetzt durch (bisher rc 0 auch nach Abbruch).
Diagnosen und Keys:
- Falsche Diagnose nach „Too many authentication failures": ssh beendet jede Log-Zeile mit
\r, auch im Mitschnitt per-E. Die vom Server erlaubten Verfahren endeten so auf\r—
der Hinweis behauptete „Login nur per Key möglich (publickey,password)", in der History stand
methods=…^M. Der Mitschnitt wird jetzt ohne\rgeschrieben; betraf auch die Key-Suche
(Key-Pfade aus „Trying private key"). - Key mit Passphrase ohne Terminal (
--run, cron) hieß bisher „keiner der N Keys passt"
bzw. „1 Key(s) abgelehnt", obwohl der Server den Key angenommen hatte. Jetzt: „Server
akzeptiert Key …, der braucht aber eine Passphrase — ohne Terminal keine Abfrage" (mit
Terminal: „Passphrase falsch oder abgebrochen"), in der History zusätzlichkey=accepted. - Fehler am Jumphost galten als Sperre des Ziels: Scheiterte die Anmeldung am Jumphost
(oder erreichte er das Ziel nicht), meldete sshmreason=rejectedmit dem Rat, auf das Ende
einerPerSourcePenalties-Sperre zu warten. Bei Einträgen über ProxyJump/ProxyCommand heißt
das jetztreason=jumphostmit Verweis auf die Meldung des Jumphost-ssh. - Key-Suche bietet jeden Key genau einmal an: Keys, die ohnehin per
IdentityFileaus
~/.ssh/configkommen, gehen nicht zusätzlich per-iraus (ssh hängt Config-Keys immer an,
abschalten lässt sich das per Kommandozeile nicht). Mit der alten Key-Liste im
ssh_config-Block verbrannte schon die normale Verbindung davor sechs Fehlversuche, die
Key-Suche danach noch einmal bis zu allen — beiPerSourcePenalties(Debian 13) und fail2ban
teuer. - Lernmodus und Key-Warnung kennen
IdentityFileaus~/.ssh/config: importierte Aliasse
mit eigenemIdentityFilezählen in der Warnung von-lnicht mehr als „ohne festen Key",
und der Lernmodus trägt keinen Key nach, den die Config schon nennt.
Bedienung:
- Dateibrowser überschreibt nicht mehr ohne Rückfrage: Liegt am Ziel schon eine Datei bzw.
ein Ordner gleichen Namens (lokal beim Holen, remote beim Hochladen — im sudo-Modus mit sudo
geprüft, also auch unter/etc), fragt sshm[j/N]; Nein, Enter oder Ctrl-C lassen das Ziel
unangetastet. Kann die Gegenseite nicht prüfen, wird ebenfalls gefragt. - Ctrl-C am Notiz-Prompt (
SSHM_NOTE=1) verwirft die Session nicht mehr: Bisher beendete
es sshm vor dem Schreiben der History (rc 130, keine Zeile, kein Lernmodus-Nachtrag). Jetzt
heißt Ctrl-C bzw. EOF „ohne Notiz" — SSH-Session, Key-Suche und Dateibrowser gleich.
Sicherheit
- Das OPTS-Feld der Hosts-Datei wird nicht mehr als Shell-Code ausgeführt. Bisher lief
$(…)bzw.`…`im OPTS-Feld pereval— nicht erst beim Connect, sondern schon beim
Einlesen durch--checkund--run, für jeden Eintrag. Unquotierte Globs (-i a*)
expandierten gegen das aktuelle Verzeichnis. Ein eigener Tokenizer zerlegt das Feld jetzt
wie die Shell (Leerraum trennt,'…',"…",\), ersetzt aber nur~,~/…und
$HOME/${HOME}; alles andere geht wörtlich an ssh. Bestehende Einträge — insbesondere die
vom Lernmodus geschriebenen-i '~/.ssh/…'— werden unverändert zerlegt. - Tab-Vervollständigung (bash) führt keine Eintragsnamen mehr aus:
compgen -Wexpandierte
die Namensliste, ein Name wie$(…)lief beim TAB. Gefiltert wird jetzt per Präfixvergleich. - Ziel mit führendem
-(z. B.-oProxyCommand=…) lehnt-aab; in der Hosts-Datei wird
ein solcher Eintrag mit Warnung übersprungen, statt ihn ssh als Option zu übergeben. - Mitschnitte und FIFO liegen in
$XDG_RUNTIME_DIR(sonst$TMPDIRbzw./tmp), die FIFO
mit festem Namen in einem privaten Verzeichnis statt unter einem permktemp -uausgedachten
Namen.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- Remote-Befehl und ssh-Optionen durchreichen: