Zum Hauptinhalt springen

Linux-Installation

Install the Level agent on Linux devices using a one-line command or architecture-specific installer.

Einführung

Der Level-Agent ist ein schlanker Hintergrunddienst, der mit Ihrem Konto kommuniziert und Fernüberwachung, Automatisierung und Verwaltung für ein Linux-Gerät ermöglicht. Die Installation erfolgt mit einem einzigen Befehl, der als Root oder mit sudo ausgeführt wird.


⚙️ VORAUSSETZUNGEN

  • Ein Level-Konto mit der Berechtigung, Geräte hinzuzufügen

  • Root-Zugriff oder sudo auf dem Zielgerät

  • Eine unterstützte Linux-Distribution, die systemd ausführt

  • Erforderliche Pakete: curl, bash, ca-certificates, sudo, dbus (oder eine UUID in /etc/machine-id)


🎬 VIDEO


Linux-Installation

Klicken Sie auf Neues Gerät hinzufügen in der oberen rechten Ecke der Geräteliste Seite. Wählen Sie im Betriebssystem-Selektor Linux.

Linux Install

Gerätegruppe auswählen (Optional)

Wählen Sie eine Gerätegruppe aus, bevor Sie Ihren Installationsbefehl kopieren. Der Installationsschlüssel wird aktualisiert und enthält die Gruppen-ID, sodass das Gerät beim ersten Check-in in die richtige Gruppe gelangt.

Wenn Sie diesen Schritt überspringen, landet das Gerät in Ohne Gruppe. Sie können es danach verschieben.


Der Installationsschlüssel

Jede Linux-Installationsmethode verwendet einen Installationsschlüssel, ein kurzes Token, das im Modal sichtbar ist und neue Geräte mit Ihrem Level-Konto verknüpft. Es ist eng begrenzt: Wenn es offengelegt wird, kann damit weder auf Ihr Konto, vorhandene Geräte noch auf die Level-API zugegriffen werden. Das einzige Risiko besteht darin, dass jemand damit Geräte zu Ihrem Konto hinzufügen könnte.

Wenn Sie glauben, dass Ihr Installationsschlüssel kompromittiert wurde, wenden Sie sich an den Level-Support, um ihn zu rotieren.

ℹ️ HINWEIS: Der Installationsschlüssel spiegelt Ihre Gruppenauswahl in Echtzeit wider. Ohne ausgewählte Gruppe enthält er nur Ihren Kontoidentifikator. Wählen Sie eine Gruppe aus, wird die Gruppen-ID angehängt.


Installationsmethoden

Das Modal enthält zwei Registerkarten für Linux.

Einzeiliger Befehl

Ein einzeiliger Bash-Befehl, der den Agenten herunterlädt und installiert. Dies ist die Standardmethode für die meisten Linux-Deployments und erkennt die Architektur automatisch.

  1. Wählen Sie im Modal die Einzeiliger Befehl Registerkarte.

  2. Optional eine Gerätegruppe auswählen.

  3. Den generierten Befehl kopieren.

  4. Öffnen Sie auf dem Zielgerät ein Terminal.

  5. Führen Sie den Befehl aus. Wenn Sie nicht bereits Root sind, enthält der Befehl sudo: Sie werden nach Ihrem Passwort gefragt.

Linux One Line Installer

Das Gerät erscheint in Ihrer Geräteliste innerhalb von 5–10 Sekunden nach Abschluss der Installation.

Installer

Lädt eine architekturspezifische Binärdatei herunter und installiert sie über die Befehlszeile. Verwenden Sie diese Methode, wenn Sie die Architektur explizit angeben müssen oder einen manuellen Installationsprozess bevorzugen.

  1. Wählen Sie im Modal die Installer Registerkarte.

  2. Wählen Sie Ihre Architektur aus dem Dropdown-Menü: x64 oder ARM.

  3. Optional eine Gerätegruppe auswählen.

  4. Klicken Sie auf Installer herunterladen um die Binärdatei herunterzuladen.

  5. Kopieren Sie den im Modal angezeigten Installationsbefehl.

  6. Führen Sie auf dem Zielgerät den kopierten Befehl mit erhöhten Rechten aus.

Linux Installer

Der Befehl macht die Binärdatei ausführbar und führt die Installation durch, wobei das Gerät mit dem eingebetteten Installationsschlüssel bei Ihrem Konto registriert wird.


Benutzerdefiniertes Installationsverzeichnis

Auf Linux-Systemen mit systemd können Sie anstelle der Standardspeicherorte ein dediziertes Verzeichnis für die Agent-Binärdatei, Konfiguration und Anwendungsdaten auswählen. Wählen Sie das Verzeichnis bei der Installation aus. Diese Option verschiebt eine bestehende Installation nicht in einen neuen Pfad.

