> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/de/nas/nas-diagnostics.md). # Leitfaden zur NAS-Diagnose ## Übersicht Das NAS-(Network Attached Storage)-Diagnosetool bietet umfassende Funktionen zur Fehlerbehebung bei Dateifreigaben und Netzwerkspeicher innerhalb von VergeOS. Diese Diagnosebefehle ermöglichen es Systemadministratoren, die NAS-Leistung zu überwachen, Probleme bei Dateifreigaben zu beheben und einen optimalen Zustand der NAS-Dienste für SMB/CIFS, NFS und andere Netzwerkspeicherprotokolle aufrechtzuerhalten. {% hint style="info" %} **Was Sie lernen werden** * Wie Sie auf NAS-Diagnosetools zugreifen und sie verwenden * Verständnis der einzelnen Diagnosebefehle und ihres Fokus auf Dateifreigaben * Best Practices für die NAS-Fehlerbehebung und -Wartung * Wann bestimmte Diagnosebefehle für Probleme mit Netzwerkspeicher verwendet werden sollten {% endhint %} ## Voraussetzungen * Zugriff auf die VergeOS-Oberfläche mit Berechtigungen zur Verwaltung des NAS-Dienstes * Grundkenntnisse der Netzwerk-Dateifreigabeprotokolle (SMB/CIFS, NFS) * Kenntnisse der NAS-Dienstarchitektur von VergeOS {% hint style="info" %} **Kontext des NAS-Dienstes** NAS-Diagnosen sind spezifisch für einzelne NAS-Dienstinstanzen. Jeder NAS-Dienst hat seine eigene Diagnoseoberfläche und eigene Befehle. {% endhint %} ## Auf NAS-Diagnosen zugreifen 1. **Navigieren Sie zu NAS-Diagnosen:** * Wählen Sie **NAS** > **Liste** im oberen Menü aus. * Doppelklicken Sie auf den gewünschten **NAS-Dienst** aus der Liste * Klicken Sie **Diagnosen** im linken Menü 2. **Diagnosebefehle verwenden:** * Wählen Sie den gewünschten Befehl aus dem **Diagnoseabfrage** Dropdown-Menü * Konfigurieren Sie die verfügbaren Parameter auf der rechten Seite * Klicken Sie **Senden →** um den Befehl auszuführen {% hint style="success" %} **Sichtbarkeit der Befehle** Aktivieren Sie **„Befehl anzeigen“** um den exakt ausgeführten Befehl anzuzeigen; nützlich für die Ausführung per SSH oder die Skriptautomatisierung. {% endhint %} ## Referenz der Diagnosebefehle ### ARP-Scan **Zweck:** Ermittelt aktive Geräte im Netzwerk des NAS-Dienstes mithilfe von ARP-Paketen. **Wann verwenden:** * Fehlerbehebung bei Netzwerkverbindungen * Erkennung von Clients in NAS-Netzwerksegmenten * Überprüfung der Netzwerktopologie **Parameter:** * **Schnittstelle:** Netzwerkschnittstelle, von der aus gescannt werden soll (z. B. eth0) **CLI-Syntax:** ```bash nmap -sn [NETZWERKBEREICH] ``` *** ### ARP-Tabelle **Zweck:** Zeigt den ARP-Cache des NAS-Dienstes mit Zuordnungen von IP- zu MAC-Adressen an. **Wann verwenden:** * Fehlerbehebung bei Client-Konnektivität * Überprüfung von Netzwerk-Nachbarn * Behebung von Konflikten bei MAC-Adressen **CLI-Syntax:** ```bash arp -a ``` *** ### Datum/Uhrzeit **Zweck:** Zeigt die aktuelle Datum- und Uhrzeitkonfiguration des NAS-Dienstes an. **Wann verwenden:** * Fehlerbehebung bei der Zeitsynchronisierung * Überprüfung von Zeitstempeln in Protokollen * Diagnose von Authentifizierungsproblemen (Kerberos, Domänenbeitritte) **CLI-Syntax:** ```bash date timedatectl status ``` *** ### DNS-Abfrage **Zweck:** Testet die DNS-Auflösung aus Sicht des NAS-Dienstes. **Wann verwenden:** * Fehlerbehebung bei der Auflösung von Domänennamen * Probleme bei der Active-Directory-Verbindung * Überprüfung des Zugriffs auf externe Dienste **Parameter:** * **Hostname:** Zu auflösender Ziel-Hostname * **DNS-Server:** Spezifischer DNS-Server, der abgefragt werden soll **CLI-Syntax:** ```bash nslookup [HOSTNAME] dig [HOSTNAME] ``` *** ### Gruppen **Zweck:** Zeigt Systemgruppen und Informationen zur Gruppenmitgliedschaft an. **Wann verwenden:** * Fehlerbehebung beim Benutzerzugriff * Diagnose von Berechtigungsproblemen * Überprüfung der gruppenbasierten Zugriffskontrolle **CLI-Syntax:** ```bash getent group groups [BENUTZERNAME] ``` *** ### IP **Zweck:** Erweiterter Zugriff auf IP-Befehle für die Diagnose von Netzwerkschnittstellen und Routing. **Wann verwenden:** * Überprüfung der Netzwerkkonfiguration * Analyse der Routing-Tabelle * Fehlerbehebung bei Schnittstellen **Parameter:** * **Befehl:** IP-Befehlsoptionen (addr, route, link usw.) **CLI-Syntax:** ```bash ip [BEFEHL] [OPTIONEN] ``` **Häufige Befehle:** * `ip addr show` - Schnittstellenadressen anzeigen * `ip route show` - Routing-Tabelle anzeigen * `ip link show` - Netzwerkschnittstellen anzeigen *** ### Protokolle **Zweck:** Zeigt Systemprotokolle und Ereignisse des NAS-Dienstes an. **Wann verwenden:** * Fehlerbehebung beim Dienst * Fehleranalyse * Untersuchung von Leistungsproblemen * Überwachung von Sicherheitsereignissen **CLI-Syntax:** ```bash journalctl -u [NAS_DIENST] tail -f /var/log/samba/log.* ``` *** ### NFS **Zweck:** Zeigt den Status und die Konfiguration des Network File System-(NFS-)Dienstes an. **Wann verwenden:** * Fehlerbehebung beim NFS-Dienst * Überprüfung der Exportkonfiguration * Diagnose von Problemen beim Client-Mount **CLI-Syntax:** ```bash exportfs -v rpcinfo -p showmount -e ``` *** ### NTP-Abfrage **Zweck:** Fragt Network-Time-Protocol-(NTP-)Server und den Synchronisationsstatus ab. **Wann verwenden:** * Fehlerbehebung bei der Zeitsynchronisierung * Test der NTP-Server-Konnektivität * Analyse der Uhrzeitabweichung **Parameter:** * **NTP-Server:** Ziel-NTP-Server, der abgefragt werden soll **CLI-Syntax:** ```bash ntpq -p chrony sources ``` *** ### Ping **Zweck:** Testet die Netzwerkverbindung vom NAS-Dienst aus. **Wann verwenden:** * Test der grundlegenden Konnektivität * Messung der Netzwerklatenz * Überprüfung der Erreichbarkeit des Clients **Parameter:** * **Ziel:** Ziel-IP-Adresse oder Hostname * **Anzahl:** Anzahl der Ping-Pakete **CLI-Syntax:** ```bash ping -c [ANZAHL] [ZIEL] ``` *** ### Samba **Zweck:** Zeigt den Status, die Konfiguration und aktive Verbindungen des Samba/SMB-Dienstes an. **Wann verwenden:** * Fehlerbehebung beim SMB/CIFS-Dienst * Probleme beim Zugriff auf Freigaben * Analyse von Client-Verbindungen * Leistungsoptimierung **CLI-Syntax:** ```bash smbstatus testparm smbclient -L localhost ``` *** ### Dienste **Zweck:** Zeigt den Status aller auf dem NAS-System laufenden Dienste an. **Wann verwenden:** * Überprüfung der Dienstverfügbarkeit * Fehlerbehebung bei Abhängigkeiten * Leistungsanalyse * Probleme beim Starten von Diensten **CLI-Syntax:** ```bash systemctl list-units --type=service service --status-all ``` *** ### TCP-Verbindungstest **Zweck:** Testet die TCP-Konnektivität zu bestimmten Ports auf Remote-Hosts. **Wann verwenden:** * Test der Erreichbarkeit von Dienstports * Überprüfung von Firewall-Regeln * Fehlerbehebung bei der Client-Server-Kommunikation **Parameter:** * **Host:** Ziel-Hostname oder IP-Adresse * **Port:** Zu testende TCP-Portnummer **CLI-Syntax:** ```bash telnet [HOST] [PORT] nc -zv [HOST] [PORT] ``` *** ### TCP-Dump **Zweck:** Erfasst und analysiert den Netzwerkpaketverkehr für den NAS-Dienst. **Wann verwenden:** * Tiefenanalyse von Paketen * Protokoll-Fehlerbehebung * Sicherheitsanalyse * Leistungsdiagnose **Parameter:** * **Schnittstelle:** Zu überwachende Netzwerkschnittstelle * **Filter:** Berkeley-Packet-Filter-Ausdruck **CLI-Syntax:** ```bash tcpdump -i [SCHNITTSTELLE] [FILTER] ``` {% hint style="warning" %} **Auswirkungen auf die Leistung** Das Erfassen von Paketen kann die NAS-Leistung beeinträchtigen. Verwenden Sie es in Produktionsumgebungen mit Bedacht. {% endhint %} *** ### Höchste CPU-Auslastung **Zweck:** Zeigt Prozesse an, die auf dem NAS-Dienst die meisten CPU-Ressourcen verbrauchen. **Wann verwenden:** * Fehlerbehebung bei der Leistung * Analyse der Ressourcenauslastung * Prozessoptimierung **CLI-Syntax:** ```bash top -o %CPU htop ``` *** ### Höchste Netzwerkauslastung **Zweck:** Zeigt Prozesse mit der höchsten Netzwerkauslastung an. **Wann verwenden:** * Analyse der Netzwerkleistung * Fehlerbehebung bei der Bandbreitenauslastung * Verbindungsüberwachung **CLI-Syntax:** ```bash iftop nethogs ss -tuln ``` *** ### Routenverfolgung **Zweck:** Verfolgt den Netzwerkpfad vom NAS-Dienst zu einem Ziel. **Wann verwenden:** * Fehlerbehebung beim Netzwerk-Routing * Pfadanalyse * Diagnose von Verbindungsproblemen **Parameter:** * **Ziel:** Ziel-IP-Adresse oder Hostname **CLI-Syntax:** ```bash traceroute [ZIEL] mtr [ZIEL] ``` *** ### Benutzer **Zweck:** Zeigt Systembenutzer und Informationen zu Benutzerkonten an. **Wann verwenden:** * Fehlerbehebung beim Benutzerzugriff * Kontenüberprüfung * Diagnose von Berechtigungsproblemen **CLI-Syntax:** ```bash getent passwd who w ``` *** ### Meine IP-Adresse **Zweck:** Zeigt die externe IP-Adresse des NAS-Dienstes an. **Wann verwenden:** * Überprüfung der externen Konnektivität * Fehlerbehebung bei NAT-Konfigurationen * Validierung der Netzwerkkonfiguration **CLI-Syntax:** ```bash curl ifconfig.me curl ipinfo.io/ip ``` *** ### Winbind **Zweck:** Zeigt den Status des Winbind-Dienstes für die Active-Directory-Integration an. **Wann verwenden:** * Fehlerbehebung bei der Active-Directory-Integration * Probleme bei der Domänenauthentifizierung * Probleme bei der Auflösung von Benutzern/Gruppen **CLI-Syntax:** ```bash wbinfo -t wbinfo -u wbinfo -g ``` ## Best Practices ### Workflow zur Überwachung des NAS-Zustands 1. **Dienststatus:** Dienste und den Status spezifischer Protokolle (Samba/NFS) prüfen 2. **Netzwerkkonnektivität:** Grundlegende Konnektivität mit Ping und der Netzwerkkonfiguration überprüfen 3. **Authentifizierung:** Benutzer, Gruppen und Winbind testen (falls zutreffend) 4. **Leistung:** Höchste CPU-Auslastung und höchste Netzwerkauslastung überwachen 5. **Protokolle:** Dienstprotokolle auf Fehler oder Warnungen überprüfen ### Fehlerbehebung bei Dateifreigaben * **SMB/CIFS-Probleme:** Samba-Diagnosen verwenden, um Freigaben und Verbindungen zu prüfen * **NFS-Probleme:** NFS-Dienststatus und Exportkonfigurationen überprüfen * **Berechtigungsprobleme:** Benutzer und Gruppen auf korrekte Zugriffsrechte prüfen * **Authentifizierung:** Winbind für Domänenumgebungen testen ### Leistungsoptimierung * **Ressourcenüberwachung:** CPU- und Netzwerkauslastungsmuster regelmäßig prüfen * **Verbindungsanalyse:** Aktive Verbindungen und Client-Lasten überwachen * **Netzwerkoptimierung:** Netzwerkdiagnosen zur Leistungsoptimierung verwenden * **Zeitsynchronisierung:** Sicherstellen, dass NTP für die Authentifizierung korrekt konfiguriert ist ## Häufige NAS-Probleme beheben ### Verbindungsprobleme 1. Beginnen Sie mit **Ping** um die grundlegende Netzwerkkonnektivität zu testen 2. Verwenden Sie **ARP-Tabelle** und **ARP-Scan** für Probleme bei der Netzwerkerkennung 3. Prüfen Sie **IP** die Konfiguration bei Schnittstellenproblemen 4. Verwenden Sie **Routenverfolgung** für Routing-Probleme ### Probleme bei Dateifreigaben 1. Prüfen Sie **Samba** Status für SMB/CIFS-Probleme 2. Überprüfen Sie **NFS** den Dienst bei NFS-bezogenen Problemen 3. Prüfen Sie **Dienste** für die Dienstverfügbarkeit 4. Testen Sie bestimmte Ports mit **TCP-Verbindungstest** ### Authentifizierungsprobleme 1. Überprüfen Sie **Benutzer** und **Gruppen** Konfiguration 2. Testen Sie **Winbind** für die Active-Directory-Integration 3. Prüfen Sie **DNS-Abfrage** für die Auflösung von Domänennamen 4. Überprüfen Sie **Datum/Uhrzeit** für die Kerberos-Authentifizierung ### Leistungsprobleme 1. Überwachen Sie **Höchste CPU-Auslastung** auf Ressourcenengpässe 2. Prüfen Sie **Höchste Netzwerkauslastung** auf Bandbreitenauslastung 3. Verwenden Sie **TCP-Dump** für eine detaillierte Verkehrsanalyse 4. Prüfen Sie **Protokolle** auf leistungsbezogene Fehler ## Erweiterte Diagnosen ### Protokollanalyse * Verwenden Sie **TCP-Dump** mit spezifischen Filtern für SMB- oder NFS-Verkehr * Überwachen Sie **Samba** Verbindungen bei SMB-spezifischen Problemen * Prüfen Sie **NFS** Exporte und Mount-Status ### Sicherheitsüberwachung * Prüfen Sie **Protokolle** für Sicherheitsereignisse und fehlgeschlagene Zugriffsversuche * Überwachen Sie **Benutzer** und **Gruppen** für unbefugte Änderungen * Verwenden Sie **TCP-Dump** bei Bedarf für Sicherheitsanalysen ### Netzwerkoptimierung * Analysieren Sie **Höchste Netzwerkauslastung** Muster zur Optimierung * Verwenden Sie **IP** Befehle für erweiterte Netzwerk-Tuning-Maßnahmen * Überwachen Sie **ARP-Tabelle** für Netzwerkeffizienz ## Aspekte der Integration ### Active-Directory-Integration * Verwenden Sie **Winbind** Diagnosen für die Domänen-Fehlerbehebung * Überprüfen Sie **DNS-Abfrage** für eine korrekte Domänenauflösung * Prüfen Sie **Datum/Uhrzeit** Synchronisierung mit Domänencontrollern ### Unterstützung mehrerer Protokolle * Ausbalancieren **Samba** und **NFS** der Dienstleistung * Protokollspezifische Nutzungsmuster überwachen * Netzwerkkonfiguration für mehrere Protokolle optimieren ## Nächste Schritte Nachdem Sie die NAS-Diagnosen beherrschen, sollten Sie Folgendes erkunden: * Erweiterte Optimierung von Dateifreigabeprotokollen * Integration mit externen Authentifizierungssystemen * Automatisierte Überwachung und Alarmierung für NAS-Dienste * Leistungsoptimierung für Hochverfügbarkeitsumgebungen Bei komplexen NAS-Problemen oder zur Unterstützung bei der Leistungsoptimierung kontaktieren Sie [VergeOS-Support](/overview/de/support-and-services.md) mit detaillierter Diagnoseausgabe und Informationen zur Dienstkonfiguration. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/run-the-platform/de/nas/nas-diagnostics.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.