Zum Inhalt springen

/etc/xrdp/xrdp.ini: Unterschied zwischen den Versionen

Aus Foxwiki
Versionsgeschichte interaktiv durchsuchen
← Zum vorherigen Versionsunterschied
VisuellWikitext
K Textersetzung - „XRDP“ durch „xrdp“
DanielZorin (Diskussion | Beiträge)
Bürokraten, Page Ownership admin
713 Bearbeitungen
Keine Bearbeitungszusammenfassung
 
(3 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
# /etc/xrdp/xrdp.ini
'''{{BASEPAGENAME}}''' - Zentrale Konfigurationsdatei des XRDP-Listeners.
[Globals]
 
; xrdp.ini file version number
== Beschreibung ==
ini_version=1
In ''xrdp.ini'' werden die globalen Eigenschaften des Dienstes konfiguriert:
* Netzwerk-Listener (Port, Bind-Interface)
; fork a new process for each incoming connection
* Sicherheitslayer (TLS/RDP)
fork=true
* Logging
* Feature-Kanäle (Clipboard, Laufwerke, Audio)
; ports to listen on, number alone means listen on all interfaces
* Sitzungsdefinitionen
; 0.0.0.0 or :: if ipv6 is configured
 
; space between multiple occurrences
== Aufbau ==
; ALL specified interfaces must be UP when xrdp starts, otherwise xrdp will fail to start
; Wichtige Sektionen
;
* ''[Globals]'' – Listener, Security, Performance-Flags, Laufzeit-User
; Examples:
* ''[Logging]'' – Logziele und Loglevel
;  port=3389
* ''[Channels]'' – Aktivierung einzelner virtueller Kanäle
;  port=unix://./tmp/xrdp.socket
* ''[Xorg]'', ''[Xvnc]'' und weitere – Connection sections
;  port=tcp://.:3389                           127.0.0.1:3389
 
;  port=tcp://:3389                            *:3389
== Parameter ==
;  port=tcp://<any ipv4 format addr>:3389      192.168.1.1:3389
=== [Globals] ===
;  port=tcp6://.:3389                          ::1:3389
{| class="wikitable sortable options big"
;  port=tcp6://:3389                          *:3389
|-
;  port=tcp6://{<any ipv6 format addr>}:3389  {FC00:0:0:0:0:0:0:1}:3389
! Parameter !! Werte / Beispiel !! Beschreibung
;  port=vsock://<cid>:<port>
|-
port=3389
| ini_version || 1 || Marker für das Konfigurationsformat. Wird meist durch Paketmaintainer gesetzt
|-
; 'port' above should be connected to with vsock instead of tcp
| 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)
; use this only with number alone in port above
|-
; prefer use vsock://<cid>:<port> above
| address || 127.0.0.1 / 10.0.0.1 || Bind-Adresse (Legacy/Distribution). Wenn verfügbar, wird der Listener auf ein Interface begrenzt
use_vsock=false
|-
| tcp_nodelay || true/false || Reduziert Latenz (TCP_NODELAY).
; regulate if the listening socket use socket option tcp_nodelay
|-
; no buffering will be performed in the TCP stack
| tcp_keepalive || true/false || Keepalive für lange TCP-Sessions (SO_KEEPALIVE)
tcp_nodelay=true
|-
| security_layer || tls / rdp / negotiate || Security-Modus. ''negotiate'' wählt abhängig vom Client
; regulate if the listening socket use socket option keepalive
|-
; if the network connection disappear without close messages the connection will be closed
| crypt_level || none/low/medium/high/fips || Verschlüsselungsstufe für Classic-RDP-Security (wirksam bei ''security_layer=rdp'' oder teils ''negotiate'')
tcp_keepalive=true
|-
| certificate || /etc/xrdp/cert.pem || TLS-Zertifikat (PEM)
; set tcp send/recv buffer (for experts)
|-
#tcp_send_buffer_bytes=32768
| key_file || /etc/xrdp/key.pem || TLS-Private-Key (PEM)
#tcp_recv_buffer_bytes=32768
|-
| ssl_protocols || TLSv1.2,TLSv1.3 || Erlaubte TLS-Protokolle (bei TLS/Negotiation)
; security layer can be 'tls', 'rdp' or 'negotiate'
|-
; for client compatible layer
| tls_ciphers || <OpenSSL-Cipher-String> || Cipher-Suite-Auswahl für TLS (OpenSSL-Syntax)
security_layer=negotiate
|-
| allow_channels || true/false || Globale Freigabe virtueller Kanäle. Bei ''false'' werden Kanäle effektiv blockiert
; minimum security level allowed for client for classic RDP encryption
|-
; use tls_ciphers to configure TLS encryption
| max_bpp || 8/15/16/24/32 || Maximale Farbtiefe
; can be 'none', 'low', 'medium', 'high', 'fips'
|-
crypt_level=high
| bitmap_cache || true/false || Bitmap-Caching zur Performance-/Bandbreitenoptimierung.
|-
; X.509 certificate and private key
| bitmap_compression || true/false || Bitmap-Kompression (reduziert Bandbreite, erhöht CPU)
; openssl req -x509 -newkey rsa:2048 -nodes -keyout key.pem -out cert.pem -days 365
|-
; note this needs the user xrdp to be a member of the ssl-cert group, do with e.g.
| bulk_compression || true/false || Kompression von Bulk-Daten
;$ sudo adduser xrdp ssl-cert
|-
certificate=
| use_fastpath || none/input/output/both || FastPath-Optimierung (Performance)
key_file=
|-
| domain_user_separator || \\, @, + || Trennzeichen für Domain/Realm im Username
; set SSL protocols
|-
; can be comma separated list of 'SSLv3', 'TLSv1', 'TLSv1.1', 'TLSv1.2', 'TLSv1.3'
| runtime_user || xrdp || Laufzeit-User des Dienstes (wenn im Setup genutzt)
ssl_protocols=TLSv1.2, TLSv1.3
|-
; set TLS cipher suites
| runtime_group || xrdp || Laufzeit-Gruppe des Dienstes (wenn im Setup genutzt)
#tls_ciphers=HIGH
|}
 
