Xauthority

Last published : Nov 13, 2026
Der Linux VDA unterstützt Umgebungen, die X11-Anzeigefunktionen (einschließlich xterm und gvim) für interaktives Remoting verwenden. Diese Funktion bietet einen Sicherheitsmechanismus, der für eine sichere Kommunikation zwischen XClient und XServer erforderlich ist.
Es gibt zwei Methoden, um die Berechtigung für diese sichere Kommunikation zu sichern:
  • Xhost. Standardmäßig erlaubt Xhost nur dem localhost XClient, mit XServer zu kommunizieren. Wenn Sie einem Remote-XClient den Zugriff auf XServer erlauben möchten, muss der Xhost-Befehl ausgeführt werden, um die Berechtigung auf dem spezifischen Computer zu erteilen. Alternativ können Sie xhost + verwenden, um jedem XClient die Verbindung zu XServer zu ermöglichen.
  • Xauthority. Die .Xauthority-Datei befindet sich im Home-Verzeichnis jedes Benutzers. Sie wird verwendet, um Anmeldeinformationen in Cookies zu speichern, die von xauth zur Authentifizierung von XServer verwendet werden. Wenn eine XServer-Instanz (Xorg) gestartet wird, wird der Cookie verwendet, um Verbindungen zu dieser spezifischen Anzeige zu authentifizieren.

Funktionsweise

Wenn Xorg startet, wird eine .Xauthority-Datei an Xorg übergeben. Diese .Xauthority-Datei enthält die folgenden Elemente:
  • Anzeigenummer
  • Remote-Anforderungsprotokoll
  • Cookie-Nummer
Sie können diese Datei mit dem xauth-Befehl durchsuchen. Zum Beispiel:
# xauth -f ~/.Xauthority

# > list

# > us01msip06:107  MIT-MAGIC-COOKIE-1  fb228d1b695729242616c5908f11624b
Wenn XClient sich remote mit Xorg verbindet, müssen zwei Voraussetzungen erfüllt sein:
  • Legen Sie die Umgebungsvariable DISPLAY auf den Remote-XServer fest.
  • Rufen Sie die .Xauthority-Datei ab, die eine der Cookie-Nummern in Xorg enthält.

Xauthority konfigurieren

Um Xauthority auf dem Linux VDA für die Remote-X11-Anzeige zu aktivieren, müssen Sie die folgenden zwei Registrierungsschlüssel erstellen:
sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Xorg" -t "REG_DWORD" -v "XauthEnabled" -d "0x00000001" --force

sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Xorg" -t "REG_DWORD" -v "ListenTCP" -d "0x00000001" --force
Nach dem Aktivieren von Xauthority übergeben Sie die .Xauthority-Datei manuell oder durch Einbinden eines freigegebenen Home-Verzeichnisses an den XClient:
  • Übergeben Sie die .Xauthority-Datei manuell an den XClient
    Nach dem Starten einer ICA®-Sitzung generiert der Linux VDA die .Xauthority-Datei für den XClient und speichert die Datei im Home-Verzeichnis des angemeldeten Benutzers. Sie können diese .Xauthority-Datei auf die Remote-XClient-Maschine kopieren und die Umgebungsvariablen DISPLAY und XAUTHORITY festlegen. DISPLAY ist die in der .Xauthority-Datei gespeicherte Anzeigenummer und XAUTHORITY ist der Dateipfad von Xauthority. Ein Beispiel finden Sie im folgenden Befehl:
    export DISPLAY={Display number stored in the Xauthority file}

    export XAUTHORITY={the file path of .Xauthority}
    Hinweis:
    Wenn die Umgebungsvariable XAUTHORITY nicht festgelegt ist, wird standardmäßig die ~/.Xauthority-Datei verwendet.
  • Übergeben Sie die .Xauthority-Datei an den XClient, indem Sie ein freigegebenes Home-Verzeichnis einbinden
    Der bequemste Weg ist, ein freigegebenes Home-Verzeichnis für den angemeldeten Benutzer einzubinden. Wenn der Linux VDA eine ICA-Sitzung startet, wird die .Xauthority-Datei im Home-Verzeichnis des angemeldeten Benutzers erstellt. Wenn dieses Home-Verzeichnis mit dem XClient geteilt wird, muss der Benutzer diese .Xauthority-Datei nicht manuell an den XClient übertragen. Nachdem die Umgebungsvariablen DISPLAY und XAUTHORITY korrekt festgelegt wurden, wird die GUI automatisch auf dem XServer-Desktop angezeigt.

Problembehandlung

Wenn Xauthority nicht funktioniert, führen Sie die folgenden Schritte zur Fehlerbehebung aus:
  1. Rufen Sie als Administrator mit Root-Berechtigung alle Xorg-Cookies ab:
    ps aux | grep -i xorg
    Dieser Befehl zeigt den Xorg-Prozess und die Parameter an, die beim Starten an Xorg übergeben wurden. Ein weiterer Parameter zeigt an, welche .Xauthority-Datei verwendet wird. Zum Beispiel:
    /var/xdl/xauth/.Xauthority110
    Zeigen Sie die Cookies mit dem Befehl Xauth an:
    Xauth -f /var/xdl/xauth/.Xauthority110
  2. Verwenden Sie den Befehl Xauth, um die in ~/.Xauthority enthaltenen Cookies anzuzeigen. Für dieselbe Anzeigenummer müssen die angezeigten Cookies in den .Xauthority-Dateien von Xorg und XClient identisch sein.
  3. Wenn die Cookies identisch sind, überprüfen Sie die Erreichbarkeit des Remote-Anzeigeports, indem Sie die IP-Adresse des Linux VDA und die Anzeigenummer des veröffentlichten Desktops verwenden.
    Führen Sie beispielsweise den folgenden Befehl auf der XClient-Maschine aus:
    telnet 10.158.11.11 6160
    Die Portnummer ist die Summe aus 6000 + \<Anzeigenummer\>.
    Wenn dieser Telnet-Vorgang fehlschlägt, blockiert möglicherweise die Firewall die Anforderung.