SSH-Client für den Desktop · Windows / Linux / macOS

Verbindungen, Terminal,
Dateien in einem Fenster


LIULI Shell ist ein plattformübergreifender SSH-Client.
Es vereint Verbindungsverwaltung, interaktives Terminal, SFTP-Dateiübertragung, Laufzeitüberwachung und Konfigurationssynchronisierung in einer Desktop-Anwendung – für Entwickler und Administratoren, die mehrere Server verwalten.

Installer / Portable Plattformübergreifende Cloud-Synchronisierung Importiert FinalShell-Backups 8 Designs
LIULI Shell Hauptfenster: links Server und Überwachung, in der Mitte Terminal und Dateien, rechts Serverinformationen und Prozesse
SitzungenSSH mit mehreren Tabs und Wiederverbindung
DateienSchnelles SFTP-Browsen und Bearbeiten
ÜberwachungRessourcen, Netzwerk und Prozesse
SynchronisierungOffizieller Cloud-Dienst / eigenes WebDAV
01 — Download

Passende Installationsart wählen

Windows 10 / 11 bietet Installer und Portable; Linux und macOS werden aus dem Quellcode gebaut. Installer und Portable haben den gleichen Funktionsumfang.

Installer & Portable

Der Installer enthält einen Einrichtungsassistenten und legt Verknüpfungen an; die Portable-Version läuft nach dem Entpacken – ideal für USB-Sticks oder temporäre Umgebungen.

Windows 10 / 11 x64 · Setup.exe / Portable.exe
Code YKXY (im Link bereits enthalten, keine manuelle Eingabe nötig)
夸克网盘 öffnen ↗
GitHub

GitHub Releases

Für Netze außerhalb Chinas geeignet; Release-Assets werden mit den Repository-Commits synchron aktualisiert.

Zu den GitHub Releases ↗
Gitee

Gitee Releases

Für Netze innerhalb Chinas geeignet; portable Assets bleiben mit dem Repository synchron.

Zu den Gitee Releases ↗
Aus dem Quellcode bauen

Linux / macOS

Abhängigkeiten auf dem Zielsystem installieren und paketieren; unterstützt deb, AppImage, tar.gz sowie dmg und zip für macOS.

Build-Befehle anzeigen
Die Konfiguration liegt standardmäßig in %APPDATA%\LIULI Shell, Upgrades oder Neuinstallationen löschen sie nicht. Beim Computerwechsel können Sie die Cloud-Synchronisierung als Backup nutzen oder die Konfigurationsdatei in den Einstellungen exportieren und übertragen.
02 — Build

Installationspakete aus dem Quellcode erzeugen

Linux- und macOS-Pakete müssen auf dem jeweiligen System gebaut werden. Führen Sie die Befehle einzeln aus, nicht den ganzen Block einfügen. Das Skript erkennt die Distribution, installiert Abhängigkeiten und fragt nach dem Pakettyp.

build.sh — quick start copy & run
Quick Build

Build-Befehle für Linux / macOS

Zuerst eine Quelle wählen (Gitee oder GitHub), dann in das Verzeichnis wechseln und das Build-Skript ausführen.
Gitee klont standardmäßig nach liuli-shell, GitHub standardmäßig nach Liulishell; unten wird einheitlich nach liuli-shellgeklont, damit alle folgenden Befehle gleich bleiben.

Git wird benötigt.Schritt 0 installiert Git; Schritt 1 behält nur eine Quelle; Schritt 2 führt das Build-Skript aus. Build-Befehle erst nach abgeschlossenem Klonen ausführen.

# 0) Git wird benötigt; bereits installiert wird übersprungen (auf anderen Distributionen dnf / pacman)
command -v git >/dev/null || sudo apt-get update && sudo apt-get install -y git

# 1) Alte Verzeichnisse löschen, dann eine Quelle klonen (Gitee / GitHub)
# Gitee (in China empfohlen, Standardverzeichnis ist liuli-shell)
rm -rf liuli-shell Liulishell && git clone https://gitee.com/liuliwanjiaweb/liuli-shell.git liuli-shell
# GitHub (außerhalb Chinas empfohlen; Standardverzeichnis ist Liulishell, hier explizit liuli-shell)
rm -rf liuli-shell Liulishell && git clone https://github.com/LIULIWANJIA/Liulishell.git liuli-shell