; concats the domain name to the user if set for authentication with the separator
; Hinweis
; for example when the server is multi homed with SSSd
* ''key_file'' muss restriktiv berechtigt sein, aber für den XRDP-Prozess lesbar bleiben
#domain_user_separator=@
 
=== [Logging] ===
; The following options will override the keyboard layout settings.
{| class="wikitable sortable options big"
; These options are for DEBUG and are not recommended for regular use.
|-
#xrdp.override_keyboard_type=0x04
! Parameter !! Werte !! Beschreibung
#xrdp.override_keyboard_subtype=0x01
|-
#xrdp.override_keylayout=0x00000409
| LogFile || xrdp.log<br/>/var/log/xrdp.log || Logdatei (relativ oder absolut Pfad)
|-
; Section name to use for automatic login if the client sends username
| LogLevel || ERROR/WARN/INFO/DEBUG || Detailgrad der Datei-Logs
; and password. If empty, the domain name sent by the client is used.
|-
; If empty and no domain name is given, the first suitable section in
| EnableSyslog || true/false || Syslog-Logging aktivieren
; this file will be used.
|-
autorun=
| SyslogLevel || ERROR/WARN/INFO/DEBUG || Detailgrad für Syslog
|-
allow_channels=true
| EnableConsole || true/false || Console-Logging (Debugging)
allow_multimon=true
|-
bitmap_cache=true
| ConsoleLevel || ERROR/WARN/INFO/DEBUG || Detailgrad der Console-Logs
bitmap_compression=true
|-
bulk_compression=true
| EnableProcessId || true/false || PID in Logzeilen ausgeben
#hidelogwindow=true
|}
max_bpp=32
 