Verzeichnisanforderungen

  • Verwenden Sie einen absoluten Pfad, der für Level reserviert ist, z. B. /srv/level. Verwenden Sie für eine neue Installation ein leeres Verzeichnis. Sie können auch ein Verzeichnis wiederverwenden, das eine bestehende Level-Installation unter demselben Pfad enthält.

  • Das Dateisystem muss Schreiben und Ausführen erlauben. Ein schreibgeschütztes oder noexec Dateisystem kann nicht verwendet werden.

  • Das Verzeichnis muss root gehören, darf keinen Gruppen- oder Fremdzugriff zum Schreiben erlauben und muss anderen Benutzern das Traversieren erlauben. Auch die übergeordneten Verzeichnisse müssen root-kontrolliert und für andere Benutzer traversierbar sein. Modus 755 ist für ein dediziertes, root-eigenes Level-Verzeichnis geeignet.

  • Leerzeichen sind erlaubt, wenn Sie den Pfad in Ihrem Befehl in Anführungszeichen setzen. Verwenden Sie keine Steuerzeichen, einfachen oder doppelten Anführungszeichen, Prozentzeichen, Dollarzeichen, Backslashes oder Backticks im Pfad. Verwenden Sie kein gemeinsames Systemverzeichnis wie /, /mnt, /opt, /tmp, oder /var/lib als Installationsstamm.

Einzeiliger Befehl mit benutzerdefiniertem Verzeichnis

  1. Kopieren Sie Ihren Linux-Einzeiler von Neues Gerät hinzufügen, einschließlich des Installationsschlüssels und einer eventuellen Gerätegruppenauswahl.

  2. Fügen Sie LEVEL_INSTALL_DIR="/srv/level" vor LEVEL_API_KEY=..., wobei Sie den Beispielpfad durch Ihr gewähltes Verzeichnis ersetzen. Das übergeordnete Verzeichnis muss bereits vorhanden sein. Das Skript erstellt das endgültige Level-Verzeichnis, wenn es fehlt.

  3. Führen Sie den geänderten Befehl aus. Zum Beispiel mit Ihrem Installationsschlüssel anstelle von YOUR_INSTALL_KEY:

LEVEL_INSTALL_DIR="/srv/level" LEVEL_API_KEY="YOUR_INSTALL_KEY" bash -c "$(curl -L https://downloads.level.io/install_linux.sh)"

Das Skript legt seinen Download in einem privaten temporären Verzeichnis innerhalb des ausgewählten Installationsverzeichnisses ab und übergibt dieses Verzeichnis an den Agent-Installer. Verwenden Sie die Umgebungsvariable für das Shell-Skript; verwenden Sie --install-dir beim direkten Ausführen der heruntergeladenen Agent-Binärdatei.

Heruntergeladener Installer mit benutzerdefiniertem Verzeichnis

Erstellen Sie zuerst das dedizierte Verzeichnis und stellen Sie sicher, dass es die oben genannten Anforderungen erfüllt. Hängen Sie --install-dir "/srv/level" zum generierten Installationsbefehl. Für einen x64-Installer lautet der Befehl:

chmod +x ./level-linux-amd64 && sudo ./level-linux-amd64 -k YOUR_INSTALL_KEY -a install --install-dir "/srv/level"

Ersetzen Sie YOUR_INSTALL_KEY und den Pfad vor dem Ausführen des Befehls an, und verwenden Sie die Binärdatei für die Architektur Ihres Geräts. Die heruntergeladene Binärdatei muss sich auf einem ausführbaren Dateisystem befinden. Wenn ein vorhandener Level-Dienst auf ein anderes Installationsverzeichnis verweist, lehnt der Installer die Änderung ab, auch bei einer Zwangsinstallation. Wenden Sie sich an den Level-Support, bevor Sie den Speicherort einer bestehenden Installation ändern.

TrueNAS-Speicher und Neustart-Persistenz

