Zum Hauptinhalt springen

Befehlszeilenschnittstelle

Während die meisten Aufgaben in Unraid über die WebGUI ausgeführt werden können, erfordern bestimmte Operationen - insbesondere solche, die mit der Diagnose, der Laufwerksverwaltung oder dem Scripting in Zusammenhang stehen - die Verwendung der Systemkonsole oder des SSH Terminals. Diese Seite bietet Unraid-spezifische Befehlszeilen-Tools und Beispiele, die ohne umfangreiche Linux-Kenntnisse verwendet werden können.

Device Wege

Viele Festplattenoperationen auf Unraid basieren auf Linux-Gerätenamen wie /dev/sdX. Sie können die Gerätekennung für jedes Laufwerk im Main-Tab der WebGUI finden. Suchen Sie nach dem dreibuchstabigen Label sdX oder nvmeX neben jeder Festplatte. Verwenden Sie den entsprechenden Bezeichner in allen Befehlen, indem Sie sdX durch Ihre spezifische Festplatte ersetzen.

Zugriff auf das Terminal​

Unraid enthält ein integriertes Web-Terminal, auf das Sie direkt über die WebGUI zugreifen können. Verwenden Sie einfach das Dropdown-Menü oben rechts und wählen Sie ">_". Dies öffnet eine Befehlszeilensitzung als root user, die Ihnen vollständigen administrativen Zugriff auf Ihr System gewährt.

Sie können auch extern über SSH (Secure Shell) mit einem Client wie PuTTY auf Ihren Unraid-Server zugreifen.

