|
|
| Zeile 54: |
Zeile 54: |
|
| |
|
|
| |
|
| == Aufbau ==
| |
| ; Sektionen
| |
| {| class="wikitable options big"
| |
| |-
| |
| ! Parameter !! Beschreibung
| |
| |-
| |
| | [Globals] || Listener, Security, Performance-Flags, Laufzeit-User
| |
| |-
| |
| | [Logging] || Logziele und Loglevel
| |
| |-
| |
| | [Channels] || Aktivierung einzelner virtueller Kanäle
| |
| |-
| |
| | [Xorg]/[Xvnc] || weitere – Connection sections
| |
| |}
| |
|
| |
| == Sektionen ==
| |
| === [Globals] ===
| |
| {| class="wikitable sortable options big"
| |
| |-
| |
| ! Parameter !! Werte / Beispiel !! Beschreibung
| |
| |-
| |
| | ini_version || 1 || Marker für das Konfigurationsformat. Wird meist durch Paketmaintainer gesetzt
| |
| |-
| |
| | port || 3389<br/>tcp://:3389<br/>tcp://10.0.0.1:3389 || Listener-Endpunkt. Abhängig von Release werden Schemas unterstützt (z.B. tcp/tcp6/unix/vsock)
| |
| |-
| |
| | address || 127.0.0.1 / 10.0.0.1 || Bind-Adresse (Legacy/Distribution). Wenn verfügbar, wird der Listener auf ein Interface begrenzt
| |
| |-
| |
| | tcp_nodelay || true/false || Reduziert Latenz (TCP_NODELAY).
| |
| |-
| |
| | tcp_keepalive || true/false || Keepalive für lange TCP-Sessions (SO_KEEPALIVE)
| |
| |-
| |
| | security_layer || tls / rdp / negotiate || Security-Modus. ''negotiate'' wählt abhängig vom Client
| |
| |-
| |
| | crypt_level || none/low/medium/high/fips || Verschlüsselungsstufe für Classic-RDP-Security (wirksam bei ''security_layer=rdp'' oder teils ''negotiate'')
| |
| |-
| |
| | certificate || /etc/xrdp/cert.pem || TLS-Zertifikat (PEM)
| |
| |-
| |
| | key_file || /etc/xrdp/key.pem || TLS-Private-Key (PEM)
| |
| |-
| |
| | ssl_protocols || TLSv1.2,TLSv1.3 || Erlaubte TLS-Protokolle (bei TLS/Negotiation)
| |
| |-
| |
| | tls_ciphers || <OpenSSL-Cipher-String> || Cipher-Suite-Auswahl für TLS (OpenSSL-Syntax)
| |
| |-
| |
| | allow_channels || true/false || Globale Freigabe virtueller Kanäle. Bei ''false'' werden Kanäle effektiv blockiert
| |
| |-
| |
| | max_bpp || 8/15/16/24/32 || Maximale Farbtiefe
| |
| |-
| |
| | bitmap_cache || true/false || Bitmap-Caching zur Performance-/Bandbreitenoptimierung.
| |
| |-
| |
| | bitmap_compression || true/false || Bitmap-Kompression (reduziert Bandbreite, erhöht CPU)
| |
| |-
| |
| | bulk_compression || true/false || Kompression von Bulk-Daten
| |
| |-
| |
| | use_fastpath || none/input/output/both || FastPath-Optimierung (Performance)
| |
| |-
| |
| | domain_user_separator || \\, @, + || Trennzeichen für Domain/Realm im Username
| |
| |-
| |
| | runtime_user || xrdp || Laufzeit-User des Dienstes (wenn im Setup genutzt)
| |
| |-
| |
| | runtime_group || xrdp || Laufzeit-Gruppe des Dienstes (wenn im Setup genutzt)
| |
| |}
| |
|
| |
| ; Hinweis
| |
| * ''key_file'' muss restriktiv berechtigt sein, aber für den XRDP-Prozess lesbar bleiben
| |
|
| |
| === [Logging] ===
| |
| {| class="wikitable sortable options big"
| |
| |-
| |
| ! Parameter !! Werte !! Beschreibung
| |
| |-
| |
| | LogFile || xrdp.log<br/>/var/log/xrdp.log || Logdatei (relativ oder absolut Pfad)
| |
| |-
| |
| | LogLevel || ERROR/WARN/INFO/DEBUG || Detailgrad der Datei-Logs
| |
| |-
| |
| | EnableSyslog || true/false || Syslog-Logging aktivieren
| |
| |-
| |
| | SyslogLevel || ERROR/WARN/INFO/DEBUG || Detailgrad für Syslog
| |
| |-
| |
| | EnableConsole || true/false || Console-Logging (Debugging)
| |
| |-
| |
| | ConsoleLevel || ERROR/WARN/INFO/DEBUG || Detailgrad der Console-Logs
| |
| |-
| |
| | EnableProcessId || true/false || PID in Logzeilen ausgeben
| |
| |}
| |
|
| |
| === [Channels] ===
| |
| {| class="wikitable sortable options big"
| |
| |-
| |
| ! Parameter !! Werte !! Beschreibung
| |
| |-
| |
| | cliprdr || true/false || Zwischenablage
| |
| |-
| |
| | rdpdr || true/false || Device Redirection (u.a. Laufwerksweiterleitung)
| |
| |-
| |
| | rdpsnd || true/false || Audio
| |
| |-
| |
| | drdynvc || true/false || Dynamic Virtual Channels. Voraussetzung für diverse Features
| |
| |-
| |
| | rail || true/false || RemoteApp/RAIL (falls genutzt)
| |
| |-
| |
| | xrdpvr || true/false || XRDP-Video/Streaming (falls genutzt)
| |
| |}
| |
|
| |
| ; Hinweis
| |
| * Aktivierte Kanäle erhöhen die Angriffsfläche. Nicht benötigte Kanäle deaktivieren
| |
|
| |
| === Session types ===
| |
| Connection sections definieren die im Login-Dialog auswählbaren Backend-Typen
| |
|
| |
| {| class="wikitable sortable options big"
| |
| |-
| |
| ! Sektion !! Parameter !! Werte !! Beschreibung
| |
| |-
| |
| | [Xorg]/[Xvnc]/… || name || Xorg / Xvnc || Anzeigename im Login-Dialog
| |
| |-
| |
| | [Xorg]/[Xvnc]/… || lib || libxup.so / libvnc.so || Backend-Library (Xorgxrdp/VNC)
| |
| |-
| |
| | [Xorg]/[Xvnc]/… || username || ask / na || Credential-Handling (GUI-Abfrage oder n/a)
| |
| |-
| |
| | [Xorg]/[Xvnc]/… || password || ask / na || Password-Handling
| |
| |-
| |
| | [Xorg]/[Xvnc]/… || ip || 127.0.0.1 / ask || Zielhost für Backend
| |
| |-
| |
| | [Xorg]/[Xvnc]/… || port || -1 / ask5900 || Zielport (''-1'' nutzt Backend-Default, VNC - 5900)
| |
| |-
| |
| | [Xorg]/[Xvnc]/… || code || 20 || Session-Typ-ID
| |
| |-
| |
| | [Xvnc] || xserverbpp || 24 || Farbtiefe des VNC-Backends
| |
| |-
| |
| | [Xvnc] || disable_encodings_mask || Integer/Bitmask || Maskiert VNC-Encodings (Workarounds)
| |
| |}
| |
|
| |
| == Beispiele ==
| |
| ; TLS + Bind auf internes Interface
| |
| <syntaxhighlight lang="ini" highlight="" copy line>
| |
| [Globals]
| |
| port=3389
| |
| address=10.0.0.1
| |
|
| |
| security_layer=tls
| |
| certificate=/etc/xrdp/cert.pem
| |
| key_file=/etc/xrdp/key.pem
| |
| </syntaxhighlight>
| |
|
| |
| ; nicht benötigte Kanäle deaktivieren
| |
| <syntaxhighlight lang="ini" highlight="" copy line>
| |
| [Channels]
| |
| cliprdr=true
| |
| rdpdr=false
| |
| rdpsnd=false
| |
| drdynvc=true
| |
| rail=false
| |
| </syntaxhighlight>
| |
|
| |
| == Änderungen übernehmen ==
| |
| <syntaxhighlight lang="bash" highlight="1" line copy>
| |
| sudo systemctl restart xrdp xrdp-sesman
| |
| </syntaxhighlight>
| |
|
| |
|
| [[Kategorie:Xrdp]] | | [[Kategorie:Xrdp]] |
/etc/xrdp/xrdp.ini - Konfigurationsdatei des XRDP-Listeners
Beschreibung
/etc/xrdp/xrdp.ini definiert globale Eigenschaften des XRDP-Dienstes
- Netzwerk-Listener (Port, Bind-Interface)
- Sicherheitslayer (TLS/RDP)
- Logging
- Feature-Kanäle (Clipboard, Laufwerke, Audio)
- Sitzungsdefinitionen
Anwendung
Problembehebung
Anhang
Siehe auch
Dokumentation
Links
Projekt
Weblinks
TMP