# 2) Ins Projekt wechseln und bauen: Distribution erkennen → Systemabhängigkeiten ergänzen → deb / AppImage wählen → paketieren → Installation anbieten
cd liuli-shell && bash scripts/build-linux.sh

Die Artefakte liegen in dist/. Das Skript fragt nach der Auswahl 1 = deb / 2 = AppImage / 3 = beides; für nur .tar.gz nutzen Sie bash scripts/build-linux.sh tar. Das Skript behandelt automatisch den *t64 -Paketnamen-Fallback unter Ubuntu 24.04+. In nicht interaktiven Umgebungen wie CI wird nicht automatisch installiert; das Artefakt muss manuell installiert werden. Bei Problemen zuerst bash scripts/build-linux.sh check ausführen; bei langsamen Electron-Downloads wechselt das Skript automatisch den Mirror.

Bei fehlenden Abhängigkeiten oder Build-Fehlern der Reihe nach ausführen; ein normaler Build benötigt sie nicht
# 3) Wenn Abhängigkeiten fehlen oder der Build fehlschlägt, diese nacheinander versuchen
bash scripts/build-linux.sh repair
bash scripts/build-linux.sh deps
bash scripts/build-linux.sh

Bereits installierte Basisumgebung wird übersprungen.Homebrew fragt bei der Installation nach dem Passwort des aktuellen Benutzers. Nach dem Klonen Abhängigkeiten installieren und paketieren; Intel oder Apple Silicon nach Bedarf wählen.

# Basistools (bereits installiert wird übersprungen; xcode-select öffnet einen Dialog, auf das Ende warten)
xcode-select --install 2>/dev/null || true
command -v brew >/dev/null || /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Homebrew nach der Installation in den PATH aufnehmen (Intel: /usr/local/bin/brew)
if [ -x /opt/homebrew/bin/brew ]; then eval "$(/opt/homebrew/bin/brew shellenv)"; elif [ -x /usr/local/bin/brew ]; then eval "$(/usr/local/bin/brew shellenv)"; fi
# Node ≥ 18 erforderlich; bei Fehlen oder zu alter Version 20 installieren, dann prüfen
node -v 2>/dev/null | grep -qE '^v(1[89]|[2-9][0-9])' || brew install node@20
brew link --overwrite --force node@20 >/dev/null 2>&1 || true
node -v && npm -v

# Alte Verzeichnisse löschen, dann eine Quelle klonen (Gitee / GitHub)
rm -rf liuli-shell Liulishell
# Gitee (in China empfohlen, Standardverzeichnis ist liuli-shell)
git clone https://gitee.com/liuliwanjiaweb/liuli-shell.git liuli-shell
# GitHub (außerhalb Chinas empfohlen; Standardverzeichnis ist Liulishell, hier explizit liuli-shell)
git clone https://github.com/LIULIWANJIA/Liulishell.git liuli-shell
cd liuli-shell npm ci || npm install # bei Fehler automatischer Rückfall auf npm install npm run vendor # Bei langsamen Electron-Downloads in China die nächsten beiden Zeilen auskommentieren (optional) # export ELECTRON_MIRROR=https://registry.npmmirror.com/-/binary/electron/ # export ELECTRON_BUILDER_BINARIES_MIRROR=https://registry.npmmirror.com/-/binary/electron-builder-binaries/ npm run dist:mac # x64 + arm64 zusammen bauen npx electron-builder --mac dmg zip --arm64 # nur Apple Silicon

Die Artefakte liegen in dist/ (.dmg / .zip). npm run vendor kopiert xterm-Ressourcen nach src/renderer/vendor, muss vor dem Paketieren ausgeführt werden; Intel- und Apple-Silicon-Artefakte sind nicht austauschbar. Wenn Gatekeeper die unsignierte App blockiert, per Rechtsklick „Öffnen“ zulassen.

In China wird Gitee empfohlen; bei langsamen Electron-Downloads Mirror-Variablen setzen.

03 — Migration

Import von FinalShell-Backups