Verwenden Sie für Linux-basierte TrueNAS-Deployments die folgenden Speicher- und Startanforderungen. Wenden Sie sich vor der Installation an den Level-Support, um die Kompatibilität mit Ihrer genauen TrueNAS-Edition und -Version zu bestätigen.

  1. Wählen Sie ein dediziertes Level-Verzeichnis oder Dataset auf einem ZFS-Speicherpool unter /mnt/, zum Beispiel /mnt/tank/level. Ersetzen Sie tank durch Ihren Pool-Namen. Wählen Sie nicht den Boot-Pool oder den Speicherpool-Stamm selbst.

  2. Importieren Sie den Pool, entsperren Sie ein verschlüsseltes Dataset und mounten Sie das Installations-Dataset vor der Installation. Das Dataset muss beschreibbar sein und die Ausführung erlauben, und der Pfad muss die oben genannten Anforderungen an Eigentümerschaft und Berechtigungen für benutzerdefinierte Verzeichnisse erfüllen.

  3. Verwenden Sie den oben genannten einzeiligen Befehl mit benutzerdefiniertem Verzeichnis und Ihrem TrueNAS-Pfad in LEVEL_INSTALL_DIR. Der Installer prüft das gemountete ZFS-Dataset vor dem Fortfahren.

  4. Überprüfen Sie nach der Installation TrueNAS Init/Shutdown-Skripte für den automatisch registrierten Level Agent-Startdienst Aufgabe. Es handelt sich um eine aktivierte Befehl Aufgabe, eingestellt auf Post Init. Lassen Sie diese Aufgabe aktiviert und bewahren Sie das Installationsverzeichnis und seine Startdateien. Sie müssen keine zweite Startaufgabe manuell erstellen.

Der Installer speichert Level.service, 10-truenas.conf, und start-level.sh im Installationsverzeichnis. Beim Booten wartet der Post-Init-Befehl, bis das gespeicherte Startskript lesbar ist, und prüft alle 60 Sekunden. Das Skript stellt die Laufzeiteinheit unter /run/systemd/system/Level.service und sein Mount-Anforderungs-Drop-in unter /run/systemd/system/Level.service.d/10-truenas.conf, dann startet den Dienst.

Das Installations-Dataset muss verfügbar sein, damit der Agent ausgeführt werden kann. Wenn es nach dem Booten verschlüsselt und gesperrt bleibt, entsperren und mounten Sie es über Ihren normalen TrueNAS-Speicher-Workflow. Die Startaufgabe entsperrt das Dataset nicht für Sie.


Zwangsinstallation (Erweitert)

Wenn eine frühere Level-Installation veraltete Dateien hinterlassen hat, verwenden Sie den forceInstall URL-Parameter, um eine saubere Überschreibung zu erzwingen.

Navigieren Sie zu:

https://app.level.io/devices?forceInstall=true

Dadurch wird LEVEL_FORCE_INSTALL=true zum generierten Einzeiler-Befehl.

⚠️ WARNUNG: Die Zwangsinstallation überschreibt jede vorhandene Level-Agent-Konfiguration auf dem Gerät. Verwenden Sie diese Option nur, wenn eine Standardinstallation fehlschlägt oder der Level-Support Sie dazu anweist.


Systemanforderungen

Unterstützte Distributionen

Distribution

Mindestversion

AlmaLinux

Aktuelle stabile Version

Arch Linux

Aktuelle stabile Version

CentOS

8

Debian

10

Fedora

36

Fedora Silverblue / COSMIC Atomic (rpm-ostree)

Aktuelle stabile Version

Linux Mint

20

Photon OS (VMware)

Aktuelle stabile Version

Raspbian (Raspberry Pi OS)

Aktuelle stabile Version

Red Hat Enterprise Linux (RHEL)

8

Rocky Linux

8

Sangoma Linux

Aktuelle stabile Version

Ubuntu

20.04 LTS

🖥️ PLATTFORMHINWEIS: rpm-ostree-Systeme wie Fedora Silverblue und COSMIC Atomic werden unterstützt. Der Agent schreibt seine systemd-Neustartverzögerung über ein Drop-in und speichert Desktop-Einträge unter /usr/local/share, sodass keine schreibgeschützten Systempfade beschrieben werden. Ausstehende rpm-ostree-Deployments werden für Neustart-Prüfungen erkannt.

ℹ️ HINWEIS: Andere Distributionen funktionieren möglicherweise, werden aber nicht offiziell unterstützt. Wenn Sie auf einer nicht aufgeführten Distribution auf Probleme stoßen, wenden Sie sich an den Level-Support.

Erforderliche Abhängigkeiten

Die folgenden Pakete müssen vor der Installation auf dem Zielsystem vorhanden sein:

  • sudo

  • systemd (für die Dienstverwaltung)

  • dbus oder eine UUID in /etc/machine-id

  • curl

  • ca-certificates

  • bash

Die meisten unterstützten Distributionen enthalten diese standardmäßig. Überprüfen Sie bei minimalen Installationen vor dem Ausführen des Level-Installationsbefehls, ob sie vorhanden sind.


Speicherorte

Die folgenden Pfade sind die Standard-Binär- und Datenspeicherorte. Die Standard-Konfigurationsdatei ist /etc/level/config.yaml.

Pfad

Zweck