:::tip[When Sollte ich das Terminal verwenden?

If you're using Windows, you might prefer PuTTY for SSH access instead of the built-in terminal. It's lightweight, free, and allows you to save sessions for easy access later.

  • Ausführen von Diagnosen und Befehlszeilentools wie smartctl, xfs_repair, tail oder top.
  • Ausführen von Plugin-Skripten oder Tools, die keine Benutzeroberfläche erfordern.
  • Fehlerbehebung bei Problemen mit der Konnektivität, Systemdiensten oder user shares.

:::

Laufwerktests und Überwachung​

If you're using Windows, you might prefer PuTTY for SSH access instead of the built-in terminal. It's lightweight, free, and allows you to save sessions for easy access later.

Wie man PuTTY installiert und verwendet - Klicken Sie, um ausklappen/einklappen
  1. Laden Sie PuTTY von der offiziellen Website herunter.
  2. Starten Sie die PuTTY-Anwendung.
  3. Geben Sie die IP-Adresse oder den Hostnamen Ihres Unraid-Servers ein (z. B. tower.local).
  4. Stellen Sie den Verbindungstyp auf %%SSH|ssh%% ein.
  5. (Optional) Speichern Sie den Sitzungsnamen für die zukünftige Nutzung.
  6. Klicken Sie auf Öffnen, um die Sitzung zu starten.
  7. Geben Sie bei der Aufforderung root ein und dann Ihr Passwort.

Sobald Sie sich angemeldet haben, befinden Sie sich in der Unraid-Shell-Umgebung. Tippen Sie exit, um die Sitzung zu schließen, wenn Sie fertig sind.

notiz

Unraid konfiguriert den SSH-Server automatisch beim ersten Start. Stellen Sie sicher, dass Ihre Netzwerkverbindung ordnungsgemäß funktioniert und dass Ihr Root-Passwort gesetzt ist, bevor Sie eine Remoteverbindung herstellen.

Laufwerktests und Überwachung​

Diese Tools helfen dabei, die Leistung zu bewerten, den Zustand der Laufwerke zu überprüfen und die Langsamkeit des arrays zu beheben. Alle Befehle sollten vom Terminal oder über SSH ausgeführt werden.

diskspeed.sh​

Dieses Skript ermöglicht umfassende Oberflächen-Leistungsprüfungen mit visuellen Berichten.

Diskspeed.sh-Nutzung anzeigen - Klicken Sie, um ausklappen/einklappen

Früher war dies ein Skript, das Sie aus den Unraid-Foren heruntergeladen haben. DiskSpeed ist jetzt in einem verfeinerten Paket erhältlich:

hdparm -tT /dev/sdX

Das -t-Flag testet gepufferte Festplattenlesevorgänge, während -T Cache-Lesevorgänge testet. Dies misst hauptsächlich die sequentielle Leseleistung und hilft dabei, ungewöhnlich langsame Laufwerke zu identifizieren.

Führen Sie mehrere Tests zur Genauigkeit durch:

for ((i=0;i<5;i++)); do hdparm -tT /dev/sdX; done

Laufwerksinformationen anzeigen:

hdparm -I /dev/sdX

Dies zeigt das Modell, die Firmware, die Cache-Größe und unterstützte Funktionen an, was hilft, den Datenträgertyp und das Controllerverhalten zu überprüfen.

smartctl​

Dieser Befehl führt SMART Diagnosen durch und überwacht die Gesundheit der Laufwerke.

Smartctl-Optionen anzeigen - Klicken Sie, um ausklappen/einklappen

Basis %%SMART|SMART%% Bericht:

smartctl -a /dev/sdX

Wenn dieser Befehl einen Fehler anzeigt, versuchen Sie, den Gerätetyp anzugeben: smartctl -a -d ata /dev/sdX (verwenden Sie -d nvme für NVMe-Laufwerke).

%SMART|smart%% Selbsttests starten:

Kurzer Test (dauert einige Minuten)

smartctl -t short /dev/sdX

Erweiterter Test (kann Stunden dauern)

smartctl -t long /dev/sdX

Speichern Sie SMART-Bericht in einer Datei:

smartctl -a /dev/sdX > /boot/smart_report.txt

Dies speichert den Bericht auf Ihrem Unraid-Flash-Laufwerk zur späteren Überprüfung oder zum Teilen im Forum.

top​

Dieser Befehl bietet eine Echtzeitüberwachung von Prozessen und Ressourcen.

Top-Nutzung anzeigen - Klicken Sie, um ausklappen/einklappen

Früher war dies ein Skript, das Sie aus den Unraid-Foren heruntergeladen haben. DiskSpeed ist jetzt in einem verfeinerten Paket erhältlich:

Installieren Sie DiskSpeed über Community-Anwendungen (Apps-Tab) durch die Suche nach "DiskSpeed" oder besuchen Sie das GitHub-Repository für manuelle Installationsanweisungen.

Systemüberwachung​

Verwenden Sie diese Befehle, um Speicher, Prozesse und Systemleistung zu überwachen, wenn der WebGUI nicht verfügbar ist oder für detailliertere Diagnosen.

ps​

Verwenden Sie diesen Befehl, um laufende Prozesse mit detaillierten Informationen anzuzeigen.

Ps-Optionen anzeigen - Klicken Sie, um ausklappen/einklappen
top
  • Zeigt die CPU- und Speichernutzung für jeden Prozess in Echtzeit an.
  • Drücken Sie q, um den Vorgang zu beenden.
  • Verwenden Sie die Pfeiltasten zum Scrollen und k, um Prozesse zu beenden.

Nach Speicherverbrauch sortieren:

frei​

Dieser Befehl zeigt Speicherverbrauchsstatistiken an.

Freie Nutzung anzeigen - Klicken Sie, um ausklappen/einklappen
free -h

Dies zeigt die RAM-Nutzung in einem menschenlesbaren Format an. Das -h-Flag bedeutet, dass die Größenangaben in KB, MB oder GB anstatt in Bytes angezeigt werden.

Das Ausgabeergebnis verstehen

Eine niedrige "verfügbare" Speicheranzeige weist nicht unbedingt auf ein Problem hin, da Linux aggressiv Daten für Leistungszwecke zwischenspeichert.

df​

Dieser Befehl zeigt die Nutzung des Dateisystem-Speicherplatzes an.

Df-Nutzung anzeigen - Klicken Sie, um ausklappen/einklappen

Alle Prozesse mit vollständigen Details auflisten:

ps aux
Hinweis

Erwägen Sie die Verwendung von htop für eine benutzerfreundlichere Schnittstelle mit erweiterten Steuerungen.

ps aux --sort=-%mem | head -20

Nach CPU-Nutzung sortieren:

ps aux --sort=-%cpu | head -20

Speicher-Utilities​

Diese Befehle helfen, den Speicherplatzverbrauch, Partitionsinformationen zu überprüfen und Speichereinheiten zu identifizieren.

lsblk​

Listet alle Blockgeräte in Baumstruktur auf.

Lsblk-Nutzung anzeigen - Klicken Sie, um ausklappen/einklappen
df -h

Dieser Befehl zeigt den verwendeten und verfügbaren Speicherplatz auf allen eingebundenen Dateisystemen an. Er ist praktisch zum Überprüfen von /var/log (das RAM-basiertes Logging nutzt) in Unraid. Für weitere Informationen zum System Logging.

blockdev -getsz​

Hilft zu bestimmen, ob ein Ersatzlaufwerk ausreichend Speicherplatz für den Wiederaufbau hat.

Blockdev-Nutzung anzeigen - Klicken Sie, um ausklappen/einklappen
fdisk -l /dev/sdX

Dieser Befehl zeigt das Partitionslayout, die Größen und die Plattenspeicherung an. Er hilft beim Beheben von Problemen mit unpassenden Plattengrößen, besonders beim Ersetzen von Platten.

blkid​

Dateisystembeschriftungen identifizieren.

Blkid-Nutzung anzeigen - Klicken Sie, um ausklappen/einklappen
lsblk

Dieser Befehl zeigt den verwendeten und verfügbaren Speicherplatz auf allen eingebundenen Dateisystemen an. Er ist praktisch zum Überprüfen von /var/log (das RAM-basiertes Logging nutzt) in Unraid. Für weitere Informationen zum System Logging.

blockdev -getsz​

Hilft zu bestimmen, ob ein Ersatzlaufwerk ausreichend Speicherplatz für den Wiederaufbau hat.

Fdisk-Nutzung anzeigen - Klicken Sie, um ausklappen/einklappen

Syntax:

blockdev --getsz /dev/sdX

Gibt die rohen Anzahl der 512-Byte-Sektoren eines Geräts zurück - praktisch, um zu bestätigen, dass ein Ersatzlaufwerk groß genug ist, bevor der Wiederaufbau beginnt.

ss​

Socket-Statistiken und Netzwerkverbindungen anzeigen. Dies ist der moderne Ersatz für netstat.

Ss-Optionen anzeigen - Klicken Sie, um ausklappen/einklappen

Syntax:

blkid /dev/sdX1

Gibt den Dateisystemtyp und das Label aus. Verwenden Sie dies anstelle des veralteten vol_id-Befehls, um zu überprüfen, dass das Unraid-Flash mit UNRAID beschriftet ist.

Netzwerkdiagnosen​

Werkzeuge zur Fehlerbehebung bei Netzwerkverbindungen und Interface-Konfiguration.

ping​

Netzwerkkonnektivität testen.

Ping-Nutzung anzeigen - Klicken Sie, um ausklappen/einklappen

Konnektivität testen, indem eine begrenzte Anzahl von Paketen gesendet wird:

ss -tuln
  • -t: TCP-Sockets
  • -u: UDP-Sockets
  • -l: Zeigt nur lauschende Sockets an
  • -n: Zeigt Portnummern anstelle von Servicenamen

Etablierten Verbindungen anzeigen:

ss -tup

Dieser Befehl zeigt aktive Verbindungen zusammen mit Prozessinformationen an.

ethtool​

Ein praktisches Werkzeug zum Abfragen und Anpassen von Parametern der Netzwerkschnittstellenkarte (NIC), wie Link-Geschwindigkeit, Offload-Funktionen und Statistik.

Ethtool-Nutzung anzeigen - Klicken Sie, um ausklappen/einklappen

Grundlegende Treiber- und Firmware-Informationen:

ip addr show

Netzwerkschnittstellen mit Farben anzeigen:

ip -c addr show

Um die aktuelle Link-Geschwindigkeit und Einstellungen Ihrer Schnittstelle zu prüfen, führen Sie aus:

ip route show

ping​

Netzwerkkonnektivität testen.

Ss-Optionen anzeigen - Klicken Sie, um ausklappen/einklappen

Alle offenen Ports anzeigen:

ping -c 4 google.com

Dieser Befehl sendet vier Pakete an das Ziel und stoppt, was ihn für grundlegende Konnektivitätstests ohne kontinuierliche Ausgabe geeignet macht.

ethtool​

Ein praktisches Werkzeug zum Abfragen und Anpassen von Parametern der Netzwerkschnittstellenkarte (NIC), wie Link-Geschwindigkeit, Offload-Funktionen und Statistik.

IP-Optionen anzeigen - Klicken Sie, um ausklappen/einklappen

Alle Netzwerkschnittstellen anzeigen:

Verwenden Sie diesen Befehl, um Informationen über den Treiber und die Firmware Ihrer Netzwerkschnittstelle zu erhalten:

ethtool -i eth0

Aktuelle Link-Geschwindigkeit und Einstellungen anzeigen:

Routing-Tabelle anzeigen:

ethtool eth0

Erweiterte Schnittstellenstatistiken anzeigen:

Für erweiterte Statistiken im Zusammenhang mit der Schnittstelle verwenden Sie den folgenden Befehl:

ethtool -S eth0

Diese Befehle können helfen, die Verhandlungsraten für Gigabit, 2.5 GbE oder 10 GbE-Verbindungen zu bestätigen, Probleme mit Kabeln zu diagnostizieren oder verlorene Pakete zu identifizieren, die aufgrund von Offload-Unstimmigkeiten auftreten könnten.

tail​

Protokolldateien in Echtzeit überwachen.

CPU-Architekturzusammenfassung:

lscpu

Dieser Befehl zeigt Informationen über Kerne, Threads, Virtualisierungsunterstützung und Cache-Details an.

Feature-Erkennung:

grep -E 'lm|vmx|svm' /proc/cpuinfo
  • lm: Zeigt 64-Bit-Unterstützung an
  • vmx: Intel VT-x Virtualisierung
  • svm: AMD-V Virtualisierung

Systemwartung​

Befehle zum Herunterfahren des Systems, zur Protokollüberwachung und zur Dienstverwaltung.

tail​

Protokolldateien in Echtzeit überwachen.

Verwendung von tail anzeigen - Zum Erweitern/Reduzieren klicken
tail -f /var/log/syslog

Dieser Befehl zeigt Live-Updates aus dem Systemprotokoll an. Zum Beenden verwenden Sie Strg+C.

Eine bestimmte Anzahl von Zeilen anzeigen:

tail -n 50 /var/log/syslog

powerdown​

System sicher herunterfahren.

Verwendung von powerdown anzeigen - Zum Erweitern/Reduzieren klicken
powerdown

Dieser Befehl verwendet den eingebauten Abschaltvorgang von Unraid, um das array zu stoppen und das System sicher herunterzufahren. Es wird der manuellen Abschaltung vorgezogen.