Importiert von FinalShell exportierte JSON-Dateien oder einen ganzen Konfigurationsordner. Der Import liest Verbindungsdaten, baut die Gruppenhierarchie nach und zeigt vor dem Schreiben eine Statistik.

  • Zwei QuellenMehrere JSON-Dateien auf einmal oder den gesamten Konfigurationsordner auswählen.
  • Hierarchie wiederhergestelltAus der ursprünglichen Ordnerstruktur werden bis zu drei Gruppenebenen erstellt; tiefere Ordner landen in ihrer obersten Gruppe.
  • PasswortbehandlungEntschlüsselte Passwörter werden im Verschlüsselungsformat dieser Software neu gespeichert; nicht entschlüsselbare Einträge bleiben leer und werden klar gemeldet.
  • Sicheres SchreibenVor dem Import werden geplante Gruppen und Verbindungen angezeigt; Duplikate werden automatisch übersprungen, ein Fehler berührt die bestehende Konfiguration nicht.
FinalShell-Konfiguration importieren · LIULI Shell

FinalShell-Konfiguration importieren

Dateien einfach ablegen; mehrere JSON-Dateien oder der gesamte Konfigurationsordner sind möglich.

JSON-Dateien oder Ordner ablegen oder die Schaltflächen unten verwenden
JSON-Dateien wählen Ordner wählen
Geplant: neu 2 Gruppen der ersten Ebene, 3 Gruppen der zweiten Ebene, 1 Gruppe der dritten Ebene, 14 Serverkonfigurationen
Automatisch: FinalShell-Import (direkt JSON)

Ordner erzeugen Gruppen nach Hierarchie (maximal drei Ebenen); JSON-Dateien unterhalb der dritten Ebene werden der passenden Gruppe der ersten Ebene zugeordnet, unabhängig von der Ziel-Gruppe.

Import starten Fertig: 14 hinzugefügt, 2 Duplikate übersprungen · Neue Gruppen: 2 der ersten / 3 der zweiten / 1 der dritten Ebene
1Quelle wählen Eine oder mehrere FinalShell-JSON-Dateien oder den gesamten Konfigurationsordner wählen.
2Plan prüfen Die geplanten Gruppenebenen und die Anzahl der Verbindungen vor dem Schreiben anzeigen.
3Import abschließen Nach Deduplizierung schreiben und die Liste aktualisieren; neue Gruppen sind eingeklappt und unterbrechen die laufende Arbeit nicht.
04 — Community

Hilfe und Versionshinweise erhalten

Nutzungsfragen, Funktionswünsche und Versionsneuigkeiten werden in den Gruppen geteilt. Treten Sie der Plattform bei, die Sie nutzen.

QQ-Gruppe · China

QQ-Gruppe

Nutzer in China können in der QQ-Gruppe Probleme melden und Konfigurationen sowie Erfahrungen austauschen.

1127112572
QQ-Gruppe beitreten ↗
Telegram · International

Telegram-Gruppe

Nutzer außerhalb Chinas erhalten dieselben Hinweise und Diskussionen über die Telegram-Gruppe.

t.me/liulishell
Telegram-Gruppe öffnen ↗
05 — Kernmodule

Neun Module für den täglichen Betrieb

Von der Serververbindung über Dateitransfer bis zu Statusprüfung und Konfigurationsmigration läuft alles im Client. Hier steht, was die einzelnen Module leisten.

01
▤

Serververwaltung

Server in Gruppen organisieren, mehrere auswählen, per Drag & Drop verschieben oder Konfigurationen kopieren; gelöschte Verbindungen bleiben 30 Tage im Papierkorb und lassen sich jederzeit wiederherstellen.

02
❯_

Terminal-Sitzungen

Jeder Tab ist eine unabhängige SSH-Sitzung mit Befehlsverlauf, Schnelleingabe, Wiederverbindung und sortierbaren Tabs per Drag & Drop; Proxy-Verbindungen tragen eine Statusanzeige.

03
▥

Dateiverwaltung

SFTP-Verzeichnisbaum und Dateiliste sind gekoppelt und folgen dem Verzeichniswechsel im Terminal; Hochladen, Herunterladen, Berechtigungen ändern und integrierter Texteditor.

04
◎

Live-Überwachung

Erfasst fortlaufend CPU, Speicher, Swap, Datenträger, Netzwerk und Prozesse; die Diagrammskalen passen sich automatisch an, abnormale Last ist direkt erkennbar.

05
⇅

Transfer-Center

Download-Aufgaben werden in einem eigenen Fenster verwaltet und lassen sich pausieren, abbrechen oder leeren; Fortschritt, Rate und Status in Echtzeit.

06
☁

Cloud-Synchronisierung

