Mache aus jeder Maschine deinen Node
Node installieren, mit login / pair / join online gehen — und er erscheint in der Desktop-Node-Liste.
Node ist eine optionale Linux-Laufzeit. Sie brauchen ein Aihper-Konto oder ein Desktop bzw. eine App, das den Pairing- oder Join-Code beanspruchen kann.
Node installieren
Auf dem Ziel-Linux-Host ausführen (amd64 / arm64 — das Skript erkennt die Architektur):
Einzeilige Installation (Linux)curl -fsSL https://get.aihper.com/node | shOnline gehen — eine Methode wählen
Jede der folgenden Methoden bringt diesen Node online. Nach Erfolg läuft er im Hintergrund; stoppen mit aihper stop.
E-Mail & Passwort
Auf dieser Maschine anmelden
aihper loginDesktop-Beitrittscode
Code in Desktop erzeugen → hier join ausführen
aihper join <join code>Lokaler Pairing-Code
Hier Code drucken → Node in Desktop einlösen
aihper pairIn Desktop prüfen
Desktop öffnen → Node-Verwaltung: der Node sollte als online erscheinen. Ein Kurzcode ist optional — nur zur schnellen Auswahl/Prüfung unter Ressourcen. Standardlabel ist der Hostname der Maschine; du kannst ihn jederzeit in Desktop umbenennen. Tipp: aihper autostart on ausführen, damit er nach einem Neustart wieder da ist.
CLI-Referenz
Vier Ebenen: Binary → Konto → Maschinen-ID → Prozess. Im Alltag reicht login (Hintergrund, dann Exit). start nach stop, Reboot oder login --no-start.
Befehle unterstützen Sprach-Aliase
Lokalisierte Befehlsnamen sind im Terminal gleichwertig. Der Schalter unten zeigt nur die Schreibweise — er ändert nicht die Website-Sprache.
z. B. aihper join und aihper 加入 funktionieren beide
logout löscht nur das Konto-Credential; die Maschinen-ID (Kurzcode) bleibt, damit der nächste Login dieselbe Node trifft. Zum Vergessen: reset --identity oder reset --all.
Alltag
aihper anmeldenAnmelden und im Hintergrund starten (zurück zur Shell; Name = Hostname)aihper koppelnPairing-Code erzeugen und auf Desktop-Claim warten (kein Passwort)aihper beitretenMit Desktop-Beitrittscode beitreten und Node starten; CODE als argv oder versteckte Eingabeaihper beitreten <Code>Einzeiler mit CODE beitreten und Node startenaihper abmeldenVom Konto abmelden; Maschinen-ID (Kurzcode) behalten, damit der nächste Login dieselbe Node trifftaihper startenProzess starten, wenn bereits angemeldet (Standard: Hintergrund). Nach Herunterfahren/Reboot, stop oder login --no-start — nicht direkt nach login.aihper stoppenNur Prozess stoppen; Login-Credential bleibtaihper autostart statusPrüfen, ob Autostart aktiv istaihper autostart onAutostart bei Login/Boot einschalten (zuerst login / pair / join)aihper autostart offAutostart ausschaltenaihper infoVollständige Installations- und Laufzeitkarte: Login, Identität, Prozess, Pfadeaihper woNur Orte: Binary-Pfad, Datenordner, relevante Umgebungsvariablenaihper spracheUI-Sprache anzeigen oder setzen (in Config gespeichert)aihper logsLog live verfolgen (zeigt zuerst die letzten Zeilen, dann weiter)aihper logs -n 200Letzte N Zeilen zeigen, dann weiterverfolgenaihper logs --onceNur die letzten Zeilen anzeigen (nicht verfolgen)aihper kurzcodeKurzcode für Desktop-Pairing anzeigen
Installation
Online-Nodes können auch über Desktop → Node-Verwaltung remote aktualisiert werden.
aihper aktualisierenNeueste Binary lokal herunterladen und ersetzen (Config bleibt). Läuft der Node, startet das Install-Skript neu; AIHPER_NO_RESTART=1 überspringt den Neustart. Online bevorzugt Desktop-Remote-Upgrade.aihper deinstallierenBinary entfernenaihper deinstallieren --purgeBinary und lokale Config entfernen
Fehlerbehebung
aihper diagnoseHäufige Probleme diagnostizieren und einen Fix vorschlagenaihper reset --authNur Konto-Credential löschen (wie logout; Maschinen-ID bleibt)aihper reset --identityMaschinen-ID löschen; nächster Login = neuer Cloud-Nodeaihper reset --all~/.config/aihper komplett löschen (Credential + Maschinen-ID)
Weitere Befehle
aihper anmelden --name 'lab-1'Optional: Anzeigename beim Login setzen (Standard: Hostname; oder später im Desktop umbenennen)aihper anmelden --no-startNur Credential speichern, nicht online gehen (z. B. vor systemd start)aihper anmelden --foregroundNach Login im Vordergrund laufen (blockiert; zum Debuggen)aihper starten --foregroundIm Vordergrund starten (systemd / Debug; Standard-start ist Hintergrund)aihper sprache zhChinesisch setzen und speichernaihper sprache enEnglisch setzen und speichernaihper sprache deDeutsch setzen und speichernaihper sprache esSpanisch setzen und speichernaihper sprache ptPortugiesisch setzen und speichern
Mit --yes Bestätigung bei reset / uninstall --purge überspringen. Nach Remote-Logout erneut login.
Benötigt ausführbare Binary und Netzwerkzugang zur API. Produktion: login --no-start, dann start --foreground per systemd. Online-Nodes bevorzugt per Desktop remote upgraden; offline mit lokalem upgrade / Install-Skript.
Maschinen unterscheiden per Hostname / IP / Kurzcode. Alias im Desktop. Nach Neustart: aihper autostart on.
