Ga naar inhoud

🥑 Apache Guacamole

Guacamole is een clientless remote desktop gateway die toegang biedt tot je systemen via de browser.

Algemene Info

Item Waarde
Container guacamole
Image guacamole/guacamole:latest
Poort 8083
URL guacamole.hub
Backend guacd (daemon) + MySQL

Functies

  • ✅ RDP - Windows Remote Desktop
  • ✅ VNC - Virtual Network Computing
  • ✅ SSH - Secure Shell
  • ✅ Browser-based - Geen client software nodig
  • ✅ File transfer - Bestanden up/downloaden
  • ✅ Clipboard sharing - Kopiëren/plakken
  • ✅ Audio - Geluid doorsturen (RDP)

Geconfigureerde Verbindingen

Naam IP Type Desktop
Mini PC 1 - Ubuntu 192.168.1.13 RDP GNOME
Mini PC 2 - Proxmox Ubuntu 192.168.1.101 RDP XFCE

Via Homer dashboard of direct:

  • Mini PC 1: http://guacamole.hub/guacamole/#/client/MQBjAG15c3Fs
  • Mini PC 2: http://guacamole.hub/guacamole/#/client/MgBjAG15c3Fs

Inloggen

  1. Ga naar guacamole.hub
  2. Login met Guacamole credentials
  3. Klik op gewenste verbinding
  4. Login met systeem credentials van de doelmachine

Verbinding Toevoegen

RDP Verbinding (Windows/Ubuntu)

  1. Login als admin
  2. Settings → Connections → New Connection
  3. Vul in:
Veld Waarde
Name Beschrijvende naam
Protocol RDP
Hostname IP adres
Port 3389
Username (optioneel, of invullen bij connect)
Password (optioneel)
Security mode Any
Ignore certificate Aanvinken (voor self-signed)
  1. Klik Save

SSH Verbinding

  1. New Connection
  2. Protocol: SSH
  3. Vul in:
Veld Waarde
Name Beschrijvende naam
Hostname IP adres
Port 22
Username SSH gebruiker
Authentication Password of Private Key

VNC Verbinding

  1. New Connection
  2. Protocol: VNC
  3. Vul in:
Veld Waarde
Name Beschrijvende naam
Hostname IP adres
Port 5900 (standaard VNC)
Password VNC wachtwoord

Keyboard Shortcuts

Actie Shortcut
Menu openen Ctrl+Alt+Shift
Clipboard Via menu
Volledig scherm Via menu
Verbinding sluiten Via menu → Disconnect

Menu

Druk Ctrl+Alt+Shift om het Guacamole menu te openen voor clipboard, bestandsoverdracht en meer.

Bestandsoverdracht

Uploaden (naar remote systeem)

  1. Open Guacamole menu (Ctrl+Alt+Shift)
  2. Klik op Devices
  3. Sleep bestand naar het venster
  4. Bestand verschijnt in home directory of gekozen locatie

Downloaden (van remote systeem)

  1. Open Guacamole menu
  2. Klik op Devices
  3. Navigeer naar bestand
  4. Klik om te downloaden

RDP vereist

Bestandsoverdracht werkt het beste met RDP. SSH ondersteunt SFTP.

Clipboard Delen

  1. Open Guacamole menu (Ctrl+Alt+Shift)
  2. Klik Clipboard
  3. Plak tekst in het tekstveld
  4. Tekst is nu beschikbaar in remote sessie

Andersom: 1. Kopieer tekst in remote sessie 2. Open Guacamole menu 3. Tekst staat in Clipboard veld 4. Kopieer naar lokaal systeem

Troubleshooting

Verbinding mislukt

Symptomen

  • "Connection failed" error
  • Zwart scherm

Checklist:

  1. Ping de doelmachine: 

    ping 192.168.1.101

  2. Check of RDP/SSH draait: 

    # RDP (poort 3389)
nc -zv 192.168.1.101 3389

# SSH (poort 22)
nc -zv 192.168.1.101 22

  3. Check Guacamole logs: 

    docker logs guacamole
docker logs guacd

  4. Firewall op doelmachine:

  5. Ubuntu: sudo ufw allow 3389
  6. Windows: RDP inschakelen in settings

RDP naar Ubuntu werkt niet

Symptomen

  • Verbinding lukt, maar zwart scherm
  • Login scherm verschijnt niet

Oplossingen:

  1. GNOME Remote Desktop (Ubuntu 24.04):
  2. Settings → Sharing → Remote Desktop → Enable

  3. Set password

  4. xrdp installeren (alternatief): 

    sudo apt install xrdp -y
sudo systemctl enable xrdp
sudo adduser xrdp ssl-cert

  5. Na login zwart scherm:

  6. Log eerst uit op de lokale desktop
  7. RDP en lokale sessie kunnen niet tegelijk

Toetsenbord layout verkeerd

Oplossing:

  1. Bewerk verbinding
  2. Ga naar Parameters
  3. Set Keyboard layout naar juiste taal
  4. Opties: nl-nl-qwerty, en-us-qwerty

Trage verbinding

Optimalisaties:

  1. Bewerk verbinding
  2. Verlaag Color depth (16-bit)
  3. Zet Disable audio aan
  4. Zet Disable printing aan
  5. Verlaag Resize method naar "Display update"

Clipboard werkt niet

RDP: 1. Bewerk verbinding 2. Check dat Enable clipboard aan staat

SSH: - Clipboard werkt niet native in SSH - Gebruik Guacamole menu clipboard

Admin Taken

Gebruiker Toevoegen

  1. Settings → Users → New User
  2. Vul in:
  3. Username
  4. Password
  5. Permissions (welke verbindingen)
  6. Save

Connection Group Maken

Organiseer verbindingen in groepen:

  1. Settings → Connections
  2. New Group
  3. Naam en locatie instellen
  4. Drag & drop verbindingen in groep

Docker Compose

guacamole:
  image: guacamole/guacamole:latest
  container_name: guacamole
  restart: unless-stopped
  ports:
    - "8083:8080"
  environment:
    GUACD_HOSTNAME: guacd
    MYSQL_HOSTNAME: guac-mysql
    MYSQL_DATABASE: guacamole_db
    MYSQL_USER: guacamole_user
    MYSQL_PASSWORD: secure_password
  depends_on:
    - guacd
    - guac-mysql
  networks:
    - proxy-net
    - guac-net

guacd:
  image: guacamole/guacd:latest
  container_name: guacd
  restart: unless-stopped
  networks:
    - guac-net

guac-mysql:
  image: mysql:8.0
  container_name: guac-mysql
  restart: unless-stopped
  environment:
    MYSQL_ROOT_PASSWORD: root_password
    MYSQL_DATABASE: guacamole_db
    MYSQL_USER: guacamole_user
    MYSQL_PASSWORD: secure_password
  volumes:
    - ./guacamole/mysql:/var/lib/mysql
  networks:
    - guac-net

networks:
  guac-net:
    driver: bridge

Gerelateerd