Unterstützt den offiziellen Cloud-Dienst und eigenes WebDAV: verschlüsselte Synchronisierung von Servern, Gruppen und Favoriten mit bidirektionaler Zusammenführung über Geräte hinweg; manuelle Synchronisierung und Backup sind ebenfalls möglich.

07
⇄

Konfigurationsmigration

Liest FinalShell-JSON-Backups oder ein gesamtes Konfigurationsverzeichnis und baut Gruppen nach der ursprünglichen Hierarchie neu auf; Vorschau vor dem Import, Duplikate werden übersprungen.

08
◐

Erscheinungsbild & Bedienung

8 helle und dunkle Designs; Schriftarten, Schriftgröße, Oberflächenskalierung, Mausverhalten und Tastenkürzel lassen sich anpassen und werden automatisch gespeichert.

09
⌁

Netzwerk-Proxy

HTTP- / SOCKS5-Proxy pro Verbindung oder global einstellen, mit Standard-Proxy und Direktverbindungs-Fallback für Intranetze und eingeschränkte Netze.

06 — Snippets

Häufige Befehle, ein Klick genügt

Häufige Befehle nach Bereichen sortieren, statt lange Befehle im Terminal wiederholt einzutippen; Änderungen übernimmt bei Bedarf der Befehlseditor.

Snippets & Command Editor

Nach Bereichen sortiert, kein Abtippen mehr

Bereiche wie Häufig, Docker und Netzwerk werden getrennt verwaltet; Schaltflächen zeigen nur Namen, die Oberfläche bleibt aufgeräumt; Bereiche und Befehle lassen sich per Drag & Drop sortieren.

  • AusführungsartAuf einen Klick direkt ausführen oder zuerst in das Befehlsfeld einsetzen und bestätigen.
  • BefehlseditorMehrzeilige Skripte rechts bearbeiten, mit Strg + Enter an die aktuelle Sitzung senden.
  • Verlauf & SitzungZwischen Befehlsverlauf und aktueller Sitzung wechseln und die letzte Eingabe schnell wiederfinden.
SnippetsSNIPPETS
HäufigDockerNetzwerk+
DatenträgerSpeicherProzesseBildschirm leeren
Befehlseditor Ctrl + Enter
1docker compose pull
2docker compose up -d
3docker compose ps
07 — Live-Überwachung

Ressourcen, Netzwerk und Prozesse auf einem Bildschirm

Nach dem Verbinden werden Laufzeitdaten automatisch erfasst; abnormale Last zuerst im Client lokalisieren, dann entscheiden, ob ein Terminal geöffnet wird.

ServerüberwachungLIVE · 2s
CPU64%
Speicher62%
Swap14%
Down1.36 Mbps
Up0.21 Mbps
Prozessvorschau Nach CPU sortiert
nginx12.5%340 MB
worker-112.0%17.6 MB
worker-211.7%20.1 MB
worker-311.4%22.7 MB
Monitor & Processes

Status prüfen, ohne sich am Server anzumelden

Links die Ressourcenübersicht, rechts Netzwerkrate und Prozesslast; Aktualisierungsintervall und Einheiten lassen sich in den Einstellungen ändern.

  • RessourcenübersichtAuslastung von CPU, Speicher, Swap und Datenträgerpartitionen; die Diagrammskalen passen sich automatisch an.
  • NetzwerkrateAktuelle Down-/Up-Rate und Gesamttraffic gemeinsam anzeigen; Einheiten umschaltbar.
  • ProzessvorschauNach CPU oder Speicher sortieren, um stark belastende Prozesse schnell zu finden.
08 — Daten & Sicherheit

Konfiguration bleibt lokal, Änderungen werden gesichert

Zugangsdaten, Konfigurations-Backups und die Wiederherstellung gelöschter Einträge laufen im Client – mit weniger Abhängigkeit von externen Diensten und manuellen Schritten.

Local Data & Security

Passwörter verschlüsselt, Löschen umkehrbar

Zugangsdaten werden nur als verschlüsselte Zeichenfolge gespeichert und nie im Klartext angezeigt; vor dem Schreiben wird automatisch gesichert, gelöschte Server und Gruppen landen im Papierkorb.

  • Schutz der ZugangsdatenPasswörter und Schlüssel werden mit einem lokalen Schlüssel verschlüsselt; beim Export kann zusätzlich ein Passwort gesetzt werden.
  • Automatisches BackupVor jedem Schreiben wird ein Backup erstellt; bei beschädigter Konfiguration lässt sich der letzte Stand wiederherstellen.
  • PapierkorbGelöschte Server und Gruppen bleiben 30 Tage erhalten und lassen sich jederzeit wiederherstellen.