new_cursors=true
=== [Channels] ===
; fastpath - can be 'input', 'output', 'both', 'none'
{| class="wikitable sortable options big"
use_fastpath=both
|-
;when true, userid/password *must* be passed on cmd line. If the password
! Parameter !! Werte !! Beschreibung
; is incorrect, the login will fail
|-
#require_credentials=true
| cliprdr || true/false || Zwischenablage
; when true, the userid will be used to try to authenticate
|-
#enable_token_login=true
| rdpdr || true/false || Device Redirection (u.a. Laufwerksweiterleitung)
; You can set the PAM error text in a gateway setup (MAX 256 chars)
|-
#pamerrortxt=change your password according to policy at http://url
| rdpsnd || true/false || Audio
|-
;
| drdynvc || true/false || Dynamic Virtual Channels. Voraussetzung für diverse Features
; colors used by windows in RGB format
|-
;
| rail || true/false || RemoteApp/RAIL (falls genutzt)
blue=009cb5
|-
grey=dedede
| xrdpvr || true/false || XRDP-Video/Streaming (falls genutzt)
#black=000000
|}
#dark_grey=808080
 
#blue=08246b
; Hinweis
#dark_blue=08246b
* Aktivierte Kanäle erhöhen die Angriffsfläche. Nicht benötigte Kanäle deaktivieren
#white=ffffff
 
#red=ff0000
=== Session types ===
#green=00ff00
Connection sections definieren die im Login-Dialog auswählbaren Backend-Typen
#background=626c72
 
{| class="wikitable sortable options big"
;
|-
; configure login screen
! Sektion !! Parameter !! Werte !! Beschreibung
;
|-
| [Xorg]/[Xvnc]/… || name || Xorg / Xvnc || Anzeigename im Login-Dialog
; Login Screen Window Title
|-
#ls_title=My Login Title
| [Xorg]/[Xvnc]/… || lib || libxup.so / libvnc.so || Backend-Library (Xorgxrdp/VNC)
|-
; top level window background color in RGB format
| [Xorg]/[Xvnc]/… || username || ask / na || Credential-Handling (GUI-Abfrage oder n/a)
ls_top_window_bg_color=009cb5
|-
| [Xorg]/[Xvnc]/… || password || ask / na || Password-Handling
; width and height of login screen
|-
;
| [Xorg]/[Xvnc]/… || ip || 127.0.0.1 / ask || Zielhost für Backend
; The default height allows for about 5 fields to be comfortably displayed
|-
; above the buttons at the bottom. To display more fields, make <ls_height>
| [Xorg]/[Xvnc]/… || port || -1 / ask5900 || Zielport (''-1'' nutzt Backend-Default, VNC - 5900)
; larger, and also increase <ls_btn_ok_y_pos> and <ls_btn_cancel_y_pos>
|-
; below
| [Xorg]/[Xvnc]/… || code || 20 || Session-Typ-ID
;
|-
ls_width=350
| [Xvnc] || xserverbpp || 24 || Farbtiefe des VNC-Backends
ls_height=430
|-
| [Xvnc] || disable_encodings_mask || Integer/Bitmask || Maskiert VNC-Encodings (Workarounds)
; login screen background color in RGB format
|}
ls_bg_color=dedede
 
== Beispiele ==
; optional background image filename. BMP format is always supported,
; TLS + Bind auf internes Interface
; but other formats will be supported if xrdp is build with imlib2
<syntaxhighlight lang="ini" highlight="" copy line>
; The transform can be one of the following:-
[Globals]
;    none  : No transformation. Image is placed in bottom-right corner
port=3389
;            of the screen.
address=10.0.0.1
;    scale : Image is scaled to the screen size. The image aspect
 
