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.
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.
Wählen Sie im Modal die Einzeiliger Befehl Registerkarte.
Optional eine Gerätegruppe auswählen.
Den generierten Befehl kopieren.
Öffnen Sie auf dem Zielgerät ein Terminal.
Führen Sie den Befehl aus. Wenn Sie nicht bereits Root sind, enthält der Befehl
sudo: Sie werden nach Ihrem Passwort gefragt.
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.
Wählen Sie im Modal die Installer Registerkarte.
Wählen Sie Ihre Architektur aus dem Dropdown-Menü: x64 oder ARM.
Optional eine Gerätegruppe auswählen.
Klicken Sie auf Installer herunterladen um die Binärdatei herunterzuladen.
Kopieren Sie den im Modal angezeigten Installationsbefehl.
Führen Sie auf dem Zielgerät den kopierten Befehl mit erhöhten Rechten aus.
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
noexecDateisystem 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
755ist 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/libals Installationsstamm.
Einzeiliger Befehl mit benutzerdefiniertem Verzeichnis
Kopieren Sie Ihren Linux-Einzeiler von Neues Gerät hinzufügen, einschließlich des Installationsschlüssels und einer eventuellen Gerätegruppenauswahl.
Fügen Sie
LEVEL_INSTALL_DIR="/srv/level"vorLEVEL_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.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.
Wählen Sie ein dediziertes Level-Verzeichnis oder Dataset auf einem ZFS-Speicherpool unter
/mnt/, zum Beispiel/mnt/tank/level. Ersetzen Sietankdurch Ihren Pool-Namen. Wählen Sie nicht den Boot-Pool oder den Speicherpool-Stamm selbst.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.
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.Ü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:
sudosystemd(für die Dienstverwaltung)dbusoder eine UUID in/etc/machine-idcurlca-certificatesbash
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 |
| Agent-Binärdatei |
| Agent-Daten |
Speicher für benutzerdefiniertes Verzeichnis
Mit /srv/level als benutzerdefiniertes Installationsverzeichnis ausgewählt, verwendet Level:
/srv/level/bin/levelfür die Agent-Binärdatei./srv/level/config.yamlfür die Konfiguration./srv/levelfü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
sudoautomatisch. Führen Sie für den manuellen Installer den Befehl mitsudooder 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.