Daten & SicherheitLOCAL
✓
Zugangsdaten verschlüsseltPasswörter und Schlüssel werden nur als verschlüsselte Zeichenfolge gespeichert; kein Klartext in der Oberfläche.
✓
Auto-Backup vor dem SchreibenBei beschädigter Konfiguration das letzte Backup wiederherstellen.
✓
30-Tage-PapierkorbGelöschte Server und Gruppen jederzeit wiederherstellen.
✓
Verschlüsselter Export / ImportBeim Computerwechsel die Konfiguration mit Passwort exportieren.
09 — Aufteilung

Das Hauptfenster hat drei Spalten

Die Spaltenbreiten lassen sich per Drag & Drop ändern oder Spalten bei Bedarf ausblenden. Oben liegen Sitzungs-Tabs und Fenstersteuerung, die Statusleiste unten zeigt die aktiven Verbindungen.

Links Server & Überwachung.Gruppenliste, Suche, Verbindungsstatus sowie Übersicht über CPU, Speicher, Swap und Datenträger.
Mitte Arbeitsbereich.SSH-Terminal, Befehlseingabe, Dateimanager und Snippet-Leiste.
Rechts Verbindungsdetails.Serverinformationen, Netzwerkrate, Prozessliste und Befehlseditor.
Terminal-Arbeitsbereich mit ausgeblendeter rechter Spalte
Terminal-ArbeitsbereichRechte Spalte ausblenden, mehr Platz im Terminal
Einstellungszentrum
EinstellungenDesign, Schrift, Skalierung und Daten
Snippet-Leiste
SnippetsNach Bereichen sortiert, direkt ausführbar
Sprachen

Eine App, eine Website, acht Sprachen

Client und Website sind in vereinfachtem Chinesisch, traditionellem Chinesisch, Englisch, Russisch, Französisch, Deutsch, Japanisch und Koreanisch verfügbar. Beim Sprachwechsel ändern sich Seitenadresse und hreflang-Angaben; jede Sprache bietet denselben Funktionsumfang und dieselben Screenshots.

简体中文Chinese (Simplified) · zh-CN
繁體中文Chinese (Traditional) · zh-Hant
EnglishEnglish · en
日本語Japanese · ja
한국어Korean · ko
РусскийRussian · ru
FrançaisFrench · fr
DeutschGerman · de
10 — Einstellungen & Designs

An die eigene Arbeitsweise anpassen

Einstellungen sind nach Zweck gruppiert, Änderungen wirken sofort und werden automatisch gespeichert. Hier die sechs meistgenutzten Gruppen.

LIULI Shell · Einstellungen
LIULI Shell Einstellungen
Das linke Menü gruppiert die Einstellungen nach Zweck, rechts stehen die Optionen der aktuellen Kategorie; unten lassen sich die Standardwerte wiederherstellen.

Erscheinungsbild & Designs

  • 8 Farbschemata, Terminalhintergrund und ANSI-Palette wechseln mit
  • Spaltenbreiten und Höhe der unteren Leiste per Drag & Drop anpassen und merken
  • Nicht benötigte Bereiche einzeln ausblenden

Schriften & Skalierung

  • Schriften für Latein/CJK, Schriftgröße und Zeilenabstand getrennt einstellen
  • Oberflächenskalierung 100 / 125 / 150 / 200%
  • Skalierungswechsel erfordert Bestätigung;Ctrl+Shift+0 lässt sich zurücksetzen

Maus & Tastenkürzel

  • Verhalten von Mittel- und Rechtsklick im Terminal anpassen
  • Globale Tastenkürzel sind änderbar, Konflikte werden sofort gemeldet
  • Snippets per Drag & Drop sortieren

Snippets

  • Häufige Befehle nach Bereichen organisieren
  • Steuerung bleibt in der ersten Zeile, Bereiche brechen bei Platzmangel automatisch um
  • Ausführung per Einzel- oder Doppelklick

Synchronisierung & Proxy

  • WebDAV-Adresse, Konto und Zugangsdaten getrennt speichern
  • Bidirektionale Zusammenführung von Konfiguration, Gruppen und Favoriten
  • Proxy unterstützt HTTP / SOCKS5, Standard-Proxy festlegbar

