rdesktop nano

rdesktop nano

small rdesktop Docker container for perfect use with a Terminal Server.

It's based on debian:bullseye

Changelogs

• 2023-03-20
  • github action to build container
  • implemented ghcr.io as new registry
  • upgrade from jessie to bullseye

Usage: Run the Client

it uses the same screen resolution as the underlying vnc server

Environment variables and defaults

• RDESKTOP_SERVER

• set this to rdp server address

• RDESKTOP_OPTS

• default not set use this to set the options for rdesktop. see command line options of rdesktop

• RDESKTOP_KEEP_ALIVE

• set this to any value e.g. true to enable reconnections after rdesktop dies, quits etc.

• DISABLE_SSHD

• set this to any value e.g. true to disable SSHD -> Port 22

• ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -X root@$(docker inspect --format '{{ .NetworkSettings.IPAddress }}' containername) [...]

• DISABLE_VNC

• set this to any value e.g. true to disable VNC Server -> Port 5901

• VNC_PASSWORD

• default: debian use custom password for VNC

• VNC_SCREEN_RESOLUTION

• default: 1280x800

• DISABLE_WEBSOCKIFY

• set this to any value e.g. true to disable Websockify Server -> Port 80

Websockify SSL Environment variables and defaults

• ENABLE_SSL
• set this to any value e.g. true to enable to enable SSL Websockify Server
• SSL_ONLY
• set this to any value e.g. true to set SSL only for Websockify Server
• SSL_CERT
• default: /opt/websockify/self.pem path to cert with included key
• SSL_SIZE
• default: 4086 keysize
• SSL_DAYS
• default: 3650 ssl cert lifetime in days
• SSL_SUBJECT
• default: /C=XX/ST=XXXX/L=XXXX/O=XXXX/CN=localhost ssl cert subject

Proxy Environment variables and defaults

• HTTP_PROXY
• set this to a value like 'http://yourproxyaddress:proxyport' to enable proxy variables HTTP_PROXY and http_proxy
• HTTPS_PROXY
  • set this to a value like 'http://yourproxyaddress:proxyport' to enable proxy variables HTTPS_PROXY and https_proxy
• FTP_PROXY
  • set this to a value like 'http://yourproxyaddress:proxyport' to enable proxy variables FTP_PROXY and ftp_proxy
• NO_PROXY
  • set this to a value like 'http://yourproxyaddress:proxyport' to enable proxy variables NO_PROXY and no_proxy
• APT_PROXY
  • set this to a value like 'http://yourproxyaddress:proxyport' to enable proxy inside apt configuration

Usage

Run the container with this command:

docker run -d -e 'RDESKTOP_OPTS=-k de -d MYDOMAIN -u johndoe' -e 'RDESKTOP_SERVER=172.10.1.1' --name rdesktop-nano -p 5901:5901 -p 80:80 ghcr.io/desktopcontainers/rdesktop

Connect to the container. In the vnc connection string, type this:

"ipaddress:1"

The default password is "debian".

Simple SSH X11 Forwarding

Since it is an X11 GUI software, usage is in two steps:

1. Run a background container as server or start existing one.

docker start rdesktop-nano || docker run -d --name rdesktop-nano -e 'RDESKTOP_OPTS=-k de -d MYDOMAIN -u johndoe' -e 'RDESKTOP_SERVER=172.10.1.1' ghcr.io/desktopcontainers/rdesktop

2. Connect to the server using ssh -X (as many times you want). Logging in with ssh automatically opens a rdesktop window

ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no \
-X app@$(docker inspect --format '{{ .NetworkSettings.IPAddress }}' rdesktop-nano)