;            ratio is not preserved.
security_layer=tls
;     zoom  : Image is scaled to the screen size. The image aspect
certificate=/etc/xrdp/cert.pem
;            ratio is preserved by clipping the image.
key_file=/etc/xrdp/key.pem
#ls_background_image=
</syntaxhighlight>
#ls_background_transform=none
 
; nicht benötigte Kanäle deaktivieren
; logo
<syntaxhighlight lang="ini" highlight="" copy line>
; full path to file or file in shared folder. BMP format is always supported,
[Channels]
; but other formats will be supported if xrdp is build with imlib2
cliprdr=true
; For transform values, see 'ls_background_transform'. The logo width and
rdpdr=false
; logo height are ignored for a transform of 'none'.
rdpsnd=false
ls_logo_filename=
drdynvc=true
#ls_logo_transform=none
rail=false
#ls_logo_width=240
</syntaxhighlight>
#ls_logo_height=140
 
ls_logo_x_pos=55
== Änderungen übernehmen ==
ls_logo_y_pos=50
<syntaxhighlight lang="bash" highlight="1" line copy>
sudo systemctl restart xrdp xrdp-sesman
; for positioning labels such as username, password etc
</syntaxhighlight>
ls_label_x_pos=30
 
ls_label_width=65
[[Kategorie:Xrdp]]
; for positioning text and combo boxes next to above labels
ls_input_x_pos=110
ls_input_width=210
; y pos for first label and combo box
ls_input_y_pos=220
; OK button
ls_btn_ok_x_pos=142
ls_btn_ok_y_pos=370
ls_btn_ok_width=85
ls_btn_ok_height=30
; Cancel button
ls_btn_cancel_x_pos=237
ls_btn_cancel_y_pos=370
ls_btn_cancel_width=85
ls_btn_cancel_height=30
[Logging]
; Note: Log levels can be any of: core, error, warning, info, debug, or trace
LogFile=xrdp.log
LogLevel=INFO
EnableSyslog=true
#SyslogLevel=INFO
#EnableConsole=false
#ConsoleLevel=INFO
#EnableProcessId=false
[LoggingPerLogger]
; Note: per logger configuration is only used if xrdp is built with
; --enable-devel-logging
#xrdp.c=INFO
#main()=INFO
[Channels]
; Channel names not listed here will be blocked by xrdp.
; You can block any channel by setting its value to false.
; IMPORTANT! All channels are not supported in all use
; cases even if you set all values to true.
; You can override these settings on each session type
; These settings are only used if allow_channels=true
rdpdr=true
rdpsnd=true
drdynvc=true
cliprdr=true
rail=true
xrdpvr=true
tcutils=true
; for debugging xrdp, in section xrdp1, change port=-1 to this:
#port=/tmp/.xrdp/xrdp_display_10
;
; Session types
;
; Some session types such as Xorg, X11rdp and Xvnc start a display server.
; Startup command-line parameters for the display server are configured
; in sesman.ini. See and configure also sesman.ini.
[Xorg]
name=Xorg
lib=libxup.so
username=ask
password=ask
ip=127.0.0.1
port=-1
code=20
[Xvnc]
name=Xvnc
lib=libvnc.so
username=ask
password=ask
ip=127.0.0.1
port=-1
#xserverbpp=24
#delay_ms=2000
; Disable requested encodings to support buggy VNC servers
; (1 = ExtendedDesktopSize)
#disabled_encodings_mask=0
; Use this to connect to a chansrv instance created outside of sesman
; (e.g. as part of an x11vnc console session). Replace '0' with the
; display number of the session
#chansrvport=DISPLAY(0)
; Generic VNC Proxy
; Tailor this to specific hosts and VNC instances by specifying an ip
; and port and setting a suitable name.
[vnc-any]
name=vnc-any
lib=libvnc.so
ip=ask
port=ask5900
username=na
password=ask
#pamusername=asksame
#pampassword=asksame
#pamsessionmng=127.0.0.1
#delay_ms=2000
; Generic RDP proxy using NeutrinoRDP
; Tailor this to specific hosts by specifying an ip and port and setting
; a suitable name.
[neutrinordp-any]
name=neutrinordp-any
; To use this section, you should build xrdp with configure option
; --enable-neutrinordp.
lib=libxrdpneutrinordp.so
ip=ask
port=ask3389
username=ask
password=ask
; Uncomment the following lines to enable PAM authentication for proxy
; connections.
#pamusername=ask
#pampassword=ask
#pamsessionmng=127.0.0.1
; Currently NeutrinoRDP doesn't support dynamic resizing. Uncomment
; this line if you're using a client which does.
#enable_dynamic_resizing=false
; By default, performance settings requested by the RDP client are ignored
; and chosen by NeutrinoRDP. Uncomment this line to allow the user to
; select performance settings in the RDP client.
#perf.allow_client_experiencesettings=true
; Override any experience setting by uncommenting one or more of the
; following lines.
#perf.wallpaper=false
#perf.font_smoothing=false
#perf.desktop_composition=false
#perf.full_window_drag=false
#perf.menu_anims=false
#perf.themes=false
#perf.cursor_blink=false
; By default NeutrinoRDP supports cursor shadows. If this is giving
; you problems (e.g. cursor is a black rectangle) try disabling cursor
; shadows by uncommenting the following line.
#perf.cursor_shadow=false
; By default, NeutrinoRDP uses the keyboard layout of the remote RDP Server.
; If you want to tell the remote the keyboard layout of the RDP Client,
; by uncommenting the following line.
#neutrinordp.allow_client_keyboardLayout=true
; The following options will override the remote keyboard layout settings.
; These options are for DEBUG and are not recommended for regular use.
#neutrinordp.override_keyboardLayout_mask=0x0000FFFF
#neutrinordp.override_kbd_type=0x04
#neutrinordp.override_kbd_subtype=0x01
#neutrinordp.override_kbd_fn_keys=12
#neutrinordp.override_kbd_layout=0x00000409
; You can override the common channel settings for each session type
#channel.rdpdr=true
#channel.rdpsnd=true
#channel.drdynvc=true
#channel.cliprdr=true
#channel.rail=true
#channel.xrdpvr=true