Daten & Sicherheit

  • Konfiguration vor dem Schreiben automatisch sichern, bei Bedarf wiederherstellen
  • Passwörter und Schlüssel verschlüsselt gespeichert; kein Klartext in der Oberfläche
  • Daten löschen erfordert Bestätigung und Countdown
Themes

8 Design-Farbschemata

Sechs helle und zwei dunkle Designs; Oberfläche, Terminalhintergrund und ANSI-Farben ändern sich gemeinsam.

Warmweiß · DunkelgrünStandard · augenschonend
Nebelblau · IndigoKlar und kühl
Sandbeige · TerrakottaWarmer Papierton
Graphit · KaltgrauNeutral, hoher Kontrast
Nacht · TiefschwarzDunkle Oberfläche
Lotusrosa · BeerenlilaSanftes warmes Violett
Seladon · TannengrünZurückhaltendes Türkis
Tiefsee · IndigoblauDunkler Blauton
11 — Referenz

Manuell bauen und Fehler beheben

Wenn Sie den Build-Ablauf manuell steuern, Abhängigkeiten für verschiedene Distributionen vorbereiten oder Paketierungsfehler untersuchen möchten, öffnen Sie die vollständige Referenz unten.

Vollständige Build-Anleitung für Linux / macOS Enthält Abhängigkeitsbefehle je Distribution, AppImage- / deb- / dmg-Paketierung, Desktopsymbole, FUSE-Behandlung und eine Übersicht häufiger Fehler. ▾

Linux x64 (AppImage / .deb / tar.gz)

Die Paketnamen der Systembibliotheken unterscheiden sich je Distribution; ab Ubuntu 24.04 heißen sie *t64. Die drei Artefakte unterscheiden sich: AppImage ohne Installation, deb über die Paketverwaltung, tar.gz nach dem Entpacken ohne FUSE.

Kompatibilität: AppImage läuft nur auf Systemen mit glibc nicht älter als der Build-Rechner. Für 20.04 – 26.04 auf dem ältesten Ubuntu 20.04 bauen; das scripts/build-linux.sh im Repository erkennt die Distribution und behandelt den t64-Paketnamen-Fallback.
Ohne manuelle Installation von Abhängigkeiten:bash scripts/build-linux.sh Ein Befehl erledigt „Distribution erkennen → Systemabhängigkeiten ergänzen → Pakettyp wählen → paketieren → Installation anbieten“, kompatibel mit apt / dnf / pacman. Nur Abhängigkeiten: ... deps; nur Diagnose: ... check; bei defekter Umgebung: ... repair. Installationsphase: deb über apt install einschließlich Desktopsymbol, AppImage wird kopiert nach ~/Applications/LIULI-Shell und erzeugt Anwendungsmenüeintrag und Desktopsymbol.

Ausführen & installieren

chmod +x dist/LIULI-Shell-*-x86_64.AppImage
./dist/LIULI-Shell-*-x86_64.AppImage

# deb unter Debian / Ubuntu installieren
sudo apt install ./dist/LIULI-Shell-*_amd64.deb

# Entpacken und starten (ohne FUSE, ohne Schreiben in Systemverzeichnisse)
mkdir -p ~/Applications
tar -xzf dist/LIULI-Shell-*-x86_64.tar.gz -C ~/Applications
~/Applications/LIULI-Shell-*/liulishell

AppImage-Fehler: dlopen(): error loading libfuse.so.2

AppImage nutzt die type-2-Runtime und benötigt FUSE 2. Bis Ubuntu 22.04 ist es enthalten, 24.04 / 26.04 erfordern eine manuelle Installation; ohne FUSE lässt es sich auch entpackt starten.

# Ubuntu 24.04 / 26.04
sudo apt install -y libfuse2t64
# Ubuntu 20.04 / 22.04, Debian 12
sudo apt install -y libfuse2

# Ohne FUSE direkt starten (etwas langsamer, gleiche Funktionen)
./LIULI-Shell-*-x86_64.AppImage --appimage-extract-and-run

# Oder gleich das tar.gz-Paket verwenden, ganz ohne FUSE
Anwendungsmenü- / Desktopsymbol hinzufügen (AppImage)
# 1) An einen festen Ort kopieren
mkdir -p ~/Applications
cp dist/LIULI-Shell-*-x86_64.AppImage ~/Applications/LIULI-Shell.AppImage
chmod +x ~/Applications/LIULI-Shell.AppImage