/usr/local/bin/level

Agent-Binärdatei

/var/lib/level

Agent-Daten

Speicher für benutzerdefiniertes Verzeichnis

Mit /srv/level als benutzerdefiniertes Installationsverzeichnis ausgewählt, verwendet Level:

  • /srv/level/bin/level für die Agent-Binärdatei.

  • /srv/level/config.yaml für die Konfiguration.

  • /srv/level für Anwendungsdaten, einschließlich Protokolle und die lokale Datenbank.

Der systemd-Dienst behält das ausgewählte Verzeichnis in seinem --install-dir Argument. Ersetzen Sie für TrueNAS Ihren /mnt/... Installationspfad; die oben beschriebenen gespeicherten Startdateien verbleiben ebenfalls in diesem Verzeichnis.


Nach der Installation

Das Gerät erscheint in Ihrer Geräteliste innerhalb von 5–10 Sekunden und beginnt innerhalb weniger Minuten, den Hardware-Bestand zu erfassen.

Wenn das Gerät nicht erscheint, siehe Offline-Fehlerbehebung für nächste Schritte.


Häufig gestellte Fragen

  • Ist der Installationsschlüssel dasselbe wie ein API-Schlüssel? Nein. Der Installationsschlüssel (aus Neues Gerät hinzufügen) registriert nur Geräte in Ihrem Konto. API-Schlüssel (aus Einstellungen → API-Schlüssel) externe Tools gegenüber der Level-API authentifizieren. Sie können den Agenten nicht mit einem API-Schlüssel installieren. Verwenden Sie den Installationsschlüssel aus dem Installations-Modal. Siehe Einstellungen für API-Schlüssel.

  • Muss ich den Installationsbefehl als Root ausführen? Ja, der Agent benötigt erhöhte Rechte zur Installation. Der Einzeiler-Befehl enthält sudo automatisch. Führen Sie für den manuellen Installer den Befehl mit sudo oder direkt als Root.

  • Welche Architektur soll ich auf der Installer-Registerkarte auswählen? Wählen Sie x64 für Standard-64-Bit-Intel/AMD-Systeme und ARM für ARM-basierte Geräte (einschließlich Raspberry Pi). Der Einzeiler-Befehl erkennt die Architektur automatisch.

  • Kann ich Level auf Fedora Silverblue oder COSMIC Atomic installieren? Ja. Diese rpm-ostree-Systeme sind in der Unterstützungstabelle aufgeführt. Verwenden Sie den nativen Installer. Der Agent schreibt nicht in schreibgeschützte Systempfade. Andere unveränderliche Distributionen funktionieren möglicherweise, wenn sie die Abhängigkeitsanforderungen erfüllen, werden aber nicht offiziell getestet.

  • Meine Linux-Distribution ist nicht auf der Unterstützungsliste – funktioniert Level trotzdem? Möglicherweise. Level unterstützt die meisten modernen Distributionen mit systemd. Wenn Ihre Distribution die Abhängigkeitsanforderungen erfüllt, funktioniert sie möglicherweise problemlos. Wenden Sie sich an den Level-Support, wenn Sie auf Probleme stoßen.

  • Das Gerät wurde installiert, erscheint aber nicht in Level – was ist falsch? Warten Sie 10–15 Sekunden und aktualisieren Sie die Seite. Wenn das Gerät immer noch nicht erscheint, überprüfen Sie, ob systemd ausgeführt wird und alle erforderlichen Abhängigkeiten (curl, dbus, usw.) während der Installation vorhanden waren. Siehe Offline-Fehlerbehebung für weitere Schritte.

  • Was ist zu tun, wenn mein Installationsschlüssel kompromittiert wurde? Der Installationsschlüssel kann weder auf Ihr Konto, vorhandene Geräte noch auf die Level-API zugreifen. Das einzige Risiko besteht darin, dass jemand Geräte zu Ihrem Konto hinzufügt. Wenden Sie sich bei Bedarf an den Level-Support, um den Schlüssel zu rotieren.

  • Kann ich den Agenten auf vielen Linux-Geräten gleichzeitig bereitstellen? Ja. Verwenden Sie den Einzeiler-Befehl mit Ihren vorhandenen Tools (Ansible, Puppet, Chef, Bash über SSH usw.).

  • Wer kann Geräte zu Level hinzufügen? Jeder Techniker mit der Berechtigung, die Zielgerätegruppe zu verwalten, oder jeder Techniker, wenn die Bereitstellung in „Ohne Gruppe" erfolgt. Überprüfen Sie Arbeitsbereich → Berechtigungen wenn die Neues Gerät hinzufügen Schaltfläche.

Hat dies deine Frage beantwortet?