• v2.0.0 65ca18c674

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

    Lyra released this 2026-11-08 14:32:55 +01:00 | 80 commits to main since this release

    Bestandsinstallationen: danach sshm --setup erneut 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,
      also sshm web uptime, sshm web -- ls -l /tmp oder sshm 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, -E und -o LogLevel=…
      schalten den Mitschnitt (und damit Lernmodus und Transferstatistik) für diesen Aufruf ab;
      -i, -F, -o, -l, -p und -J nur den Lernmodus; -G, -O, -V und -Q laufen
      direkt als ssh ohne History. Nach dem Namen gehört alles ssh: sshm web -f ist ssh's
      Hintergrund-Option, nicht der Dateibrowser.
    • --setup zeigt 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. --uninstall entfernt es wieder.

    Geändert

    • --setup beschädigt plain ssh und fremde Agents nicht mehr. Die Blöcke haben jetzt
      Fassung 4; --setup ersetzt ältere an Ort und Stelle (mit Backup), bis dahin weist sshm -k
      bzw. eine gescheiterte Anmeldung einmal darauf hin.
      • ~/.ssh/config: nur noch AddKeysToAgent yes unter Host *. Die Liste aller Keys als
        IdentityFile galt kumulativ für jeden Host, auch für Host-Blöcke danach und den
        ProxyJump; ab sechs Keys endete plain ssh in „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.
        -k finden lassen.
      • Shell-Blöcke (bash und fish gleich): SSH_AUTH_SOCK wird nur noch gesetzt, wenn kein
        funktionierender Agent erreichbar ist. Reihenfolge: vorhandenes SSH_AUTH_SOCK
        (weitergeleiteter Agent per ssh -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, nach ssh -A hieß es „The agent has no identities".
      • Distro-Agent statt eigener Unit: Bringt die Distro ssh-agent.socket mit (Debian 13),
        installiert --setup keine sshm-agent.service mehr, 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 --setup ihn nicht neu (das Drop-in greift nach dem
        nächsten Login).
      • --rescan schreibt nur noch den ssh_config-Block neu — eine Key-Liste gibt es dort nicht
        mehr.
    • sshm -k ohne Argument lädt nicht mehr alle Keys aus ~/.ssh, sondern die Standard-Keys
      (die auch ssh-add ohne Argument nähme) und die per -i in der Hosts-Datei genannten. Die
      übrigen nennt es nur; laden mit sshm -k NAME. Jeder Key im Agent ist bei jedem Server ein
      weiterer Anmeldeversuch.
    • Was im OPTS-Feld nicht mehr ausgewertet wird, meldet sshm -l bzw. -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 -i selbst) und {a,b}.
      -a lehnt 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 bei PerSourcePenalties (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 -a und --import ab, 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: -a lehnt Ziele wie u@::1:22 ab (Adresse
      ::1:22 oder [::1]:22?), bestehende Einträge dieser Form melden -l/-e als 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 ask bleiben sie als Kontext der Rückfrage sichtbar.
    • sshm --report 0 ist ungültig (bisher still dasselbe wie alle). Kleinster Zeitraum ist
      1 (heute), alles weiterhin per alle.
    • Schneller bei großen Hosts-Dateien: Bei 3000 Einträgen braucht -l 0,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), --check 22 s statt 65 s (ssh -G lä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,
      dann mv. Bisher machte TMPDIR=/nonexistent sshm --rescan aus ~/.ssh/config eine leere
      Datei, ein volles TMPDIR ließ --uninstall ~/.ssh/config und ~/.bashrc als „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.
    • -a und --import melden keinen Erfolg mehr ohne Schreiben (z. B. schreibgeschützte
      Hosts-Datei: bisher „Permission denied", dann „Hinzugefügt", rc 0). --import schreibt 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.
    • --uninstall lässt keine führende Leerzeile in ~/.ssh/config mehr 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).
    • --history mit 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 -k fragen
      den Agent unter timeout ab (2 bzw. 5 s). Ein per SIGSTOP angehaltener Agent hielt bisher
      jede neue Shell und -k fest; jetzt meldet die Shell „antwortet nicht" und startet daneben
      keinen zweiten Agent.
    • --run hängt nicht mehr bei Netzverlust: Ohne ServerAliveInterval aus OPTS bzw.
      ~/.ssh/config setzt sshm jetzt — wie im Dateibrowser — ServerAliveInterval=15/
      ServerAliveCountMax=3 (mit -s für den Master). Bisher galt nur ConnectTimeout; nach
      einem Paketverlust mitten im Kommando lief der Lauf unbegrenzt weiter.
    • --report hängt nicht mehr an einer kaputten History-Zeile: Eine Dauer wie
      duration=99999999999h ließ 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 \r geschrieben; 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ätzlich key=accepted.
    • Fehler am Jumphost galten als Sperre des Ziels: Scheiterte die Anmeldung am Jumphost
      (oder erreichte er das Ziel nicht), meldete sshm reason=rejected mit dem Rat, auf das Ende
      einer PerSourcePenalties-Sperre zu warten. Bei Einträgen über ProxyJump/ProxyCommand heißt
      das jetzt reason=jumphost mit Verweis auf die Meldung des Jumphost-ssh.
    • Key-Suche bietet jeden Key genau einmal an: Keys, die ohnehin per IdentityFile aus
      ~/.ssh/config kommen, gehen nicht zusätzlich per -i raus (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 — bei PerSourcePenalties (Debian 13) und fail2ban
      teuer.
    • Lernmodus und Key-Warnung kennen IdentityFile aus ~/.ssh/config: importierte Aliasse
      mit eigenem IdentityFile zählen in der Warnung von -l nicht 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 per eval — nicht erst beim Connect, sondern schon beim
      Einlesen durch --check und --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 -W expandierte
      die Namensliste, ein Name wie $(…) lief beim TAB. Gefiltert wird jetzt per Präfixvergleich.
    • Ziel mit führendem - (z. B. -oProxyCommand=…) lehnt -a ab; 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 $TMPDIR bzw. /tmp), die FIFO
      mit festem Namen in einem privaten Verzeichnis statt unter einem per mktemp -u ausgedachten
      Namen.
    Downloads