• v1.13.0 ce3726a870

    sshm 1.13.0
    All checks were successful
    release / release (push) Successful in 2s
    ShellCheck / shellcheck (push) Successful in 14s
    Stable

    Lyra released this 2026-11-07 00:13:19 +01:00 | 90 commits to main since this release

    Behoben

    • --run -s: Das sudo-Passwort landete im stdin des Kommandos, wenn der
      NOPASSWD-Vorabcheck aus anderen Gründen scheiterte (z. B. Eintrag mit
      Passwort-Login, an dem BatchMode scheitert). Das Kommando startet jetzt
      remote immer mit stdin auf /dev/null; eine Passwortzeile, die sudo nicht
      liest, bleibt ungelesen. Der Vorabcheck läuft über dieselbe
      Multiplex-Verbindung wie das Kommando, ohne BatchMode-Sonderweg.

    • --run -s: Ein falsches Passwort ging an jeden Host, also ein
      Fehlversuch pro Host auf dasselbe (LDAP-)Konto. Es wird jetzt am ersten
      Host, der eines verlangt, per sudo -k -S true geprüft; bei Fehlschlag
      fragt sshm neu (leer bzw. nach drei Versuchen: Hosts mit Passwort-sudo
      überspringen).

    • --run -s mit leerer Eingabe schickte trotzdem eine leere Zeile an
      sudo -S (ein Fehlversuch im journal). Hosts, die ein Passwort brauchen,
      werden jetzt ohne sudo-Versuch übersprungen und als übersprungen gemeldet.

    • --run -s lief unter sh -c (dash), [[ … ]] ging dort nicht.
      Das Kommando läuft jetzt in bash, falls vorhanden, sonst in sh (siehe
      „Geändert" für --run ohne -s).

    • Ctrl-C in --run hinterließ für den abgebrochenen Host keine
      History-Zeile. Jetzt end … exit=130 (bzw. fail reason=interrupted
      vor dem Kommando), danach endet der Lauf mit 130. Das Remote-Kommando
      läuft ohne Terminal weiter, ein sauberer Abbruch ist mit ssh nicht möglich.

    • sudo-Fehlschläge in --run -s (falsches Passwort, kein sudo-Recht,
      requiretty) standen als end exit=1 in der History, nicht
      unterscheidbar von einem Fehler des Kommandos. Jetzt fail reason=sudo sudo=wrongpw|denied|tty|nopw|error.

    • --run ohne ConnectTimeout: Ein unerreichbarer Host kostete über
      zwei Minuten. Ohne eigenen Wert in OPTS bzw. ~/.ssh/config gelten jetzt
      10 Sekunden.

    • Doppelte Namen: --run nahm kommentarlos den ersten Eintrag und
      bricht jetzt mit den Nummern der Kandidaten ab. --last wählt über das
      protokollierte Ziel und rät nicht, wenn auch das nicht eindeutig ist.

    • Unbekannte Optionen (-x, --histroy, --, -f --setup) gingen in
      die Namenssuche, sshm -x verband so zu db-x1. Jetzt „Unbekannte
      Option" mit Hinweis auf -h und Exit-Code 1 (wie die übrigen
      Usage-Fehler).

    • Ohne Hosts-Datei öffneten -l, --check, --run, --last und
      sshm <name> den Editor, ohne Terminal endete --check danach mit rc 0,
      ohne etwas geprüft zu haben. Der Editor öffnet sich nur noch für das
      Menü an einem Terminal, alle anderen Aufrufe legen das Template an und
      enden mit rc 1.

    • sshm vm22 meldete bei vm22 und vm2222 „Mehrere Treffer". Ein
      exakter Name gewinnt jetzt vor Teilstring-Treffern, wie schon in --run.
      Mehrdeutiges ohne Terminal ist ein Fehler (rc 1) statt eines stillen rc 0.

    • sshm -a legte bei einem Zeilenumbruch zwei Einträge an und prüfte
      weder Feldzahl noch Port (u@h:notaport), doppelte Namen oder
      überzählige Argumente. Alles davon wird jetzt abgelehnt.

    • --import zerlegte Host "quoted name" in zwei Einträge und
      ignorierte Host=foo bzw. HostName=x. Der Parser liest jetzt wie ssh
      (Quotes, =), Aliasse mit Leerzeichen überspringt er mit Hinweis, weil
      ssh sie als Ziel ablehnt. Ohne Hosts-Datei legt --import das
      vollständige Template an statt nur einer Kopfzeile.

    • --setup überschrieb sshm-agent.service ohne Backup, obwohl die
      Blöcke empfehlen, dort die TTL anzupassen. Die Unit trägt jetzt eine
      Fassungszeile wie die Blöcke und wird nur bei älterer Fassung neu
      geschrieben, mit Backup. Units bis 1.12.0 haben keine Zeile und werden
      einmalig erneuert.

    • --setup/--uninstall hinterließ pro Zyklus eine Leerzeile mehr,
      eine von --setup angelegte config.fish blieb leer liegen, und ein
      erneuerter Block wanderte ans Dateiende. --uninstall nimmt die
      Trennleerzeile mit und löscht Dateien, die nur aus dem Block bestanden;
      die Erneuerung (auch --rescan) ersetzt den Block an seiner Stelle.

    • --update setzte die Rechte hart auf 755 und behielt keine
      Vorversion. Jetzt bleiben die Rechte der bisherigen Datei erhalten, die
      alte Version liegt als .sshm-bak.<Zeitstempel> ohne x-Bit daneben.
      Ohne Schreibrecht endet --update mit rc 1 statt 0.

    • Exit-Codes: sshm -f host endete bei einem Fehlversuch mit 1, eine
      Session mit 255; jetzt beide mit dem Code von ssh. Menü und Dateibrowser
      ohne Terminal meldeten einen fzf-Fehler und endeten mit 0, jetzt eine
      klare Meldung und rc 1 (ebenso die Host-Auswahl von --run).

    • --report: woche umfasste 8 Kalendertage, 1 zwei. Jetzt zählen
      N Tage einschließlich heute. Eine Session über Mitternacht zählte ganz
      auf den End-Tag und wird jetzt an der Tagesgrenze aufgeteilt; die
      Tageszeilen bleiben dabei nach Datum sortiert (auch in --csv). woche monat wird abgelehnt statt still den letzten Wert zu nehmen, Zahlen
      mit mehr als 5 Stellen ebenso (vorher Überlauf).

    • --history -3 bzw. abc fielen still auf 10 zurück, jetzt ein
      Usage-Fehler wie bei --report. Leerzeilen in der History zeigt
      --history nicht mehr als leere start-Zeile, und --last meldet ihretwegen
      nicht mehr „Keine Verbindungshistorie".

    • Env-Schalter werteten nur genau 1/0 aus, SSHM_LEARN=yes oder
      SSHM_LOOP=true schalteten aus. Alle Schalter verstehen jetzt
      1/yes/true/on und 0/no/false/off. Ein anderer Wert wird bei jedem
      Aufruf gleich beim Start gemeldet (auch --report, --history, -V),
      nicht erst, wenn der Schalter gebraucht wird.

    • $EDITOR mit Leerzeichen im Pfad oder nicht vorhanden führte still
      zu vi. Jetzt wird $EDITOR als Pfad oder als Kommando mit Argumenten
      versucht, ein nicht auffindbarer gemeldet, danach nano, dann vi.

    • Ohne HOME starb sshm schon bei -V (set -u). Ist HOME nicht
      gesetzt, gilt das Home-Verzeichnis aus der passwd.

    • Hänger nach Sessionende mit ControlPersist: Baute die Session selbst
      einen Multiplex-Master auf (ControlMaster auto + ControlPersist in
      OPTS oder ~/.ssh/config), behielt der Hintergrund-Master das stderr des
      -v-Mitschnitts. sshm hing bis zum Persist-Timeout (bei yes
      unbegrenzt), die Dauer in der History stimmte nicht. ssh schreibt seine
      Meldungen jetzt per -E in eine FIFO, die ein Leser bis zu einer
      Endmarke liest; Banner, Prompts und Fehlermeldungen bleiben sichtbar.
      Gleiches im Dateibrowser mit -v im OPTS-Feld. Die Debug-Ausgabe kommt
      dabei aus -o LogLevel=DEBUG1 statt -v: ssh reicht -v an den
      Kind-ssh eines ProxyJump weiter (-J, auch mehrstufig oder aus der
      ~/.ssh/config), -E aber nicht — dessen Debug-Zeilen landeten sonst
      ungefiltert im Terminal.

    • Session über einen bestehenden Master galt als Fehlversuch
      (fail reason=unknown exit=0), jetzt als normale Session.

    • Key-Suche scheiterte an sshd PerSourcePenalties (OpenSSH ≥ 9.8,
      Default in Debian 13): Eine Verbindung pro Key ließ sshd nach wenigen
      Fehlschlägen jede weitere verwerfen, alle Keys erschienen als ✗. Die
      Suche bietet jetzt alle Keys in einer Verbindung an und liest den
      akzeptierten aus dem Debug-Log; nach MaxAuthTries geht es mit den
      übrigen in einer weiteren Verbindung weiter. Eine verworfene oder mitten
      in der Anmeldung abgebrochene Verbindung wird als solche gemeldet, ein
      Versuch dauert höchstens 30 s (vorher hing er bei einer Sperre bis zum
      TCP-Timeout).

    • Key-Suche wurde unnötig angeboten, auch bei
      PubkeyAuthentication=no oder PreferredAuthentications ohne
      publickey. Der Hinweis nennt in dem Fall die abgeschaltete Option.

    • Abgelehnte Key-Suche endete mit rc 1, jetzt mit dem Exit-Code des
      Fehlversuchs (255).

    • Ctrl-C am Passwort-Prompt beendete sshm ohne Meldung und ohne
      History-Zeile. Jetzt fail reason=interrupted exit=130; im Menü geht es
      danach mit dem Menü weiter.

    • Dateibrowser ohne Master: Starb der Multiplex-Master, verband jeder
      weitere Zugriff still direkt, ohne Port, Key und Jumphost des Eintrags,
      und die Liste zeigte nur ../. Jetzt meldet der Browser „Verbindung
      verloren" und endet (History exit=255). Ohne eigenen Keepalive bekommt
      der Master ServerAliveInterval=15/CountMax=3, ein Netzausfall ließ
      den Ordnerwechsel sonst bis zum TCP-Timeout hängen. ESC beendet den
      Browser auch bei hängender Verzeichnisliste.

    • Abgebrochener Download (Ctrl-C) hinterließ eine Teildatei, die
      Sitzung fehlte in der History. Neu angelegte Teildateien bzw. -ordner
      werden entfernt, die Sitzung steht mit exit=130 im Log.

    • Lernmodus: Ein per ssh-add mit relativem Pfad geladener Key
      (Kommentar z. B. „k_e“) wurde still nicht nachgetragen. Er wird jetzt per
      Fingerprint einer Datei in ~/.ssh zugeordnet, sonst gibt es einen
      Hinweis.

    • Direkt-Connect auf einen gedroppten Host dauerte über zwei Minuten.
      Ohne eigenen ConnectTimeout (OPTS bzw. ssh -G) gelten jetzt 10 s,
      auch für den Dateibrowser.

    • Port-Konflikt: Ziel host:2299 plus -p 2222 in OPTS nahm still
      2299. sshm warnt jetzt (der Port im Ziel gewinnt weiterhin).

    • --run schrieb reason=unknown auch bei Hostkey-Fehler,
      Auth-Fehler oder unerreichbarem Host; jetzt klassifiziert wie beim
      Connect, mit Hinweis.

    • SSHM_PROBE=1 ohne Terminal wartete auf eine Antwort, die nie kam.
      Jetzt Abbruch mit Meldung und rc 1; ebenso fragt die Key-Suche nur an
      einem Terminal.

    • Farben auch in Pipes und Dateien: --report, --history, -l,
      --check, --run und die Meldungen rund um eine Session schrieben
      ANSI-Codes auch dorthin. Farbe gibt es jetzt nur am Terminal (getrennt
      geprüft für stdout und stderr) und nie bei gesetztem NO_COLOR. Das
      fzf-Menü und seine Preview behalten ihre Farben.

    • Spalten mit Umlauten verrutschten in -l, --check, --history,
      --report, --import, „Mehrere Treffer" und der Key-Suche: printf
      (bash wie mawk) zählte Bytes. Ausgerichtet wird jetzt nach Zeichen,
      auch unter LANG=C.

    • SSHM_PROBE und --check zeigten IPv6 als ::1:22, jetzt
      [::1]:22. Unter netcat-traditional (Debian-Default, kann kein IPv6)
      galt außerdem jedes IPv6-Ziel als nicht erreichbar, auch ein Hostname,
      der nur per AAAA auflöst. sshm prüft jetzt immer per timeout +
      /dev/tcp, nc nur noch, wenn timeout fehlt.

    • --check zählte Einträge mit ungültigem Quoting als „übersprungen
      (Jumphost)". Die Summe nennt beide getrennt.

    • Key-Erkennung (--setup, --rescan, Key-Suche): Jede Datei mit
      gleichnamiger .pub galt als Key, auch eine leere — IdentityFile ~/.ssh/random.txt. Maßgeblich ist jetzt allein der
      -----BEGIN … PRIVATE KEY------Header.

    • --uninstall nannte ~/.config/sshm/hosts auch, wenn es die Datei
      nicht gab, und ignorierte XDG_CONFIG_HOME.

    • Notizen (SSHM_NOTE) mit " machten note="…" mehrdeutig. " und
      \ werden jetzt mit \ maskiert, Steuerzeichen (auch ESC-Sequenzen)
      zu Leerzeichen. Ältere Zeilen bleiben lesbar.

    • Completion bot doppelt vergebene Namen mehrfach an.

    • --run -s konnte das sudo-Passwort an ein falsches Ziel schicken:
      Starb der Multiplex-Master, baute ssh für Prüfung und Kommando still eine
      direkte Verbindung auf — ohne Port, Key und Jumphost des Eintrags. Dazu
      teilten sich alle Hosts eines Laufs denselben Socket-Pfad. Jetzt gibt es
      einen Socket pro Host, und die Zugriffe über den Master (gemeinsam mit
      dem Dateibrowser) laufen mit ProxyCommand=false: Ist er weg, scheitert
      der Zugriff sofort (fail reason=lost).

    • sudo-Passwörter mit Leerzeichen am Anfang oder Ende (--run -s,
      Dateibrowser CTRL-R) wurden gekürzt — ein Fehlversuch pro Host.

    • Ctrl-C am sudo-Prompt war wirkungslos: bash setzte die Eingabe nach
      dem Signal einfach fort, eine danach blind zu Ende getippte Zeile ging
      doch an sudo. Ctrl-C bricht den Prompt jetzt ab (--run -s mit
      fail reason=interrupted, im Dateibrowser bleibt der sudo-Modus aus).

    • Dateibrowser, Upload im sudo-Modus: Erlaubt sudo tar ohne Passwort
      (NOPASSWD, !authenticate), landete die Passwortzeile im tar-Strom und
      der Upload scheiterte; bei ungültigem Passwort hätte sudo den tar-Strom
      als weitere Versuche gelesen. Remote liest jetzt die Shell die Zeile,
      gibt nur sie an sudo -v, tar läuft danach per sudo -n.

    • Lernmodus, Key-Suche: Key-Pfade mit ", $(…) oder Backtick landeten
      ungequotet im OPTS-Feld, das beim nächsten Connect per eval gelesen
      wird — Code-Ausführung bzw. eine kaputte Konfig. Der Pfad wird jetzt
      sicher gequotet; Pfade mit |, %, ${ oder Steuerzeichen, die per
      -i nicht nutzbar sind, trägt sshm nicht ein und sagt es.

    • --setup/--rescan: Ein Key mit ' im Dateinamen machte die ganze
      ~/.ssh/config ungültig
      („invalid quotes"). Solche Pfade stehen jetzt
      in "…", % wird zu %%; Keys mit ", \, ${ oder Steuerzeichen
      werden mit Hinweis im Block übersprungen.

    • fish als Login-Shell der Gegenseite: fish wertet in '…' die Folgen
      \\ und \' aus, Kommandos und Dateinamen mit Backslash kamen in
      --run und im Dateibrowser verfälscht an. Das Quoting verzichtet jetzt
      auf Backslashes innerhalb der Quotes und parst in sh, bash und fish gleich.

    • --run -s mit sudo-rs (Ubuntu ab 25.10, in Debian 13 optional):
      Wegen anderer Meldungstexte gab es statt der Passwort-Rückfrage
      sudo=error. sshm kennt jetzt die Texte beider Implementierungen.

    • --run ohne -s: Ctrl-C am Passwort-Prompt stand als start/end exit=130 in der History statt als fail reason=interrupted. --run
      ordnet Verbindungen jetzt genauso ein wie eine Session.

    • Ziel user@[fe80::1] ohne Port: -a nahm es an, ssh fand den Host
      mit Klammern aber nicht. Die Klammern entfallen jetzt beim Verbinden.

    • Bash-Completion fehlte in Login-Shells (jeder ssh-Login auf Debian):
      ~/.profile sourct ~/.bashrc, bevor es ~/.local/bin in den PATH
      nimmt, sshm war beim Laden noch nicht auffindbar. Die Completion lädt
      jetzt erst beim ersten TAB.

    • -a und --import nahmen Namen an, die mit # oder - beginnen:
      Die einen standen danach als Kommentar unsichtbar in der Konfig, die
      anderen hielt sshm beim Aufruf für eine Option. Beides wird abgelehnt,
      sshm -e und -l warnen bei - vorn.

    • Überzählige Argumente wurden still ignoriert — sshm --update -y extra spielte sogar das Update ein. Jetzt Fehler mit Exit-Code 1, ebenso
      bei --setup x, -l x, --completion fish x, sshm web extra usw.

    • Zu viele Felder in der Konfig (| in der Beschreibung) schnitt sshm
      ohne Hinweis ab. sshm -e und -l nennen jetzt die Zeile.

    • --report 1: Eine Session, die genau um 00:00:00 endete, erschien
      heute als 1× 0s.

    • Dateibrowser: Preview und Startverzeichnis schluckten Tastatur-
      Vorlauf (ssh ohne </dev/null).

    • Ctrl-C während --update hinterließ die halb geladene Datei in
      $TMPDIR.

    • Auth-Hinweis bei Fehlversuch behauptete „Passwort nicht akzeptiert
      oder abgebrochen", auch wenn ssh gar kein Passwort versucht hatte
      (PreferredAuthentications=publickey, PasswordAuthentication=no,
      BatchMode). Der Hinweis richtet sich jetzt nach dem Debug-Log: Passwort
      versucht, nicht versucht, bzw. ohne Mitschnitt unbekannt; ebenso
      „kein Key angeboten" statt „kein Key akzeptiert".

    Geändert

    • Setup-Fassung 3: Die Blöcke von --setup haben sich geändert
      (Key-Erkennung, Completion, Quoting der IdentityFile-Zeilen). Nach dem
      Update einmal sshm --setup ausführen — Blöcke aus 1.12.0 (Fassung 2)
      werden mit Backup an ihrer Stelle erneuert. Die Unit des Agent-Service
      zählt getrennt und bleibt unangetastet, eine angepasste TTL also auch.

    • --run ohne -s läuft nicht mehr in der Login-Shell der
      Gegenseite,
      sondern wie mit -s per sh -c in bash bzw. sh — so
      funktioniert [[ … ]] auch bei fish als Login-Shell. Achtung: Eine
      Login-Umgebung gibt es dabei nicht. PATH-Ergänzungen aus ~/.profile
      (auf Debian ~/.local/bin), Aliasse und Funktionen der Login-Shell und
      fish-Syntax stehen dem Kommando nicht mehr zur Verfügung; sshm --run 'sshm --update -y' endet dort z. B. mit 127, hier den vollen Pfad
      angeben.

    • --run schneidet die Meldungen von ssh immer mit (auch mit
      SSHM_STATS=0), damit Fehlversuche klassifiziert werden; die Ausgabe
      des Kommandos läuft unverändert durch. Die end-Zeile trägt ohne -s
      jetzt auch sent/received — nicht mit -s (das Kommando läuft dort
      über einen eigenen Multiplex-Master) und nicht, wenn die Verbindung
      selbst einen ControlPersist-Master aufbaut (ssh meldet die Mengen dann
      erst beim Ende des Masters).

    • Dauer überall im selben Format: --report zeigte 2h00m, History
      und Zusammenfassung 2h05m00s. Jetzt überall 42s / 3m07s /
      2h05m00s; ältere History-Zeilen liest --report weiter.

    • --check prüft parallel (bis zu 16 gleichzeitig): sechs gedroppte
      Hosts kosteten nacheinander 12 s, jetzt 2 s. Die Ausgabe bleibt in der
      Reihenfolge der Konfig.

    • Neuer Fehlergrund reason=rejected: Der Server hat die Verbindung
      vor der Anmeldung verworfen (PerSourcePenalties, fail2ban mit REJECT,
      MaxStartups). Bei geändertem Hostkey nennt der Hinweis den passenden
      ssh-keygen -f … -R …-Befehl.

    • README/usage: --check prüft nur TCP, ein Hostkey-Wechsel zeigt dort ✓.

    • Namen nur aus Ziffern: sshm 3 meint immer Eintrag Nr. 3, ein
      Eintrag namens 3 ist per Name nicht erreichbar. -a lehnt solche
      Namen ab, --import überspringt sie, sshm -e warnt (auch bei doppelt
      vergebenen Namen).

    • Hilfe: Der Kopfkommentar des Scripts verweist auf sshm -h,
      usage() ist die einzige Quelle für Aufruf und Env-Schalter.

    Downloads