# 2) Symbol extrahieren (--appimage-extract entpackt squashfs-root im aktuellen Verzeichnis)
cd /tmp && ~/Applications/LIULI-Shell.AppImage --appimage-extract '*.png' >/dev/null 2>&1
mkdir -p ~/.local/share/icons/hicolor/512x512/apps
cp /tmp/squashfs-root/*.png ~/.local/share/icons/hicolor/512x512/apps/liulishell.png 2>/dev/null \
  || cp /tmp/squashfs-root/liulishell.png ~/.local/share/icons/hicolor/512x512/apps/ 2>/dev/null

# 3) Anwendungseintrag schreiben ($HOME wird zum Benutzerverzeichnis)
mkdir -p ~/.local/share/applications
cat > ~/.local/share/applications/LiuliShell.desktop <<EOF
[Desktop Entry]
Type=Application
Name=LIULI Shell
Comment=Plattformübergreifendes SSH-Terminal und Serververwaltung
Exec=$HOME/Applications/LIULI-Shell.AppImage %U
Icon=liulishell
Terminal=false
Categories=Development;System;Network;
StartupWMClass=LiuliShell
EOF
chmod +x ~/.local/share/applications/LiuliShell.desktop
update-desktop-database ~/.local/share/applications 2>/dev/null || true

# 4) Für ein Desktopsymbol zusätzlich kopieren und als vertrauenswürdig markieren
cp ~/.local/share/applications/LiuliShell.desktop ~/Desktop/
gio set ~/Desktop/LiuliShell.desktop metadata::trusted true 2>/dev/null || true
# In lokalisierten Systemen kann der Desktop-Ordner anders heißen; entsprechend anpassen

Nutzer der .deb-Installation überspringen diese Schritte: deb schreibt /usr/share/applicationsautomatisch und die App ist direkt im Anwendungsmenü sichtbar.

macOS (dmg + zip, x64 / arm64)

Voraussetzungen:macOS 12+ (Intel oder Apple Silicon), Xcode Command Line Tools, Homebrew, Git, Node.js 20/22 LTS. dmg kann nichtunter Windows / Linux gebaut werden.

1. Basistools(xcode-select öffnet einen Dialog, auf das Installationsende warten)

xcode-select --install
/bin/bash -c "$(curl -fsSL \
  https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Unter Apple Silicon brew in den PATH schreiben (Intel: /usr/local/bin/brew; mehrfaches Ausführen hängt nicht doppelt an)
grep -qsF 'brew shellenv' ~/.zshrc || echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

2. Node 20 und Git

brew install node@20 git
brew link --overwrite --force node@20
node -v && npm -v          # erwartet v20.x

3. Quellcode und Abhängigkeiten(Alte Verzeichnisse zuerst löschen, um Reste zu vermeiden; Gitee / GitHub wählen. Gitee-Standardverzeichnis ist liuli-shell, GitHub-Standardverzeichnis ist Liulishell, hier einheitlich explizit geklont nach liuli-shell)

rm -rf liuli-shell Liulishell
# Gitee (in China empfohlen)
git clone https://gitee.com/liuliwanjiaweb/liuli-shell.git liuli-shell
# GitHub (außerhalb Chinas empfohlen: die nächste Zeile auskommentieren und die Gitee-Zeile kommentieren)
# git clone https://github.com/LIULIWANJIA/Liulishell.git liuli-shell
cd liuli-shell
npm ci || npm install      # bei abweichender Lockdatei Rückfall auf npm install
npm run vendor             # xterm-Ressourcen nach src/renderer/vendor kopieren, vor dem Paketieren erforderlich

4. Paketieren(Am schnellsten nur für die aktuelle Architektur; für beide dist:macangeben)

npm run dist:mac                              # x64 + arm64 zusammen
npx electron-builder --mac dmg zip --arm64    # nur Apple Silicon
npx electron-builder --mac dmg zip --x64      # nur Intel

5. Artefakte und Cache:Die Artefakte liegen in ~/liuli-shell/dist/(*.dmg,*.zip); Electron- und Tool-Downloads werden zwischengespeichert in ~/Library/Caches/electron/und~/Library/Caches/electron-builder/; Löschen erzwingt einen erneuten Download.

6. Unsignierte Installation:Wenn Gatekeeper die App nach dem Verschieben in „Programme“ blockiert, per Rechtsklick „Öffnen“ zulassen oder ausführen:

xattr -dr com.apple.quarantine "/Applications/LIULI Shell.app"
spctl --assess --type execute -vv "/Applications/LIULI Shell.app"   # Ursache der Blockierung anzeigen

Für die öffentliche Verteilung sind ein Apple-Developer-ID-Zertifikat und Notarisierung erforderlich: CSC_LINK(.p12-Pfad oder base64),CSC_KEY_PASSWORDsetzen; die Notarisierung benötigt zusätzlich APPLE_ID,APPLE_APP_SPECIFIC_PASSWORD,APPLE_TEAM_ID; electron-builder erledigt Signierung und Notarisierung automatisch.

Intel- und Apple-Silicon-Artefakte sind nicht austauschbar; um beide Rechner mit einem Paket abzudecken, npx electron-builder --mac dmg --universalverwenden (etwa doppelt so groß wie eine Einzelarchitektur, deutlich langsamer).

Übersicht häufiger Fehler

Fehler / SymptomUrsache / Behandlung
Paket libasound2 nicht gefunden Ab Ubuntu 24.04 / Debian 13 wurden die Systembibliotheken umbenannt *t64(z. B. libasound2t64,libgtk-3-0t64). Zuerst unter dem alten Namen installieren, bei Fehler automatischer Rückfall:bash scripts/build-linux.sh deps enthält diese Logik bereits.
dlopen(): error loading libfuse.so.2 AppImage benötigt zur Laufzeit FUSE 2: ab 24.04 libfuse2t64installieren, unter 22.04 und älter libfuse2; ohne FUSE --appimage-extract-and-runnutzen oder direkt .tar.gzverwenden.
Electron-Download Timeout / hängt bei downloading Mirror setzen und erneut versuchen:export ELECTRON_MIRROR=https://registry.npmmirror.com/-/binary/electron/,export ELECTRON_BUILDER_BINARIES_MIRROR=https://registry.npmmirror.com/-/binary/electron-builder-binaries/.
npm ci schlägt fehl / Lockdatei passt nicht zur Plattform Löschen node_modules und stattdessen npm installverwenden; Node unter 18 lässt sich nicht installieren, Node 20 nutzen.
rpmbuild not found Nur für rpm erforderlich: unter Fedora rpm-buildinstallieren, unter Debian/Ubuntu rpm und rpm2cpio -Pakete, oder das rpm-Ziel überspringen.
Permission denied (AppImage ausführen) Ausführungsrecht fehlt:chmod +x dist/LIULI-Shell-*-x86_64.AppImage.
errSecInternalComponent / Signierung fehlgeschlagen (macOS) Keychain ist gesperrt:security unlock-keychain -p <Passwort> ~/Library/Keychains/login.keychain-db danach erneut ausführen; in CI zusätzlich security set-key-partition-list.

Allgemeine Hinweise

  • Build-Verzeichnis:Alle Artefakte landen standardmäßig im Projektstamm dist/. Linux: LIULI-Shell-*-x86_64 / *-arm64 als .AppImage / .deb / .tar.gz (das Skript erkennt die Architektur), macOS: .dmg / .zip.
  • Vor dem Paketieren:npm run vendor kopiert xterm.js und weitere Frontend-Ressourcen nach src/renderer/vendor/; ohne diesen Schritt bleibt das Terminal im Paket leer.
  • Build-Rechner:AppImage läuft nur auf Systemen mit glibc, das nicht älter als das des Build-Rechners ist. Für 20.04 – 26.04 auf Ubuntu 20.04 bauen; für den Eigenbedarf ist ein lokaler Build am schnellsten.
  • Cross-Build:Linux-Pakete werden unter Linux gebaut, macOS-Pakete unter macOS; die Artefakte sind nicht austauschbar, für Windows gilt dasselbe. Empfohlen: CI des jeweiligen Systems (z. B. ubuntu-22.04,macos-14 -Runner) zum Erzeugen der Pakete.
  • Veröffentlichung:Laden Sie dist/ Installations- und Portable-Pakete der jeweiligen Plattform als Release-Assets hoch (Windows- *.blockmap dient nur Delta-Updates und muss nicht hochgeladen werden); im Quell-Repository nicht committen: node_modules/ und dist/.