Hosts und Gruppen
Was jedes Feld, jeder Schalter und jede Einstellung tut, 99 Bedienelemente auf dieser Seite. Es ist der Text hinter dem ⓘ neben jeder Beschriftung in den Apps: Auf dem Desktop darauf zeigen oder klicken (oder im Feld F1 drücken), auf dem Smartphone antippen.
Die Zeile unter jedem Namen nennt die ID, die der Code dafür verwendet, und sagt, wenn nur eine der Apps das Element hat.
Host: das Wichtigste
Abschnitt betitelt „Host: das Wichtigste“Wo: Hosts › Neuer Host, oder Bearbeiten an einem Host.
Bezeichnung
Abschnitt betitelt „Bezeichnung“host.label
Der Name dieses Hosts in deiner Liste. Er ist nur für dich: Er wird nie an den Server gesendet und nicht zum Verbinden verwendet.
- Beispiel: web-01 (Produktion)
- Achtung: Erforderlich, bis zu 256 Zeichen.
Adresse
Abschnitt betitelt „Adresse“host.address
Wo der Server ist: ein Hostname oder eine IPv4- oder IPv6-Adresse. Hier gehört nur die Adresse hin; Port und Benutzername haben eigene Felder, daher werden user@host und host:22 abgelehnt.
- Beispiel: web.example.com, 10.0.0.12 oder 2001:db8::1
host.group
Der Ordner, in dem dieser Host liegt. Ein Host übernimmt jede Einstellung, die er nicht selbst setzt, von seiner Gruppe, dann von den übergeordneten Gruppen, dann aus den Einstellungen.
- Standard: Keine Gruppe.
- Achtung: Wird ein Host in eine andere Gruppe verschoben, ändert sich jeder geerbte Wert: Port, Benutzername, Schlüssel, Jump-Hosts und der Rest.
host.tags
Freie Begriffe zum Finden und Filtern von Hosts, etwa „prod“ oder „database“. Ein Host kann bis zu 64 Tags haben, und ein Tag-Name ist 1 bis 64 Zeichen lang.
- Beispiel: prod, eu-west, postgres
- Achtung: Auf dem Smartphone löscht das × neben einem Tag in diesem Formular das Tag nach Rückfrage von jedem Host.
Betriebssystem
Abschnitt betitelt „Betriebssystem“host.os
Welches System auf diesem Host läuft, angezeigt als Symbol und Name am Host. Steht es auf „Automatisch erkennen“, liest Sternway es beim Verbinden aus: aus der Begrüßung des SSH-Servers und einem einmaligen, rein lesenden Blick auf den Host (seine os-release-Datei, uname und der Name seiner Login-Shell, der auch bestimmt, was die eingebauten Werte eines Snippets enthalten dürfen), über einen eigenen Kanal, nie in dein Terminal getippt. Wähle ein System aus der Liste für einen Host, den es nicht oder falsch erkennt, etwa einen Router, der nur „Linux“ meldet; deine Wahl bleibt erhalten und wird durch nichts Erkanntes ersetzt.
- Standard: Automatisch erkennen.
- Beispiel: Eine Firewall, die sich wie ein normales FreeBSD meldet: Wähle pfSense.
- Achtung: Dies ändert nur die Anzeige. Es ändert nicht, wie Sternway sich verbindet.
Notizen
Abschnitt betitelt „Notizen“host.notes
Alles, was du dir zu diesem Host merken willst. Notizen werden mit dem Host gespeichert und nicht zum Verbinden verwendet. Bis zu 10.000 Zeichen.
- Achtung: Notizen werden wie der Rest des Hosts synchronisiert, bewahre hier also kein Passwort auf.
Host: Anmeldung
Abschnitt betitelt „Host: Anmeldung“Wo: Der Host- oder Gruppeneditor, unter der Adresse.
SSH-Port
Abschnitt betitelt „SSH-Port“host.port
Der Netzwerkport, auf dem der SSH-Server lauscht, 1 bis 65535. Ändere ihn nur, wenn der Server auf einem anderen Port eingerichtet wurde. Mosh und SFTP nutzen ihn ebenfalls; Telnet hat einen eigenen Port.
- Standard: 22.
- Beispiel: 2222
Zugangsdaten
Abschnitt betitelt „Zugangsdaten“host.credentials · Nur Smartphone
Wie sich dieser Host anmeldet. „Gespeicherte Identität verwenden“ übernimmt Benutzername, Passwort und Schlüssel aus einer Identität in deinem Schlüsselbund; mit „Direkt festlegen“ gibst du sie nur für diesen Host ein.
- Standard: Direkt festlegen.
- Achtung: Beim Wechseln geht verloren, was die andere Option enthielt: Wählst du eine Identität, werden der hier eingegebene Benutzername, das Passwort und der Schlüssel entfernt; wählst du „Direkt festlegen“, wird die Identität getrennt.
Benutzername
Abschnitt betitelt „Benutzername“host.username
Das Konto, mit dem du dich auf dem Server anmeldest. Lässt du es leer, fragt die App beim Verbinden danach.
- Standard: Keiner: Du wirst beim Verbinden gefragt.
- Beispiel: root, ubuntu oder deploy
- Achtung: Eine für diesen Host gewählte gespeicherte Identität ersetzt den hier eingegebenen Benutzernamen.
Passwort
Abschnitt betitelt „Passwort“host.password
Das Passwort dieses Kontos, beim Verbinden einmal versucht, damit du nicht gefragt wirst. Lass es leer, um jedes Mal gefragt zu werden oder dich stattdessen mit einem Schlüssel anzumelden.
- Standard: Keins.
- Achtung: Es wird mit dem Host im Tresor gespeichert und mit ihm synchronisiert, außer „Schlüssel und Identitäten synchronisieren“ unter Einstellungen › Sicherheit ist aus; dann bleibt es auf diesem Gerät. Auf dem Desktop bedeutet ein leeres Feld „kein Passwort“ und blockiert auch eines, das die Gruppe vorgeben würde; mit „Überschreibung aufheben“ wird wieder geerbt.
Identität
Abschnitt betitelt „Identität“host.identity
Eine gespeicherte Anmeldung aus deinem Schlüsselbund: ein Benutzername mit Passwort, Schlüssel oder beidem, einmal hinterlegt und von vielen Hosts genutzt. Änderst du die Identität, folgt jeder Host, der sie verwendet.
- Standard: Keine.
- Achtung: Eine Identität gilt als Ganzes: Benutzername, Passwort oder Schlüssel, die am selben Host oder an der Gruppe eingegeben sind, werden ignoriert, solange eine Identität gewählt ist.
Schlüssel
Abschnitt betitelt „Schlüssel“host.key
Der private Schlüssel, mit dem sich dieser Host statt mit einem Passwort anmeldet. Der Server muss seiner öffentlichen Hälfte bereits vertrauen (Schlüsselbund › Auf Host installieren erledigt das). Von Sternway wird nur dieser eine Schlüssel angeboten. Auf dem Desktop kann Einstellungen › Verbindungen & SSH die Schlüssel des SSH-Agents des Computers hinzufügen.
- Standard: Keiner.
- Achtung: Ein mit Passphrase geschützter Schlüssel fragt bei Verwendung nach der Passphrase.
Meine persönlichen Zugangsdaten verwenden
Abschnitt betitelt „Meine persönlichen Zugangsdaten verwenden“host.personalCredentials · Nur Desktop
Für einen Host in einem geteilten Team-Tresor: Melde dich mit deinem eigenen Benutzernamen, Passwort und Schlüssel aus deinem persönlichen Tresor an statt mit dem, was das Team am Host gespeichert hat. Jedes Teammitglied nutzt dann sein eigenes Konto.
- Standard: Aus.
- Achtung: Sind für diesen Host keine persönlichen Zugangsdaten gespeichert, wirst du beim Verbinden danach gefragt.
Host: erweitert
Abschnitt betitelt „Host: erweitert“Wo: Der Host- oder Gruppeneditor › Erweitert (Desktop); die unteren Abschnitte des Formulars (Smartphone).
Start-Snippet
Abschnitt betitelt „Start-Snippet“host.startupSnippet · Nur Desktop
Ein gespeichertes Snippet, das in die Sitzung getippt wird, gefolgt von Enter, sobald sie bereit wirkt (siehe Startbefehl), und bei jeder erneuten Verbindung wieder. Es wird statt des Startbefehls verwendet, wenn beide gesetzt sind; wurde das Snippet inzwischen gelöscht, wird der Startbefehl verwendet.
- Standard: Keins.
- Achtung: Es wird an der Cursorposition eingetippt, als hättest du es getippt, und erscheint daher im Terminal und im Shell-Verlauf. Da es nach einer erneuten Verbindung wieder läuft, verwende ein Snippet, das sich gefahrlos wiederholen lässt.
Startbefehl
Abschnitt betitelt „Startbefehl“host.startupCommand
Ein Befehl, der in die Sitzung getippt wird, gefolgt von Enter, sobald sie bereit wirkt: an der ersten Eingabeaufforderung, wenn die Shell-Integration eine meldet, sonst nach einer halben Sekunde ohne Ausgabe. Er wird einmal pro Verbindung getippt, also bei jeder erneuten Verbindung wieder, ob automatisch oder über die Schaltfläche „Erneut verbinden“, da eine erneute Verbindung eine neue Shell startet. Nutze ihn, um in einem Ordner zu landen oder dich an tmux anzuhängen. Bis zu 4096 Zeichen.
- Standard: Keiner.
- Beispiel: cd /srv/app && tmux attach || tmux
- Achtung: Er wird getippt, nicht separat ausgeführt: Bei einer langsamen Anmeldung und bei Telnet an der Anmeldeaufforderung kann er in dem landen, was gerade auf dem Bildschirm ist, und er erscheint im Terminal und im Shell-Verlauf. Da er nach einer erneuten Verbindung wieder läuft, verwende einen Befehl, der sich gefahrlos wiederholen lässt. Schreib niemals ein Passwort hinein.
host.proxy
Erreiche den Server über einen Proxyserver statt direkt, wie es manche Firmennetze verlangen. Unterstützt werden SOCKS5-, SOCKS4- und HTTP-Proxys (ein HTTP-Proxy wird mit seiner CONNECT-Methode gebeten, einen einfachen Tunnel zu öffnen, er muss das also für den Port des Servers erlauben). Mit Jump-Hosts führt der Proxy nur die Verbindung zum ersten.
- Standard: Keiner (direkt verbinden).
- Achtung: Mosh kann auf einem Host mit Proxy nicht verwendet werden.
Proxy-Host
Abschnitt betitelt „Proxy-Host“host.proxyHost
Die Adresse des Proxyservers: ein Hostname oder eine IP-Adresse.
- Beispiel: proxy.corp.example.com
Proxy-Port
Abschnitt betitelt „Proxy-Port“host.proxyPort
Der Port, auf dem der Proxy lauscht, 1 bis 65535.
- Standard: 1080 wird unabhängig vom Proxytyp eingetragen; das ist der übliche SOCKS-Port, ändere ihn also für einen HTTP-Proxy (oft 3128 oder 8080).
- Beispiel: 1080 für SOCKS, 3128 oder 8080 für HTTP
Proxy-Benutzername
Abschnitt betitelt „Proxy-Benutzername“host.proxyUsername
Der Benutzername, den der Proxy selbst verlangt, falls er einen verlangt. SOCKS4 hat keine echte Anmeldung: Es wird nur ein Name gesendet, seine „User-ID“, die die meisten SOCKS4-Proxys ignorieren. Es ist nicht dein Konto auf dem Server.
- Standard: Keiner.
Proxy-Passwort
Abschnitt betitelt „Proxy-Passwort“host.proxyPassword
Das Passwort, das der Proxy selbst verlangt. SOCKS4 kennt keine Passwörter, daher ist das Feld dafür ausgeblendet.
- Standard: Keins.
- Achtung: Ein HTTP-Proxy erhält es nur einfach kodiert, lesbar für jeden auf dem Weg zum Proxy. Es wird wie das Host-Passwort gespeichert und synchronisiert.
Host-Kette (Jump-Hosts)
Abschnitt betitelt „Host-Kette (Jump-Hosts)“host.jumpHosts
Server, über die der Weg der Reihe nach führt, wenn das Ziel nicht direkt erreichbar ist (ssh nennt das ProxyJump; ein solcher Server heißt oft Bastion). Die App meldet sich beim ersten mit dessen eigener gespeicherter Anmeldung an, tunnelt durch ihn zum nächsten und so weiter bis zu diesem Host. Bis zu 8, jeweils ein gespeicherter Host aus demselben Tresor. Der eigene Proxy eines Jump-Hosts wird ignoriert: Nur der Proxy dieses Hosts wird verwendet, um den ersten Jump-Host zu erreichen. Die eigenen Jump-Hosts des ersten Jump-Hosts werden ebenfalls durchlaufen.
- Standard: Direkte Verbindung oder die Kette der Gruppe.
- Beispiel: bastion → dieser Host
- Achtung: Jeder Jump-Host kann sehen, wohin du dich als Nächstes verbindest. Mosh kann nicht über Jump-Hosts verwendet werden, und Telnet ignoriert sie.
Umgebungsvariablen
Abschnitt betitelt „Umgebungsvariablen“host.env
Benannte Werte, die der entfernten Shell beim Start übergeben werden, etwa LANG oder eine Variable, die deine Skripte lesen. Ein Name besteht aus Buchstaben, Ziffern und Unterstrichen und beginnt nicht mit einer Ziffer; ein Wert hat bis zu 4096 Zeichen. Sie werden nur für SSH-Sitzungen gesendet. Die nächstgelegene Ebene, die welche setzt, gilt als Ganzes: Die Liste eines Hosts ersetzt die seiner Gruppe und wird nicht mit ihr zusammengeführt.
- Standard: Keine.
- Beispiel: LANG = en_US.UTF-8
- Achtung: Die meisten Server akzeptieren nur die Namen, die in ihren SSH-Servereinstellungen nach AcceptEnv stehen (sshd_config; oft nur LANG und LC_*), und verwerfen den Rest stillschweigend. Werte werden als normale Einstellungen gespeichert und synchronisiert, also keine Geheimnisse hineinschreiben.
Verbindungs-Timeout (s)
Abschnitt betitelt „Verbindungs-Timeout (s)“host.connectTimeout · Nur Desktop
Wie viele Sekunden auf die Antwort des Servers und dann auf den Anmelde-Handshake gewartet wird, bevor aufgegeben wird. Erhöhe den Wert für eine langsame oder weit entfernte Verbindung. 1 bis 300.
- Standard: 15 Sekunden (Einstellungen › Verbindungen & SSH).
Automatisch neu verbinden
Abschnitt betitelt „Automatisch neu verbinden“host.autoReconnect
Bricht eine Sitzung unerwartet ab, wird ohne Rückfrage erneut verbunden: 5 schnelle Versuche mit 1, 2, 4, 8 und 16 Sekunden Wartezeit, danach ein Versuch pro Minute, solange ihr Tab offen ist, und sofort, wenn sich das Netzwerk ändert oder das Gerät aufwacht („Nicht mehr versuchen“ beendet das). Laufende Portweiterleitungen über diesen Host versuchen es ebenfalls erneut: bis zu 10 Versuche in etwa 5 Minuten, und sofort, wenn sich das Netzwerk ändert. Es stoppt sofort, wenn der Host-Schlüssel des Servers abgelehnt wurde oder du die Anmeldung abgebrochen hast; eine Weiterleitung, die erneut eine Freigabe braucht, wartet darauf.
- Standard: An (Einstellungen › Verbindungen & SSH).
- Achtung: Eine erneute Verbindung meldet sich wieder mit einem Passwort an, das du vorher während dieser Laufzeit der App eingegeben hast (auf dem Smartphone: bis die App sperrt, du dich abmeldest oder sie für die Dauer der automatischen Sperre im Hintergrund war). Eine Schlüssel-Passphrase wird nur wiederverwendet, wenn du bei der Abfrage „Merken“ angehakt hast.
Keepalive-Intervall (s)
Abschnitt betitelt „Keepalive-Intervall (s)“host.keepaliveInterval · Nur Desktop
Ein Keep-Alive ist eine winzige „Bist du noch da?“-Nachricht, die gesendet wird, während die Verbindung ruhig ist, damit Router und Firewalls sie nicht trennen und eine tote Verbindung bemerkt wird. Dies ist die Anzahl Sekunden dazwischen; 0 schaltet sie aus. 0 bis 3600.
- Standard: 30 Sekunden (Einstellungen › Hintergrund & Keep-Alive).
Keepalive max. verpasst
Abschnitt betitelt „Keepalive max. verpasst“host.keepaliveCountMax · Nur Desktop
Wie viele Keep-Alive-Nachrichten in Folge unbeantwortet bleiben dürfen, bevor die Verbindung als verloren gilt und geschlossen wird. Mit den Standardwerten sind das etwa anderthalb Minuten. 1 bis 100.
- Standard: 3 (Einstellungen › Hintergrund & Keep-Alive).
Agent-Weiterleitung
Abschnitt betitelt „Agent-Weiterleitung“host.agentForwarding
Lässt den Server, auf dem du bist, deine Schlüssel zur Anmeldung bei einem weiteren Server nutzen (zum Beispiel git pull von GitHub auf dem Server), ohne dass die privaten Schlüssel dieses Gerät verlassen. „Anmeldeschlüssel“ bietet nur den Schlüssel an, mit dem du dich angemeldet hast; „Alle Schlüssel“ bietet die Schlüssel dieses Hosts und seiner Jump-Hosts an. Der Server kann Signaturen anfordern, die Schlüssel aber nie lesen. Es wird nur in Terminalsitzungen angefordert, nicht für SFTP oder Portweiterleitungen. „Anmeldeschlüssel“ bietet nichts an, wenn du dich mit einem Passwort oder einem Schlüssel des SSH-Agents dieses Computers angemeldet hast. „Alle Schlüssel“ lässt Sicherheitsschlüssel (Hardware) und verschlüsselte Schlüssel aus, deren Passphrase weder gespeichert noch gemerkt ist; nach ihnen wird nicht gefragt.
- Standard: Aus (Einstellungen › Verbindungen & SSH).
- Achtung: Solange du verbunden bist, kann sich jeder mit Administratorrechten auf diesem Server mit den weitergeleiteten Schlüsseln anderswo als du anmelden. Aktiviere es nur für Server, denen du vertraust.
Veraltete Algorithmen erlauben
Abschnitt betitelt „Veraltete Algorithmen erlauben“host.legacyAlgorithms · Nur Desktop
Bietet zusätzlich alte Verschlüsselungsverfahren an (SHA-1-Schlüsselaustausch und -Signaturen, CBC-Chiffren, ssh-rsa-Host-Schlüssel), die modernes SSH aufgegeben hat. Schalte es nur ein, wenn ein alter Router, Switch oder Server die Verbindung ohne sie verweigert.
- Standard: Aus (Einstellungen › Verbindungen & SSH › Erweitert).
- Achtung: Diese Verfahren sind schwach. Lass es für alles, was aus dem Internet erreichbar ist, ausgeschaltet.
Post-Quanten-Schlüsselaustausch
Abschnitt betitelt „Post-Quanten-Schlüsselaustausch“host.pqc · Nur Desktop
Bevorzugt ein neueres Verfahren zur Vereinbarung der Sitzungsschlüssel (mlkem768x25519), das auch einem künftigen Quantencomputer standhält, sofern der Server es unterstützt; die üblichen Verfahren werden danach weiterhin angeboten. Schalte es nur aus, wenn sich ein Server damit fehlerhaft verhält.
- Standard: An (Einstellungen › Verbindungen & SSH › Erweitert).
SFTP-Startpfad
Abschnitt betitelt „SFTP-Startpfad“host.sftpStartPath · Nur Desktop
Der Ordner, in dem sich der Dateibrowser für diesen Host beim ersten Mal öffnet. Danach merkt sich die App den zuletzt besuchten Ordner.
- Standard: Dein Home-Ordner auf dem Server.
- Beispiel: /var/www
Terminal-Design
Abschnitt betitelt „Terminal-Design“host.theme
Die Farben der Terminals dieses Hosts, damit ein Produktionsserver anders aussieht als ein Testserver. Ein in einer Sitzung gewähltes Design hat für diese Sitzung weiterhin Vorrang.
- Standard: Das Terminal-Design der App (Einstellungen › Darstellung).
Schriftart
Abschnitt betitelt „Schriftart“host.fontFamily · Nur Desktop
Die Schriftart der Terminals dieses Hosts: eine auf diesem Computer installierte oder eine mitgelieferte (JetBrains Mono, Fira Code, Cascadia Code, Source Code Pro, Hack).
- Standard: Die Schrift aus Einstellungen › Terminal (JetBrains Mono).
Schriftgröße
Abschnitt betitelt „Schriftgröße“host.fontSize · Nur Desktop
Die Größe des Terminaltexts für diesen Host in Pixeln, 6 bis 72.
- Standard: Die Größe aus Einstellungen › Terminal (14).
Zeilenhöhe
Abschnitt betitelt „Zeilenhöhe“host.lineHeight · Nur Desktop
Der Platz, den jede Terminalzeile einnimmt, als Vielfaches der Schriftgröße, 0,8 bis 2. Größer ist luftiger; 1 ist eng.
- Standard: Der Wert aus Einstellungen › Terminal (1,2).
Zeichensatz
Abschnitt betitelt „Zeichensatz“host.charset · Nur Desktop
Die Zeichenkodierung, die der Server verwendet. Fast jedes moderne System nutzt UTF-8; wähle eine andere nur, wenn Umlaute oder Rahmenzeichen auf einem alten System als Zeichensalat erscheinen. Die App wandelt in beide Richtungen um; auf dem Server wird nichts geändert.
- Standard: UTF-8.
- Beispiel: ISO-8859-1, windows-1252, Shift_JIS
Terminaltyp
Abschnitt betitelt „Terminaltyp“host.termType · Nur Desktop
Als was sich die App gegenüber dem Server ausgibt, über die Variable TERM. Programme entscheiden danach, welche Farben und Tasten funktionieren. Ändere es nur, wenn sich ein Vollbildprogramm (vi, top) auf einem alten System fehlerhaft verhält.
- Standard: xterm-256color (Einstellungen › Terminal › Erweitert).
- Beispiel: vt100 für sehr alte Geräte
Backspace sendet
Abschnitt betitelt „Backspace sendet“host.backspace · Nur Desktop
Welches Zeichen die Backspace-Taste sendet. Fast jedes System erwartet DEL; wechsle zu Ctrl-H, wenn Backspace ^? ausgibt oder nicht löscht. Ctrl+Backspace sendet das jeweils andere.
- Standard: DEL.
Telnet-Port
Abschnitt betitelt „Telnet-Port“host.telnetPort · Nur Desktop
Der Port, der verwendet wird, wenn du diesen Host mit Telnet statt SSH öffnest, 1 bis 65535. Telnet hat keine Anmeldung, die die App für dich beantworten kann: Der Server fragt im Terminal nach Benutzername und Passwort, und du gibst sie dort ein. Die App speichert keines von beiden.
- Standard: 23.
- Achtung: Telnet ist nicht verschlüsselt: Alles Eingetippte, auch Passwörter, kann im Netzwerk mitgelesen werden.
Mosh aktivieren
Abschnitt betitelt „Mosh aktivieren“host.moshEnabled · Nur Desktop
Mosh ist eine andere Art, ein Terminal bei schlechter oder wechselnder Verbindung am Leben zu halten: Es übersteht Netzwechsel und Ruhezustand und zeigt Getipptes sofort an. Die App meldet sich trotzdem zuerst über SSH an und wechselt dann. Der Server braucht installiertes mosh-server und offene UDP-Ports, und dieser Computer braucht das Programm mosh-client (macOS und Linux; Mosh läuft nicht in der Windows-App). Die Smartphone-App kann Mosh nicht ausführen: Dort verbindet sich ein Host mit dieser Option über normales SSH.
- Standard: Aus.
- Achtung: Ein Host mit Jump-Hosts oder Proxy kann sich nicht verbinden, solange Mosh an ist, ebenso einer auf einem Computer ohne mosh-client: Auf dem Desktop gibt es keinen Rückfall auf SSH. Mosh-Sitzungen werden nicht im Sitzungslog aufgezeichnet und haben keine Autovervollständigung.
- Mehr: Weiterlesen (auf Englisch)
Mosh-Serverbefehl
Abschnitt betitelt „Mosh-Serverbefehl“host.moshServerCommand · Nur Desktop
Das Programm, das auf dem Server für Mosh gestartet wird. Setze es nur, wenn mosh-server dort nicht im PATH liegt. Gib nur den Programmnamen oder seinen vollständigen Pfad an, ohne Argumente.
- Standard: mosh-server.
- Beispiel: /usr/local/bin/mosh-server
- Mehr: Weiterlesen (auf Englisch)
Mosh-UDP-Portbereich
Abschnitt betitelt „Mosh-UDP-Portbereich“host.moshPortRange · Nur Desktop
Der UDP-Port oder Portbereich, den der Server für Mosh verwenden darf, geschrieben als LOW:HIGH mit Doppelpunkt. Passe ihn daran an, was die Firewall des Servers durchlässt.
- Standard: mosh-server überlassen (auf den meisten Systemen 60000 bis 61000).
- Beispiel: 60000:61000
- Mehr: Weiterlesen (auf Englisch)
Shell-Integration
Abschnitt betitelt „Shell-Integration“host.shellIntegration · Nur Desktop
Lässt die App erkennen, wo jeder Befehl in einer bash- oder zsh-Sitzung beginnt und endet; dadurch funktionieren „Läuft ein Befehl?“ und das Wiederherstellen eines Arbeitsbereichs. Dazu tippt sie beim Start der Sitzung ein kleines Skript in die Shell.
- Standard: Aus.
- Achtung: Es ändert die Prompt-Hooks dieser Shell-Sitzung und meldet jede ausgeführte Befehlszeile an die App zurück.
Autovervollständigung
Abschnitt betitelt „Autovervollständigung“host.autocomplete · Nur Desktop
Ob beim Tippen auf diesem Host Vorschläge erscheinen, auf dem Desktop und auf dem Smartphone. Ein Host kann sie nur ausschalten; sind Vorschläge unter Einstellungen › Terminal aus, kann dies sie nicht einschalten. Es blendet auf dem Desktop nicht das Angebot des gespeicherten Passworts bei einer Passwortabfrage aus.
- Standard: An, gemäß Einstellungen › Terminal.
Befehle und Optionen auf dem Host nachschlagen
Abschnitt betitelt „Befehle und Optionen auf dem Host nachschlagen“host.autocompleteHostLookup · Nur Desktop
Ob die Autovervollständigung diesen Host fragen darf, was er hat: installierte Befehle, die Optionen in Manpages und Werte wie Branches, Dienste und Dateinamen. Die Abfragen sind feste, rein lesende Befehle, die im Hintergrund über die eigene Verbindung der Sitzung laufen und nie ins Terminal getippt werden. Schalte es für einen Host aus, auf dem nichts ungefragt laufen darf; Vorschläge kommen dort dann aus deinem Verlauf, deinen Snippets und den integrierten Befehlsbeschreibungen. Die Smartphone-App folgt diesem Schalter ebenfalls.
- Standard: An, gemäß Einstellungen › Terminal.
- Achtung: Die Abfragen laufen als der Benutzer, mit dem du dich anmeldest, und erscheinen auf dem Host wie jeder andere Befehl.
Tab-Farbe
Abschnitt betitelt „Tab-Farbe“host.tabColor
Eine Farbmarkierung für diesen Host: Jede Sitzung und jeder SFTP-Tab zu ihm trägt die Farbe, ebenso seine Zeilen in Sitzungen und Hosts, sodass ein Host (oder eine Art, etwa Produktion) auf einen Blick von anderen zu unterscheiden ist. An einer Gruppe gesetzt, erhält jeder Host darin die Farbe, sofern er keine eigene setzt; „Keine“ an einem Host entfernt die Farbe der Gruppe. Ein einzelner offener Tab kann über sein Menü eine andere Farbe bekommen, ohne den Host zu ändern. Die Farbe wird mit dem Host synchronisiert; sie ist eine Markierung, kein Geheimnis.
- Standard: Keine oder die Farbe der Gruppe.
- Beispiel: Rot für die Gruppe Production, Grün für Staging.
Intelligente Hervorhebung
Abschnitt betitelt „Intelligente Hervorhebung“host.smartHighlight
Ob Sternway einfärbt, was es in der normalen Ausgabe dieses Hosts erkennt (Adressen, Pfade, Größen, Log-Level, Dateilisten). Schalte es für ein Gerät aus, dessen Ausgabe falsch erkannt wird, oder für einen Host ein, während es in den Einstellungen aus ist. Welche Arten eingefärbt werden, legst du unter Einstellungen › Terminal fest. Die eigenen Farben von Programmen werden nie geändert, und das Kopieren ist nicht betroffen.
- Standard: Gemäß Einstellungen › Terminal.
Benachrichtigen
Abschnitt betitelt „Benachrichtigen“host.notify
Worüber dich jede Sitzung zu diesem Host benachrichtigt, ohne dass du jedes Mal fragen musst. Dieselben Optionen gibt es im Menü einer Sitzung („Benachrichtige mich…“), wo sie nur für diese Sitzung gelten. Ein Befehl zählt, sobald er die unter Einstellungen › Benachrichtigungen festgelegte Zeit lief; „Ausgabe nach Stille“ bedeutet 30 Sekunden ohne Ausgabe; „wenn es still wird“ bedeutet keine Ausgabe für die unter Einstellungen › Benachrichtigungen festgelegten Minuten, einmal pro Ruhephase; „eine Zeile passt“ nutzt deine Regeln unter Einstellungen › Benachrichtigungen; „ein Coding-Agent braucht eine Eingabe“ erkennt die Fragen, die Coding-Agents auf der Kommandozeile stellen, bevor sie handeln; „das Programm sendet eine Benachrichtigung“ ist eine Benachrichtigung, die das entfernte Programm selbst anfordert (OSC 9, 777 oder 99). An einer Gruppe gesetzt, benachrichtigt jeder Host darin genauso, sofern er nichts Eigenes festlegt.
- Standard: Nichts: Eine Sitzung benachrichtigt nur über das, worum du sie bittest.
- Achtung: Eine Benachrichtigung kann eine Zeile der Ausgabe des Hosts zeigen. Ein Smartphone benachrichtigt nur, solange die App läuft oder im Hintergrund aktiv gehalten wird.
Sitzungsprotokollierung
Abschnitt betitelt „Sitzungsprotokollierung“host.sessionLogging · Nur Desktop
Ob die Ausgabe der Sitzungen dieses Hosts in Logs aufgezeichnet wird. Aufgezeichnet wird nur, wenn das Logging auch für den Tresor des Hosts an ist (Einstellungen › Logs). Schalte es für einen Host aus, dessen Ausgabe nie gespeichert werden soll. Die Smartphone-App zeichnet genauso auf und folgt diesem Schalter. Ein Log bleibt auf dem Gerät, das es aufgezeichnet hat, sofern dort „Sitzungslogs synchronisieren“ nicht an ist.
- Standard: An, wenn der Tresor Logs aufzeichnet.
- Achtung: Ein Log enthält alles, was im Terminal angezeigt wurde, auch jedes Geheimnis, das ein Befehl ausgegeben hat.
Sitzungen aufzeichnen
Abschnitt betitelt „Sitzungen aufzeichnen“host.recordSessions · Nur Desktop
Zeichnet jede Sitzung zu diesem Host von Anfang an mit Zeitablauf auf, damit du sie später unter Aufzeichnungen abspielen kannst: was das Terminal zeigte und jede Größenänderung, als asciicast-Datei. Eine Aufzeichnung bleibt auf diesem Gerät, verschlüsselt mit den übrigen Daten der App, und wird nie synchronisiert oder hochgeladen. Ein rotes „Aufzeichnung“-Abzeichen erscheint an der Sitzung, solange sie läuft. An einer Gruppe gesetzt, zeichnet jeder Host darin auf, sofern er nichts anderes festlegt. Eine einzelne Sitzung kann auch über ihr Menü aufgezeichnet werden.
- Standard: Aus.
- Achtung: Eine Aufzeichnung enthält alles, was im Terminal angezeigt wurde, auch jedes Geheimnis, das ein Befehl ausgegeben hat.
- Mehr: Weiterlesen (auf Englisch)
Auch meine Eingaben aufzeichnen
Abschnitt betitelt „Auch meine Eingaben aufzeichnen“host.recordInput · Nur Desktop
Bei aktivem „Sitzungen aufzeichnen“ wird auch deine Eingabe in der Aufzeichnung behalten. Was du nach einer Abfrage tippst, die die App erkennt (eine Zeile, die auf „password:“, „passphrase:“, „PIN:“ und Ähnliches endet, auch in den gängigen europäischen Sprachen, Russisch, Japanisch, Chinesisch und Koreanisch, selbst wenn das Programm pro Taste * anzeigt), wird bis Enter, Ctrl-C oder Ctrl-D nie behalten.
- Standard: Aus: Nur was das Terminal anzeigte, wird aufgezeichnet.
- Achtung: Getippter Text kann Geheimnisse enthalten, die die App nicht als solche erkennt: ein in eine Befehlszeile eingefügtes Passwort, ein Token, eine anders formulierte Abfrage („Verification code:“, eine Sprache, die die Dokumentation nicht aufführt) oder eine, die nicht am Ende der letzten Zeile steht. Diese würden aufgezeichnet.
- Mehr: Weiterlesen (auf Englisch)
CPU-, Speicher- und Festplattenleiste
Abschnitt betitelt „CPU-, Speicher- und Festplattenleiste“host.metricsStrip · Nur Desktop
Zeigt über den Terminals dieses Hosts eine schmale Leiste mit CPU-Auslastung, belegtem Arbeitsspeicher und Füllstand des Root-Dateisystems. Alle 5 Sekunden, solange das Terminal sichtbar ist, führt Sternway einen kurzen, rein lesenden Befehl (/proc und df unter Linux; sysctl, vm_stat und ps unter macOS und FreeBSD) über einen separaten Kanal der Verbindung aus: Nichts wird in deine Shell getippt, nichts erscheint in ihrem Verlauf. Sie pausiert, solange der Tab verborgen ist, und bleibt auf einem System, das sie nicht auslesen kann, ausgeblendet.
- Standard: Aus.
- Achtung: Ein Server, der nur einen Kanal pro Verbindung erlaubt, kann sie nicht neben deiner Shell ausführen: Die Leiste bleibt dann leer.
Diese Sitzung auf dem Server halten
Abschnitt betitelt „Diese Sitzung auf dem Server halten“host.tmuxAttach · Nur Smartphone
Eine SSH-Sitzung zu diesem Host läuft auf dem Server in tmux: Beim Verbinden hängt sie sich an die unten benannte tmux-Sitzung an und legt sie an, falls sie fehlt. Was darin läuft, läuft weiter, wenn das Smartphone schläft, das Netz verliert oder die App schließt, und eine erneute Verbindung, automatisch oder über „Erneut verbinden“, hängt sich wieder an, sodass der Bildschirm so zurückkommt, wie du ihn verlassen hast. Es funktioniert über Jump-Hosts. Vor dem Anhängen prüft Sternway über einen eigenen Kanal, ob tmux installiert ist; falls nicht, wirst du informiert und die Sitzung läuft als normale Shell weiter.
- Standard: Aus.
- Beispiel: Ein langer Build oder ein Coding-Agent, den du auf dem Smartphone startest und später wieder ansiehst.
- Achtung: Der Attach-Befehl wird in die Shell getippt, erscheint also auf dem Bildschirm und, sofern deine Shell Zeilen mit führendem Leerzeichen nicht auslässt, im Verlauf. Der Startbefehl wird nur beim Anlegen in die tmux-Sitzung getippt, nicht bei jedem Anhängen. Verlässt du tmux (Detach oder Beenden des letzten Fensters), landest du in der normalen Shell. Nicht für Telnet oder Mosh verwendet.
tmux-Sitzungsname
Abschnitt betitelt „tmux-Sitzungsname“host.tmuxSession · Nur Smartphone
Die tmux-Sitzung, an die angehängt wird. Bleibt das Feld leer, wird der Name aus der Bezeichnung des Hosts gebildet („web-01 (prod)“ wird zu web-01-prod). Buchstaben, Ziffern, - und _, bis zu 64 Zeichen. Zwei Hosts auf demselben Server mit demselben Namen teilen sich eine tmux-Sitzung.
- Standard: Aus der Bezeichnung des Hosts gebildet.
- Beispiel: build
MAC-Adresse für Wake-on-LAN
Abschnitt betitelt „MAC-Adresse für Wake-on-LAN“host.wakeMac
Die Hardware-Adresse der Netzwerkkarte, die diesen Rechner aufweckt. Ist sie gesetzt, hat der Host die Aktion Aufwecken: Dieses Gerät sendet das „Magic Packet“, das einen schlafenden oder ausgeschalteten Rechner starten lässt, wenn in seiner Firmware Wake-on-LAN aktiviert ist. Das Paket geht von diesem Computer oder Telefon aus in das Netzwerk, in dem es ist: Kein Server ist beteiligt, es erreicht also einen Rechner im selben lokalen Netzwerk (oder einen, dessen Router es weiterleitet).
- Standard: Keine: keine Aktion Aufwecken.
- Beispiel: 52:54:00:ab:cd:ef (auch 52-54-00-ab-cd-ef oder 5254.00ab.cdef)
- Achtung: Du findest sie auf dem Rechner selbst (ip link unter Linux, ipconfig /all unter Windows), solange er wach ist. Ein Rechner ohne Strom oder mit abgeschalteter Karte kann das Paket nicht empfangen.
Broadcast-Adresse für Wake-on-LAN
Abschnitt betitelt „Broadcast-Adresse für Wake-on-LAN“host.wakeAddress
Wohin das Magic Packet gesendet wird. Der Standard erreicht jeden Rechner im eigenen Netzwerksegment dieses Geräts. Nimm die Broadcast-Adresse des anderen Netzwerks (zum Beispiel 192.168.20.255), wenn der Rechner in einem anderen Subnetz liegt, dessen Router sie weiterleitet, oder die eigene Adresse des Rechners, wenn ein Router ihn im Schlaf erreichbar hält.
- Standard: 255.255.255.255 (dieses Netzwerk).
- Beispiel: 192.168.1.255
Wake-on-LAN-Port
Abschnitt betitelt „Wake-on-LAN-Port“host.wakePort
Der UDP-Port, an den das Magic Packet gesendet wird. Netzwerkkarten hören unabhängig vom Port; manche Router leiten nur Port 7 oder 9 weiter. 1 bis 65535.
- Standard: 9.
Vor dem Verbinden aufwecken
Abschnitt betitelt „Vor dem Verbinden aufwecken“host.wakeBeforeConnect
Jede Verbindung zu diesem Host (Terminal, Dateien, Portweiterleitungen) sendet zuerst das Magic Packet, wartet dann, bis der SSH-Port des Hosts antwortet, höchstens die Wartezeit unten, und meldet sich dann an. Das Prüfen des Ports öffnet und schließt nur eine Verbindung zu ihm; es meldet sich nie an. Ein Host, der schon wach ist, antwortet sofort, dann kostet es also nichts.
- Standard: Aus.
- Achtung: Bei einem Host, der über einen Jump-Host oder einen Proxy erreicht wird, kann der Port von hier aus nicht geprüft werden: Die App wartet die ganze Zeit, bevor sie verbindet.
Auf das Aufwachen warten (s)
Abschnitt betitelt „Auf das Aufwachen warten (s)“host.wakeWaitSec
Wie lange „Vor dem Verbinden aufwecken“ wartet, bis der Host antwortet, bevor trotzdem die Anmeldung versucht wird. Ein Rechner, der aus dem ausgeschalteten Zustand startet, braucht länger als einer, der aus dem Ruhezustand aufwacht. 5 bis 600.
- Standard: 60 Sekunden.
Port-Knocking
Abschnitt betitelt „Port-Knocking“host.knockSequence
Ports, an die vor jeder Verbindung zu diesem Host der Reihe nach „angeklopft“ wird, für einen Server, dessen Firewall (knockd und ähnliche) den SSH-Port geschlossen hält, bis sie diese sieht. Trenne die Ports durch Leerzeichen; hänge :udp an einen Port an, an den per UDP geklopft wird (Standard ist TCP). Ein TCP-Klopfzeichen öffnet eine Verbindung und schließt sie sofort; ein UDP-Klopfzeichen ist ein leeres Paket. Bis zu 16 Ports. Wird dieser Host über einen Jump-Host erreicht, sendet der Jump-Host die Klopfzeichen.
- Standard: Keine: Der Host wird direkt angewählt.
- Beispiel: 7000 8000:udp 9000
- Achtung: Hinter einem Jump-Host kann nur per TCP geklopft werden, und UDP-Klopfzeichen können nicht über einen Proxy laufen. Eine Klopfsequenz ist kein Passwort: Wer das Netzwerk zwischen dir und dem Server beobachtet, kann sie sehen.
Pause zwischen den Klopfzeichen (ms)
Abschnitt betitelt „Pause zwischen den Klopfzeichen (ms)“host.knockDelayMs
Wie lange nach jedem Klopfzeichen gewartet wird, und nach dem letzten vor dem Verbinden, damit die Firewall mitkommt. 0 bis 10000 Millisekunden.
- Standard: 200 ms.
Wo: Hosts › Neue Gruppe, oder Bearbeiten an einer Gruppe.
group.name
Der Name des Ordners in deiner Hostliste. Erforderlich, bis zu 256 Zeichen.
- Beispiel: Produktion
Übergeordnete Gruppe
Abschnitt betitelt „Übergeordnete Gruppe“group.parent
Ordnet diese Gruppe in eine andere ein. Ihre Hosts erben dann auch die Einstellungen der übergeordneten Gruppen. Eine Gruppe kann nicht in sich selbst oder eine ihrer Untergruppen.
- Standard: Keine (oberste Ebene).
Hosts von einem Cloud-Anbieter synchronisieren
Abschnitt betitelt „Hosts von einem Cloud-Anbieter synchronisieren“group.cloudEnable · Nur Desktop
Hält diese Gruppe mit deinen laufenden Cloud-Servern gefüllt: Für jede Instanz wird ein Host angelegt, seine Adresse aktualisiert, wenn sie sich ändert, und der Host entfernt, wenn die Instanz weg ist. Die App liest nur die Instanzliste; beim Anbieter ändert sie nichts.
- Standard: Aus.
- Achtung: Der Host einer gestoppten oder beendeten Instanz wird bei der nächsten Aktualisierung gelöscht, samt aller Änderungen, die du daran vorgenommen hast.
Anbieter
Abschnitt betitelt „Anbieter“group.cloudProvider · Nur Desktop
Der Clouddienst, aus dem Instanzen gelesen werden. Derzeit funktioniert nur AWS EC2; die anderen sind als „demnächst“ aufgeführt.
- Standard: AWS EC2.
group.cloudRegion · Nur Desktop
Die eine Region des Anbieters, deren Instanzen aufgeführt werden. Für mehrere Regionen lege je eine Gruppe an.
- Beispiel: us-east-1 oder eu-west-2
Namensfilter
Abschnitt betitelt „Namensfilter“group.cloudFilter · Nur Desktop
Nur Instanzen, deren Name-Tag passt, werden hinzugefügt. Der Text wird AWS als Filter auf das Name-Tag übergeben: Der ganze Name muss passen, Groß-/Kleinschreibung zählt, * steht für beliebig viele Zeichen und ? für genau eines. „web“ findet also nur eine Instanz namens genau web, und „web-*“ findet web-1 und web-eu-2. Ist ein Filter gesetzt, werden Instanzen ohne Name-Tag ausgelassen. Lass das Feld leer für alle laufenden oder startenden Instanzen in der Region.
- Standard: Leer (alle Instanzen).
- Beispiel: web-*
Aktualisieren alle (Minuten)
Abschnitt betitelt „Aktualisieren alle (Minuten)“group.cloudRefresh · Nur Desktop
Wie oft die Instanzliste neu gelesen wird, solange die App geöffnet ist, 1 bis 1440 Minuten.
- Standard: 60.
Access-Key-ID
Abschnitt betitelt „Access-Key-ID“group.cloudAccessKeyId · Nur Desktop
Die öffentliche Hälfte eines AWS-Zugriffsschlüssels, der EC2-Instanzen auflisten darf. Lass beide Schlüsselfelder leer, um die bereits gespeicherten zu behalten.
- Beispiel: AKIA…
- Achtung: Wird nur auf diesem Gerät aufbewahrt: Er wird nie synchronisiert oder mit deinem Team geteilt, daher braucht jedes Gerät, das synchronisieren soll, einen eigenen.
Secret Access Key
Abschnitt betitelt „Secret Access Key“group.cloudSecretAccessKey · Nur Desktop
Die geheime Hälfte dieses AWS-Zugriffsschlüssels, mit der die Anfrage nach der Instanzliste signiert wird.
- Achtung: Wird nur auf diesem Gerät aufbewahrt und nie wieder angezeigt. Verwende einen Schlüssel, der nur EC2 lesen darf, nicht den Hauptschlüssel deines Kontos.
Sitzungstoken
Abschnitt betitelt „Sitzungstoken“group.cloudSessionToken · Nur Desktop
Nur für temporäre AWS-Zugangsdaten (aus SSO oder einer übernommenen Rolle), die aus drei Teilen bestehen. Lass es für einen gewöhnlichen Zugriffsschlüssel leer.
- Standard: Keins.
Hosts: Schnellverbindung, Verschieben und Tags
Abschnitt betitelt „Hosts: Schnellverbindung, Verschieben und Tags“Wo: Der Bildschirm Hosts.
Schnellverbindung
Abschnitt betitelt „Schnellverbindung“quickConnect.target
Einmal verbinden, ohne einen Host zu speichern. Gib die Adresse ein, optional mit Benutzername vor @ und Port nach einem Doppelpunkt, oder füge einen ssh://-, sftp://- oder telnet://-Link oder einen „ssh“-Befehl ein. Aus einem Befehl werden Benutzer (-l), Port (-p) und Jump-Hosts (-J) übernommen; alle anderen Optionen, ein auf dem Host auszuführender Befehl und ein Passwort in einem Link nicht, und du erfährst, welche. Nichts Eingefügtes wird ausgeführt. Es gelten die App-Standardwerte aus den Einstellungen: keine Gruppe, kein Schlüssel, kein Proxy.
- Standard: Port 22; fehlt der Benutzername, wirst du danach gefragt.
- Beispiel: root@203.0.113.10:2222, oder: ssh -p 2222 -J jump@bastion deploy@web-01
Bezeichnung
Abschnitt betitelt „Bezeichnung“hostSave.label · Nur Desktop
Der Name, den die Schnellverbindung beim Speichern in deiner Hostliste erhält. Adresse, Port und Benutzername werden aus der Verbindung übernommen; ein eingegebenes Passwort wird nur mitgespeichert, wenn du das auch bei der Passwortabfrage angegeben hast. Du kannst den Host danach wie jeden anderen bearbeiten.
hostMove.group · Nur Desktop
Die Gruppe, in die die ausgewählten Hosts verschoben werden. Sie erben dann die Einstellungen dieser Gruppe. Hosts aus verschiedenen Tresoren können nur auf die oberste Ebene ihres eigenen Tresors.
- Standard: Keine Gruppe (oberste Ebene).
hostBulk.tags
Tags, die allen ausgewählten Hosts hinzugefügt oder entfernt werden. Klicke einmal auf einen Tag, um ihn allen hinzuzufügen (oder, wenn alle ihn haben, zu entfernen), erneut zum Umschalten, ein drittes Mal, um ihn unverändert zu lassen. Der Chip zeigt, welche Hosts ihn jetzt haben.
- Standard: Alle Tags unverändert.
Identität
Abschnitt betitelt „Identität“hostBulk.identity
Die gespeicherte Identität, mit der sich alle ausgewählten Hosts anmelden. „Erben“ entfernt die Identität jedes Hosts, sodass er sie von seiner Gruppe erbt; „Keine“ heißt keine Identität. Benutzername, Passwort und Schlüssel eines Hosts bleiben erhalten: Solange eine Identität gewählt ist, werden sie nicht verwendet, und sie gelten wieder, sobald die Identität entfernt wird.
- Standard: Unverändert lassen.
SSH-Port
Abschnitt betitelt „SSH-Port“hostBulk.port
Der SSH-Port aller ausgewählten Hosts: eine Zahl von 1 bis 65535 oder „Erben“, um den eigenen Port jedes Hosts zu entfernen, sodass er ihn von seiner Gruppe erbt (standardmäßig 22).
- Standard: Unverändert lassen.
- Achtung: Eine auf diesem Gerät freigegebene Portweiterleitung fragt erneut, wenn sich der Port ihres Hosts ändert, und die Geräte eines Teammitglieds zeigen die Änderung, bevor sie sich mit einem geteilten Host verbinden.
hostBulk.group
Die Gruppe, in die alle ausgewählten Hosts kommen, oder die oberste Ebene ihres Tresors. Sie erben dann die Einstellungen dieser Gruppe.
- Standard: Unverändert lassen.
Zieltresor
Abschnitt betitelt „Zieltresor“hostTransfer.vault · Nur Desktop
Der Tresor, in den die Auswahl verschoben oder kopiert wird. Ein Tresor ist eine separat verschlüsselte Sammlung: dein persönlicher oder einer, der mit einem Team geteilt ist.
- Achtung: Jeder mit Zugriff auf den Zieltresor kann dann sehen und nutzen, was du dort ablegst.
Zielgruppe
Abschnitt betitelt „Zielgruppe“hostTransfer.group · Nur Desktop
Die Gruppe des Zieltresors, in der die Einträge landen.
- Standard: (keine Gruppe).
Geteilte Zugangsdaten
Abschnitt betitelt „Geteilte Zugangsdaten“hostTransfer.linkMode · Nur Desktop
Was mit der Identität und dem Schlüssel geschieht, mit denen sich ein kopierter Host anmeldet. „Verknüpfungen kopieren“ kopiert sie ebenfalls in den Zieltresor. „Persönliche Zugangsdaten behalten“ (von deinem persönlichen Tresor in einen Team-Tresor) lässt sie aus der Kopie heraus und behält sie als deine eigenen persönlichen Zugangsdaten für diesen Host.
- Standard: Verknüpfungen kopieren.
- Achtung: Mit „Verknüpfungen kopieren“ erhält jeder, der den Zieltresor öffnen kann, den kopierten Schlüssel und das Passwort.
Tag-Name
Abschnitt betitelt „Tag-Name“tag.name
Benennt das Tag überall um, wo es verwendet wird. 1 bis 64 Zeichen; zwei Tags eines Tresors können nicht denselben Namen haben, unabhängig von Groß-/Kleinschreibung.
Übereinstimmung
Abschnitt betitelt „Übereinstimmung“hostFilter.match
Bei mehreren gewählten Tags: „Eines von“ zeigt Hosts, die mindestens eines davon haben, „Alle von“ nur Hosts, die alle haben.
- Standard: Eines von.
Hosts: Import aus Tailscale
Abschnitt betitelt „Hosts: Import aus Tailscale“Wo: Hosts › Neu › Aus Tailscale importieren….
Geräte lesen aus
Abschnitt betitelt „Geräte lesen aus“tailscale.source · Nur Desktop
„Tailscale dieses Computers“ fragt die hier laufende Tailscale-App (tailscale status --json), ohne Schlüssel: Sie listet die Geräte auf, die dieser Computer sehen kann. „Tailscale-API“ ist für einen Computer ohne Tailscale-App: Sie fragt api.tailscale.com mit einem API-Schlüssel.
- Standard: Tailscale dieses Computers.
Steuerungsserver
Abschnitt betitelt „Steuerungsserver“tailscale.controlUrl · Nur Desktop
Leer, um die Geräte von Tailscale zu lesen. Für ein Tailnet, das Headscale betreibt, die URL des Headscale-Servers (server_url seiner Konfiguration): Der Import liest dann stattdessen dessen Knotenliste (/api/v1/node) mit einem Headscale-API-Schlüssel, und kein Tailnet-Name ist nötig. Für den nächsten Import auf diesem Gerät gespeichert. „Dieser Computer“ braucht nichts davon: Der Tailscale-Client antwortet von dem Server, bei dem er angemeldet ist, auch von Headscale.
- Beispiel:
https://headscale.example.com - Achtung: Nur https:// (einfaches http:// nur zu diesem Rechner, localhost), ohne Benutzername oder Passwort darin: Der API-Schlüssel geht an diesen Server. Headscale nennt weder das System eines Knotens noch seinen MagicDNS-Namen oder ob er Tailscale SSH nutzt, daher werden diese Geräte mit ihrer Tailscale-Adresse hinzugefügt.
Tailnet
Abschnitt betitelt „Tailnet“tailscale.tailnet · Nur Desktop
Der Name deines Tailnets, wie ihn die Tailscale-Admin-Konsole unter Settings › General anzeigt (oft deine E-Mail-Domain oder ein Name wie example.github). Ein einzelner Bindestrich („-“) steht für das Tailnet des Schlüssels.
- Beispiel: example.com
API-Schlüssel
Abschnitt betitelt „API-Schlüssel“tailscale.apiKey · Nur Desktop
Ein API-Zugriffstoken aus der Tailscale-Admin-Konsole (Settings › Keys), beginnend mit tskey-api-; mit gesetztem Steuerungsserver ein Headscale-API-Schlüssel (headscale apikeys create). Er wird einmal an api.tailscale.com oder diesen Server gesendet, um die Geräteliste zu lesen, und nirgends gespeichert.
- Achtung: Wer den Schlüssel hat, kann dein Tailnet bis zu seinem Ablauf verwalten: Gib ihm eine kurze Laufzeit und widerrufe ihn nach dem Import.
Verbinden über
Abschnitt betitelt „Verbinden über“tailscale.address · Nur Desktop
Die Adresse, die jeder neue Host erhält: sein MagicDNS-Name (homelab.tail1234.ts.net), der weiter funktioniert, wenn das Gerät eine neue Tailscale-IP bekommt, oder seine Tailscale-IPv4-Adresse (100.x.y.z), die ohne MagicDNS funktioniert.
- Standard: MagicDNS-Name.
Als Tailscale SSH markieren
Abschnitt betitelt „Als Tailscale SSH markieren“tailscale.ssh · Nur Desktop
Für Geräte mit Tailscale SSH: Die Hosts erhalten das Tag „Tailscale SSH“ und kein Passwort und keinen Schlüssel. Tailscale prüft, wer du im Tailnet bist, und du meldest dich mit deinem Benutzernamen auf diesem Computer an.
- Standard: An, wenn jedes gewählte Gerät Tailscale SSH nutzt.
Hosts: Datei übertragen
Abschnitt betitelt „Hosts: Datei übertragen“Wo: Hosts › Hosts auswählen › Datei übertragen….
push.file · Nur Desktop
Die Datei auf diesem Computer, die auf jeden gewählten Host kopiert wird. Sie behält dort ihren Namen.
Ordner auf den Hosts
Abschnitt betitelt „Ordner auf den Hosts“push.remoteDir · Nur Desktop
Wohin die Datei auf jedem Host kommt. ~ ist der Home-Ordner des Benutzers, mit dem du dich anmeldest, und ein Pfad, der nicht mit / beginnt, gilt von dort aus. Der Ordner muss existieren.
- Standard: ~ (der Home-Ordner).
- Beispiel: ~/bin, /etc/myapp
Wenn die Datei schon vorhanden ist
Abschnitt betitelt „Wenn die Datei schon vorhanden ist“push.conflict · Nur Desktop
„Ersetzen“ überschreibt eine gleichnamige Datei im Ordner; „Überspringen“ lässt sie unverändert und markiert diesen Host als übersprungen.
- Standard: Ersetzen.
- Achtung: „Ersetzen“ überschreibt die Datei ohne Rückfrage auf jedem Host, der sie hat.
push.hosts · Nur Desktop
Die Hosts, an die die Datei geht: die angehakten, oder (Nach Tag-Regel) die Hosts mit den gewählten Tags beim Start der Übertragung. Es wird an vier Hosts gleichzeitig kopiert; jeder verbindet sich wie für SFTP und fragt, was er dort fragen würde.
Tag-Regel
Abschnitt betitelt „Tag-Regel“fleet.tagRule · Nur Desktop
Die Hosts mit einem der angehakten Tags oder mit allen. Die Regel wird beim Start der Aktion gelesen (und erneut bei einer Wiederholung), sodass ein seither getaggter Host dabei ist und ein seither ungetaggter nicht; die Zeile darunter sagt, welche Hosts sie jetzt wählt.
- Standard: Eines der Tags.
Hosts: Datei abholen
Abschnitt betitelt „Hosts: Datei abholen“Wo: Hosts › Mehr › Datei abholen….
Datei auf den Hosts
Abschnitt betitelt „Datei auf den Hosts“pull.remotePath · Nur Desktop
Die Datei, die von jedem gewählten Host geholt wird. ~ ist der Home-Ordner des Benutzers, als der du dich anmeldest, und ein Pfad, der nicht mit / beginnt, wird von dort aus gelesen. Die Kopie jedes Hosts kommt im ZIP in einen Ordner mit dem Namen des Hosts.
- Beispiel: /etc/os-release, ~/.bashrc
Größte abzuholende Datei
Abschnitt betitelt „Größte abzuholende Datei“pull.cap · Nur Desktop
Ein Host, dessen Datei größer ist, wird ausgelassen und als zu groß markiert, damit ein riesiges Log nicht die Festplatte füllt. Von drei Hosts wird gleichzeitig geholt.
- Standard: 50 MB.
pull.hosts · Nur Desktop
Die Hosts, von denen die Datei geholt wird: die angehakten, oder (Nach Tag-Regel) die Hosts mit den gewählten Tags beim Start. Jeder verbindet sich wie für SFTP. Das ZIP wird geschrieben, sobald alle Hosts fertig sind; erneutes Abholen von den fehlgeschlagenen schreibt es neu.
Hosts: Inventar
Abschnitt betitelt „Hosts: Inventar“Wo: Hosts › Mehr › Inventar.
CSV exportieren
Abschnitt betitelt „CSV exportieren“inventory.export · Nur Desktop
Speichert das Inventar als CSV-Datei: Host, Adresse, Betriebssystem, Version, Architektur und wann dieses Gerät zuletzt mit ihm verbunden war (UTC). Die Angaben stammen aus der Betriebssystemprüfung jeder Verbindung; ein Host, mit dem sich nie ein Gerät mit diesem Tresor verbunden hat, hat leere Spalten. Die Datei ist nicht verschlüsselt: Die Hosts eines Teams, dessen Richtlinie Exporte ohne Verschlüsselung sperrt (oder dessen Richtlinie gerade nicht gelesen werden kann), fehlen darin, und der Dialog sagt, wie viele.
Hosts: tmux-Sitzungen
Abschnitt betitelt „Hosts: tmux-Sitzungen“Wo: Hosts › ein Host › tmux-Sitzungen….
In den Bereichen suchen
Abschnitt betitelt „In den Bereichen suchen“tmux.search · Nur Desktop
Findet ein Wort in dem, was jeder Bereich jeder tmux-Sitzung auf dem Host zeigt: die letzten 200 Zeilen von jedem, bis zu 64 Bereiche, Groß- und Kleinschreibung egal. Der Text wird über einen eigenen Kanal gelesen (in kein Terminal wird getippt) und auf diesem Computer durchsucht; ein Treffer sagt, in welcher Sitzung, welchem Fenster und Bereich er ist, mit „Anhängen“.
tmux.name · Nur Desktop
Der Name der tmux-Sitzung oder des Fensters oder der Titel des Bereichs, bis zu 128 Zeichen. Leerzeichen, Anführungszeichen und alle anderen Zeichen bleiben, wie sie getippt sind (auch ein #: tmux zeigt es und liest es nicht als Format); ein Zeilenumbruch, ein Tab oder ein anderes Steuerzeichen wird abgelehnt, ebenso : und . in einem Sitzungsnamen, mit denen tmux ein Fenster und einen Bereich benennt. „Starten“ erstellt die Sitzung auf dem Host und lässt sie laufen; „Starten und verbinden“ öffnet sie außerdem in einem neuen Tab, wofür der Name in ein Terminal getippt wird, darum nur Buchstaben, Ziffern, - und _.
© 2026 IRONPINE LABS LLC
ALL RIGHTS RESERVED.