Aktuelle Version vom 7. Januar 2026, 16:22 Uhr

/etc/xrdp/xrdp.ini - Zentrale Konfigurationsdatei des XRDP-Listeners.

Beschreibung

In xrdp.ini werden die globalen Eigenschaften des Dienstes konfiguriert:

  • Netzwerk-Listener (Port, Bind-Interface)
  • Sicherheitslayer (TLS/RDP)
  • Logging
  • Feature-Kanäle (Clipboard, Laufwerke, Audio)
  • Sitzungsdefinitionen

Aufbau

Wichtige Sektionen
  • [Globals] – Listener, Security, Performance-Flags, Laufzeit-User
  • [Logging] – Logziele und Loglevel
  • [Channels] – Aktivierung einzelner virtueller Kanäle
  • [Xorg], [Xvnc] und weitere – Connection sections

Parameter

[Globals]

Parameter Werte / Beispiel Beschreibung
ini_version 1 Marker für das Konfigurationsformat. Wird meist durch Paketmaintainer gesetzt
port 3389
tcp://:3389
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]

Parameter Werte Beschreibung
LogFile xrdp.log
/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]

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

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
[Globals]
port=3389
address=10.0.0.1

security_layer=tls
certificate=/etc/xrdp/cert.pem
key_file=/etc/xrdp/key.pem
nicht benötigte Kanäle deaktivieren
[Channels]
cliprdr=true
rdpdr=false
rdpsnd=false
drdynvc=true
rail=false

Änderungen übernehmen

sudo systemctl restart xrdp xrdp-sesman
Abgerufen von „https://wiki.foxtom.de/index.php?title=/etc/xrdp/xrdp.ini&oldid=159657“