• v2.0.4 d765cc07f3

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

    Lyra released this 2026-11-09 11:21:33 +01:00 | 65 commits to main since this release

    Sicherheit

    • Keys landen nicht mehr unbefristet im Agent. Der Setup-Block in ~/.ssh/config setzt
      AddKeysToAgent <Ablaufzeit> statt yes, wenn der lokale ssh das kann (OpenSSH ≥ 8.9; sonst
      bzw. bei Ablaufzeit 0 weiter yes). Die Frist des Agents (-t) greift nur an den Agents,
      die sshm einrichtet — an einem Desktop-Agent oder per ssh -A weitergeleiteten blieb ein
      per yes geladener Key bis zum Ende der Sitzung entsperrt. Setup-Fassung 5: sshm --setup
      erneuert die Blöcke mit Backup. Wer die Datei mit einem älteren Client teilt, setzt dort yes.
    • sshm-eigene Verbindungen begrenzen AddKeysToAgent selbst. Steht es effektiv auf yes,
      setzt sshm -o AddKeysToAgent=<Ablaufzeit> (Direktstart, Menü, --last, --run,
      Dateibrowser, Key-Suche). In einer ssh-Sitzung (SSH_CONNECTION) an einem fremden, meist
      weitergeleiteten Agent setzt es no: Keys eines Jumphosts landen nicht mehr im Agent des
      Desktops. no, ask, confirm und Zeitangaben bleiben — sshm verschärft nur.
    • Admin-Vorgaben gehen vor. Setzt /etc/ssh/ssh_config (bzw. ssh_config.d/*.conf samt
      Include) AddKeysToAgent, schreibt --setup keine Zeile („vom Admin gesetzt (…) — bleibt“)
      und sshm setzt keine eigene Option — die Config des Users gälte sonst vor der des Admins.

    Neu

    • Ablaufzeit dauerhaft in ~/.config/sshm/settings (agent_ttl=8h). --setup fragt am
      Terminal danach (Vorschlag 2h bzw. der gespeicherte Wert, 0 = unbegrenzt), --setup --ttl 8h
      setzt sie ohne Abfrage. Sie steht dann in Shell-Blöcken, Unit, Drop-in und ssh_config-Block;
      weicht dort ein Wert ab, schreibt --setup die Datei neu, auch bei aktueller Fassung. Bisher
      setzte jede neue Fassung von Hand geänderte Werte auf 2h zurück — jetzt übernimmt das Setup
      einen abweichenden Wert aus Drop-in, Unit oder Block in die Datei, solange dort noch keiner
      steht. Rangfolge: SSHM_AGENT_TTL > Datei > 2h.

    Behoben

    • kill, timeout oder ein geschlossenes Terminal während einer Session verlieren nichts
      mehr.
      TERM/HUP an sshm beendeten sshm erst nach ssh und dann ohne History-Zeile und ohne
      Lernmodus-Nachtrag. Jetzt geht das Signal sofort an ssh weiter, sshm schreibt start/end bzw.
      fail und den gelernten Key und endet mit 143 bzw. 129 — ohne Zusammenfassung, Notiz-Frage und
      Key-Suche. Das Menü endet danach ebenfalls, statt weiterzulaufen. Ohne Mitschnitt
      (SSHM_STATS=0, kein Lernmodus) gilt eine so beendete Session als fail reason=interrupted
      — ssh endet mit 255, mehr ist dann nicht zu erkennen.
    • --run nach TERM/HUP beim Verbindungsaufbau: fail reason=interrupted statt unknown.
    • Hängender ssh-agent blockiert keine Verbindung mehr. Antwortet der Agent nicht
      (kill -STOP), meldet sshm das einmal pro Lauf („ssh-agent an … antwortet nicht (gestoppt?) —
      Verbindung ohne Agent“) und verbindet ohne Agent (Key-Datei, Passwort), statt bis zum
      timeout zu hängen — Direktstart, Menü, --run (einmal pro Socket, nicht pro Host),
      Dateibrowser und Key-Suche. Auch ein IdentityAgent aus ~/.ssh/config wird geprüft.
    • Parallele sshm -a mit gleichem Namen legen keine Duplikate mehr an. Die Namensprüfung lief
      außerhalb der Sperre; jetzt prüft sshm unter der Sperre noch einmal gegen die aktuelle Datei und
      schreibt sonst nichts („existiert schon“). --import ebenso: Legt ein paralleler Lauf einen
      der Namen an, übernimmt der Import nichts und sagt das.
    • History nicht schreibbar bzw. nicht lesbar wird gemeldet. Konnte sshm die History nicht
      schreiben (Rechte, Datenträger voll, Sperre), ging das still verloren; jetzt kommt einmal pro
      Lauf „History nicht geschrieben: … (Grund)“ auf stderr, Exit-Code und Verbindung bleiben.
      --history und --last melden eine unlesbare Datei („History nicht lesbar“, rc 1) statt
      eines grep-Fehlers mit rc 0 bzw. „Keine Verbindungshistorie vorhanden“.
    • Dateibrowser: Jeder gescheiterte Upload nennt die mögliche Teildatei („✗ X — auf host:dir
      kann eine Teildatei liegen“), nicht nur der abgebrochene. Remote-Staging folgt später.
    • Key-Suche: Folgeverbindung wie der erste Versuch. Nach dem gefundenen Key verband sshm ohne
      Befehl und ohne durchgereichte Optionen — sshm host true öffnete eine Login-Shell, -L
      fehlte. Jetzt mit denselben Argumenten wie der erste Versuch; mit Befehl bzw. -f/-W ohne
      Zusammenfassung und Notiz, Exit-Code der Folgeverbindung. Die Rückfrage nennt zusätzlich, dass
      der Server alle angebotenen Public Keys sieht.
    • --run nimmt Teilstrings nur nach Bestätigung. sshm --run CMD elf lief bisher ohne
      Hinweis auf self. Jetzt zeigt sshm vor dem ersten Host die Liste (elf → self) und fragt
      [j/N] — vor sudo-Prüfung und Passwort von -s/-S; ohne Terminal Abbruch mit rc 1
      („exakten Namen oder Nummer angeben“). Exakte Namen, Nummern und die fzf-Auswahl wie bisher.
      Der Direktstart mit Befehl bzw. -f/-W nennt einen Teilstring-Treffer auf stderr
      (→ webshop-prod (Teilstring „web“)); Session und Menü bleiben unverändert.
    Downloads
  • v2.0.3 0f8e1860e4

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

    Lyra released this 2026-11-09 09:19:32 +01:00 | 69 commits to main since this release

    Sicherheit

    • Ziel und Befehl kommen nie mehr als ssh-Option an. Jeder ssh-Aufruf setzt -- vor das
      Ziel; sshm host -- -x schickt -x als Befehl wie ssh host -- -x. Ein Hostteil, der nach
      user@ oder in […] mit - beginnt, wird bei -a, --import und beim Lesen der
      Hosts-Datei abgelehnt (bisher nur ein - ganz vorn).
    • Der ssh-Mitschnitt gilt als nicht vertrauenswürdig. Ein Server kann über Texte, die ssh
      ins Debug-Log schreibt, eigene Zeilen einfügen. Der Lernmodus übernimmt einen Key nur noch,
      wenn der Fingerprint der lokalen Datei passt (auch ohne .pub); Hostkey-Diagnose und
      ssh-keygen -R-Vorschlag stützen sich nur auf den Teil vor jedem Server-Text; eine
      gescheiterte Anmeldung gilt nicht als Verbindung, auch wenn im Log „Authenticated to" steht;
      die Methodenliste des Servers landet nur noch mit den Zeichen einer SSH-Namensliste in
      Ausgabe und History.
    • --run -s schickt das sudo-Passwort nur an genannte Hosts. Erst prüft sshm alle
      gewählten Hosts (sudo -n true), dann nennt der Prompt die Empfänger
      (sudo-Passwort für 3 Hosts (web1, db1, db2)); NOPASSWD-Hosts bekommen es nie, braucht keiner
      eins, gibt es keinen Prompt. Abgelehnt: Meldung mit Host, höchstens eine Neueingabe (bisher
      drei), keine, wenn es schon auf einem Host galt.
    • Private Temp- und Socket-Verzeichnisse nur in einem eigenen XDG_RUNTIME_DIR. Es muss
      dem User gehören, darf kein Symlink und nicht für Gruppe/andere beschreibbar sein — nach
      su zeigt es oft auf den Ordner eines anderen Users. Sonst $TMPDIR bzw. /tmp. Die
      Steuer-Sockets von --run -s und Dateibrowser laufen jetzt über dieselbe Prüfung (bisher
      ungeprüft XDG_RUNTIME_DIR).
    • --update ignoriert ~/.curlrc und ~/.wgetrc (curl -q, wget --no-config) — dort
      hätten insecure, check_certificate = off oder ein Proxy die Zusage „Zertifikatsprüfung
      bleibt immer an" ausgehebelt. Die Stage-Datei neben dem Ziel bekommt einen Zufallsnamen
      (mktemp) statt .sshm.update.<PID>.
    • Steuerzeichen werden für die Anzeige entschärft, auch C1 (U+0080–U+009F). OPTS,
      Beschreibung, Name und Ziel bei -l, im Menü und in der Vorschau, --history, Meldungen,
      der Startordner des Dateibrowsers (Remote-pwd) und dessen Vorschau zeigen sie als ?.
      Remote-Namen mit C1-Zeichen blendet der Dateibrowser wie andere Steuerzeichen aus; Name und
      Ziel mit C1 gelten in der Hosts-Datei als ungültig (Warnung, Zeile übersprungen). Die Hosts-
      Datei selbst bleibt unverändert.
    • bash-Completion fügt Namen gequotet ein — ein Name mit Leerzeichen, * oder $(…) wird
      nicht mehr zerlegt bzw. beim Ausführen ausgewertet. fish quotet selbst.

    Neu

    • --run -S: sudo-Passwort pro Host; der Prompt nennt den Host, leer = Host überspringen,
      abgelehnt → eine Neueingabe. -s und -S schließen sich aus.
    • Abschlussübersicht bei --run mit mehreren Hosts, auch ohne sudo:
      3 ok · 1 exit≠0 (web2) · 1 sudo abgelehnt (db1: Passwort abgelehnt) · 1 übersprungen (db2: kein Passwort) · 1 ohne Verbindung (web3); bei Ctrl-C mit „abgebrochen, N nicht
      bearbeitet".

    Geändert

    • --run -s verbindet jeden Host zweimal (Prüfung, dann Ausführung) — immer nur eine
      Verbindung zur Zeit statt aller Master gleichzeitig offen. Hosts mit Passwort-Login fragen
      damit zweimal nach dem ssh-Passwort.
    • README und Hilfe: Jeder Empfänger sieht das sudo-Passwort im Klartext; für viele Hosts
      besser NOPASSWD für bestimmte Befehle oder pam_ssh_agent_auth.
    Downloads
  • v2.0.2 90752658b1

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

    Lyra released this 2026-11-09 00:06:02 +01:00 | 73 commits to main since this release

    Sicherheit

    • --update lädt nur über HTTPS, auch nach Umleitungen. curl mit
      --proto =https --proto-redir =https; wget kennt dafür keine Option und folgt deshalb gar
      keiner Umleitung mehr (--max-redirect=0, die Update-URLs leiten nicht um). Bisher hätte
      eine Umleitung auf http:// das Script unverschlüsselt geholt. Ein wget ohne
      --max-redirect (busybox) bricht ab, statt ungeschützt zu laden.
    Downloads
  • v2.0.1 2a681a5964

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

    Lyra released this 2026-11-08 18:53:37 +01:00 | 75 commits to main since this release

    Geändert

    • sshm-agent.service übernimmt SSHM_AGENT_TTL (Systeme ohne Distro-ssh-agent.socket
      oder mit maskiertem Socket) — wie das Drop-in am Distro-Agent, bisher fest -t 2h. Die
      Unit-Fassung steigt auf 3: sshm --setup schreibt eine Unit aus 2.0.0 mit Backup neu; eine
      aktuelle, selbst angepasste Unit bleibt unangetastet.
    • Dateibrowser, Download eines vorhandenen Ordners ersetzt ihn (nach Rückfrage, die das
      jetzt ausdrücklich sagt), statt Remote- und lokalen Inhalt zusammenzumischen. Folge des
      Sicherheitsfixes unten: Das Element wird erst vollständig empfangen und geprüft, dann per
      mv an seinen Platz gestellt. Ein Abbruch lässt ein vorhandenes Ziel jetzt unverändert.

    Behoben

    • --uninstall hinterließ ein leeres ssh-agent.service.d/: Das Backup des Drop-ins lag im
      .d-Verzeichnis und hielt es fest. Backups des Drop-ins liegen jetzt daneben
      (~/.config/systemd/user/ssh-agent.service.d.sshm.conf.sshm-bak.<zeit>); --uninstall
      verschiebt Backups aus 2.0.0 dorthin und entfernt das Verzeichnis, wenn sonst nichts darin
      liegt.
    • SIGTERM/SIGHUP bei --run und im Dateibrowser ohne History-Zeile: Ein kill an sshm
      wirkt erst nach dem laufenden Kommando (bash) — danach beendete der globale Trap sshm, bevor
      die Zeile geschrieben war; bei --run -s fehlte so der Eintrag für ein vollständig als root
      gelaufenes Kommando. Jetzt wie bei Ctrl-C: Zeile schreiben, dann mit 143 bzw. 129 enden.

    Sicherheit

    • Dateibrowser: Download konnte Dateien außerhalb des angeforderten Elements schreiben. Das
      lokale tar entpackte den kompletten Strom des Servers in den Zielordner; die
      Überschreib-Rückfrage galt nur dem angeforderten Namen. Ein präparierter oder kompromittierter
      Server konnte so beim Holen von harmlos.txt zusätzlich z.B. ~/.bashrc ohne Rückfrage
      ersetzen. Betrifft den sudo-Modus seit 1.6.0 und jeden Download seit 1.10.0 bis einschließlich
      2.0.0. Jetzt wird in ein privates Staging-Verzeichnis im Zielordner entpackt (ohne Owner, mit
      umask, setuid/setgid entfernt); übernommen wird nur genau das angeforderte Element, wenn es den
      erwarteten Typ hat, keine Gerätedateien/FIFOs enthält und keine Symlinks, die aus ihm
      hinauszeigen. Weitere Einträge werden verworfen und gemeldet („Server lieferte unerwartete
      Einträge"). Ein Symlink als angefordertes Element wird nicht mehr übernommen.
    • Dateibrowser: Namen aus der Server-Liste ungeprüft; Abbruch löschte außerhalb des
      Zielordners.
      Ein Server konnte Namen wie x/../../ordner liefern; bei Ctrl-C/TERM/HUP
      während des Transfers entfernte das Aufräumen (seit 1.13.0) diesen Pfad per rm -rf. Namen mit
      /, ./.. oder Steuerzeichen werden jetzt ausgeblendet (eine Hinweiszeile zählt sie) und
      nicht übertragen; aufgeräumt wird nur noch das eigene Staging-Verzeichnis.
    Downloads
  • 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
  • v1.14.0 bab99df952

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

    Lyra released this 2026-11-08 00:57:35 +01:00 | 88 commits to main since this release

    Neu

    • -k zeigt die Restlaufzeit geladener Keys statt nur „bereits
      geladen", z. B. noch 1h12m05s. ssh-agent gibt sie nicht heraus: sshm
      merkt sich die Ladezeit in $XDG_RUNTIME_DIR/sshm-keys (ohne
      XDG_RUNTIME_DIR nicht) und liest die TTL aus der Kommandozeile des
      Agents hinter $SSH_AUTH_SOCK (Service wie Shell-Fallback). Von ssh per
      AddKeysToAgent geladene Keys zeigen „Restlaufzeit unbekannt", ein
      Agent ohne -t „ohne Ablauf". Einträge aus der Zeit vor einem Neustart
      des Agents verfallen.
    • -k verlängert geladene Keys: Im Terminal läuft ein Countdown von
      drei Sekunden, Enter lädt die Keys neu und setzt ihre Ablaufzeit zurück
      (bei mehreren mit Auswahl, leer = alle). Ohne Terminal oder bei
      unbekannter TTL kein Countdown.
    Downloads
  • 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
  • v1.12.0 235827b3d9

    sshm 1.12.0
    All checks were successful
    ShellCheck / shellcheck (push) Successful in 13s
    release / release (push) Successful in 1s
    Stable

    Lyra released this 2026-10-31 13:44:27 +01:00 | 99 commits to main since this release

    Neu

    • --setup erneuert veraltete Blöcke. Jeder Block trägt hinter dem
      Start-Marker eine Zeile # sshm-setup-version: N. Ist die Fassung im
      Host älter als die des Scripts (Blöcke vor 1.12.0 haben keine Zeile und
      gelten als Fassung 1), wird der Block mit Backup neu geschrieben statt
      mit „Marker vorhanden — skip" übergangen. Damit bringt sshm --update
      gefolgt von sshm --setup auf jedem Host auch die Shell-Blöcke auf den
      neuen Stand — etwa das in 1.10.0 geänderte pkill. Eigene Anpassungen
      im Block (z. B. die TTL) landen dabei im Backup.
    Downloads
  • v1.11.0 6020a1c58c

    sshm 1.11.0
    All checks were successful
    release / release (push) Successful in 1s
    Stable

    Lyra released this 2026-10-31 12:24:19 +01:00 | 105 commits to main since this release

    Neu

    • sshm --update [-y] holt eine neuere Version aus dem Forgejo und spielt
      sie ein.
      Quelle sind die Versions-Tags des Repos, geladen wird die Datei
      aus dem Tag. Vor dem Einspielen: bash -n und die SSHM_VERSION darin
      muss zum Tag passen; dann atomar über den Pfad des laufenden Scripts.
      Ohne Schreibrecht (/usr/local/bin) wird nur der sudo install-Befehl
      gezeigt. -y übergeht die Rückfrage, damit
      sshm --run 'sshm --update -y' host… alle Hosts auf einmal nachzieht.
    • Releases im Forgejo. Jede Version hat jetzt einen Tag vX.Y.Z und ein
      Release mit dem Changelog-Abschnitt als Notes — rückwirkend ab 1.3.0, dem
      ersten Stand im Repo. Ein Forgejo-Actions-Workflow legt das Release
      künftig beim Tag-Push an (.forgejo/workflows/release.yml), ohne
      externe Actions: nur curl und awk gegen die Raw-URLs des Tags.
    Downloads
  • v1.10.0 a403c80c5b

    sshm 1.10.0
    Some checks failed
    ShellCheck / shellcheck (push) Failing after 2s
    Stable

    Lyra released this 2026-10-31 11:49:55 +01:00 | 106 commits to main since this release

    Neu

    • Hinweis bei Auth-Fehlern: Was erlaubt der Server, was wurde angeboten?
      Scheitert die Authentifizierung, wertet sshm die letzte ssh-Meldung
      (Permission denied (publickey,…)) aus und zählt die angebotenen Keys
      aus dem -v-Mitschnitt. Im Terminal steht dann z. B. „Login nur per Key
      möglich (publickey) — keiner der 3 angebotenen Keys passt" samt Tipp
      (-i eintragen bzw. sshm -k); erlaubt der Server auch Passwort oder
      gar keinen Key-Login, sagt der Hinweis das ebenso. Die fail-Zeile im
      Log trägt dazu methods=… und keys=N.
    • --check und SSHM_PROBE lösen das Ziel per ssh -G auf. Aliasse
      aus der ~/.ssh/config und dort gesetzte Ports werden auf ihr echtes
      Ziel geprüft (steht dim hinter dem Eintrag); ProxyJump/ProxyCommand
      aus der ssh_config gelten wie -J in den Optionen als Jumphost.

    Geändert

    • --import trägt den Alias als Ziel ein, nicht den HostName. ssh
      wendet einen Host-Block nur an, wenn der Alias auf der Kommandozeile
      steht — bisher gingen ProxyJump, IdentityFile & Co. aus dem Block
      verloren, ein Eintrag hinter einem Jumphost funktionierte nach dem Import
      nicht. Das aufgelöste user@host:port steht jetzt in der Beschreibung.
    • Dateibrowser kopiert immer als tar-Stream durch die Multiplex-
      Verbindung
      , der scp-Zweig ist weg (siehe „Behoben"). Ganze Ordner
      kommen rekursiv mit, geholte Dateien gehören lokal dem eigenen Account.
    • Shell-Fallback räumt nur noch eigene verwaiste Agents weg. Das
      pkill -x ssh-agent im .bashrc/config.fish-Block traf jeden Agent
      des Users — auf Desktops auch den der Plasma-/GNOME-Session, sobald der
      sshm-Socket fehlte. Jetzt nur Agents, die an diesem Socket-Pfad gestartet
      wurden. Bestehende Blöcke bekommen das per sshm --uninstall und
      sshm --setup (jeweils mit Backup).
    • Dateibrowser protokolliert wie SSH-Sessions: start- und end-Zeile
      erst am Ende (start mit echter Startzeit), ein gescheiterter
      Verbindungsaufbau als fail-Zeile mit Grund und mode=files. Das META
      der start-Zeile heißt files statt scp.

    Behoben

    • Dateibrowser: Kopien scheiterten mit OpenSSH ≥ 9.0. scp läuft dort
      im SFTP-Modus und schickt Remote-Pfade nicht mehr durch eine Shell — das
      Single-Quoting aus 1.8.3 landete wörtlich im Dateinamen („No such file or
      directory"), Download wie Upload. Betroffen ab Debian 12 (9.2). Der
      tar-Stream braucht kein Quoting.
    • Dateibrowser: Master-Verbindung starb nach zwei Minuten Leerlauf.
      ControlPersist=120 zählt ab der letzten Client-Session; wer im fzf
      nichts tat, verlor den Socket, und die Folgeaufrufe (bewusst ohne
      Port/Key/Jumphost) liefen ins Leere — das Listing zeigte nur noch ../.
      Jetzt ControlPersist=yes, der Master wird beim Beenden explizit
      geschlossen — dafür gibt es zusätzlich einen HUP-Trap, damit das auch
      beim Schließen des Terminals passiert.
    • Dateibrowser: „ControlPath too long" bei langem $TMPDIR. Unix-
      Sockets vertragen ~108 Zeichen Pfad; das Socket-Verzeichnis liegt jetzt
      unter $XDG_RUNTIME_DIR (Fallback /tmp).
    • ENTER ohne Treffer beendete Menü und Dateibrowser. fzf meldet eine
      leere Filter-Query mit Exit 1; das wurde wie ESC behandelt. Jetzt bleibt
      man einfach in der Liste.
    • Lernmodus trug auch nach gescheitertem Connect ein und nahm den
      ersten vom Server akzeptierten Key statt des zuletzt akzeptierten —
      nach abgebrochener Passphrase-Abfrage also den falschen. Außerdem prüft
      der Nachtrag jetzt, dass am Index noch derselbe Name steht; sonst wird
      der Key nur gemeldet.
    • --keys: Keys ohne .pub wurden jedes Mal neu geladen. Der
      Fingerprint kommt jetzt notfalls direkt aus dem privaten Key (im
      OpenSSH-Format ohne Passphrase möglich). Ein .pub als Argument meint
      den privaten Key.
    • -a/-e auf frischer Installation: -e öffnete den Editor doppelt,
      -a erst den Editor und hängte dann an. Der First-Run legt bei beiden
      nur noch die Vorlage an.
    • --report --csv: Anführungszeichen in Hostnamen werden CSV-konform
      verdoppelt.
    Downloads