Mit Home Assistant Apache Guacamole lässt sich ein leistungsfähiger Fernzugriff auf verschiedene Systeme direkt in Home Assistant integrieren. Das Home Assistant Guacamole Add-on ermöglicht es, RDP, VNC und SSH-Verbindungen über eine zentrale Weboberfläche zu verwalten. In diesem Artikel erfährst du, wie du das Add-on installierst und konfigurierst.
Table of Contents
Was ist Apache Guacamole?
Apache Guacamole ist eine clientlose Remote-Desktop-Gateway-Lösung, die über einen Webbrowser genutzt werden kann. Sie unterstützt:
- RDP (Remote Desktop Protocol) für Windows-Systeme
- VNC (Virtual Network Computing) für Linux und andere Systeme
- SSH (Secure Shell) für den Zugriff auf Server und Netzwerkinfrastrukturen
Durch die Integration in Home Assistant kannst du deine Geräte sicher und bequem verwalten.
Voraussetzungen
Bevor du mit der Installation beginnst, benötigst du:
- Ein laufendes Home Assistant System (Supervisor- oder OS-Installation empfohlen)
- Zugriff auf den Home Assistant Add-on Store
- Administratorrechte auf Home Assistant
- Das alexbelgium Add-on Repository, um das Apache Guacamole Add-on zu installieren
Home Assistant Apache Guacamole Add-on installieren
Wir installieren das Apache Guacamole Add-on in Home Assistant.
Gesamtzeit: 5 Minuten
Add-on-Store öffnen
Öffne in Home Assistant das Einstellungen-Menü und navigiere zum Add-on Store.
alexbelgium Add-on Repository hinzufügen
Um das Guacamole Add-on installieren zu können, musst du zunächst das alexbelgium Repository hinzufügen:
Klicke auf die drei Punkte oben rechts und wähle Repository hinzufügen.
Gib die folgende URL ein: https://github.com/alexbelgium/hassio-addons
Bestätige mit Hinzufügen.
Oder klicke auf diesen Button:
Apache Guacamole Add-on suchen
Gib im Suchfeld „Apache Guacamole“ ein und wähle das Add-on aus den Ergebnissen.
Installation starten
Klicke auf Installieren, um das Home Assistant Guacamole Add-on auf deinem System einzurichten.
Konfiguration anpassen
Nach der Installation musst du das Add-on konfigurieren. Öffne die Einstellungen des Add-ons und passe folgende Parameter an:
Extensions: Hier können Erweiterungen wie z.B. auth-totp installiert werden. Ich würde Empfehlen zur zusätzlichen Sicherheit totp zu installieren.
TZ: Stelle hier deine Zeitzone ein.
Netzwerk-Ports: Standardmäßig nutzt Guacamole Port 8080.
Speichere die Änderungen und starte das Add-on neu.
In Apache Guacamole Anmelden
Um Apache Guacamole jetzt zu Verwenden können wir uns unter der IP unseres Home Assistants und des gewählten Ports oder über die Ingress Einbindung mit den Standardzugangsdaten anmelden.
User: guacadmin
Passwort: guacadmin
Apache Guacamole Extensions
| Extension Name | Beschreibung |
|---|---|
| auth-ldap | LDAP-Authentifizierung |
| auth-duo | Duo-Zwei-Faktor-Authentifizierung |
| auth-header | HTTP-Header-Authentifizierung |
| auth-sso-cas | CAS-Authentifizierung |
| auth-sso-openid | OpenID-Connect-Authentifizierung |
| auth-totp | TOTP-Zwei-Faktor-Authentifizierung |
| auth-quickconnect | Erweiterung für Ad-hoc-Verbindungen |
| auth-sso-saml | SAML-Authentifizierung |
| auth-sso-ssl | SSL-/Smartcard-Authentifizierung |
| auth-sso | SSO-Authentifizierungs-Metapaket, enthält Klassen für CAS-, OpenID- und SAML-Authentifizierung |
| auth-json | Verschlüsselte JSON-Authentifizierung |
| history-recording-storage | In-App-Wiedergabe von Aufzeichnungen |
| vault | Unterstützung für das Abrufen von Geheimnissen aus Schlüsseltresoren |
| auth-ban | Erweiterung zum automatischen Blockieren von Brute-Force-Authentifizierungsversuchen |
| display-statistics | Anzeige von grafischen Statistiken am unteren Bildschirmrand für Remote-Desktop-Sitzungen (Remote-Desktop-FPS, Server-FPS, Client-FPS, verlorene Frames) |
Home Assistant Guacamole Benutzeroberfläche nutzen
Sobald das Add-on läuft, kannst du es über die Web-Oberfläche aufrufen. Klicke auf Öffnen im Add-on-Menü. Du wirst zur Anmeldeseite von Home Assistant Apache Guacamole weitergeleitet.
Nach dem Login kannst du verschiedene Verbindungen konfigurieren:
- Windows-PCs per RDP hinzufügen
- Linux-Server per SSH einrichten
- Raspberry Pi oder andere Geräte über VNC steuern
Jede Verbindung kann individuell mit IP-Adresse, Benutzername und Passwort eingerichtet werden.
Vorteile von Home Assistant Apache Guacamole
- Plattformunabhängig: Zugriff über jeden Webbrowser
- Zentrale Verwaltung: Alle Remote-Verbindungen in Home Assistant
- Sicherheit: Unterstützt verschlüsselte Verbindungen
- Einfache Integration: Funktioniert direkt über den Home Assistant Add-on Store
Fazit
Mit Home Assistant Apache Guacamole kannst du deine Remote-Verbindungen effizient verwalten und sicher von überall auf deine Systeme zugreifen. Die Installation und Einrichtung ist dank des Add-ons unkompliziert und bietet eine leistungsstarke Erweiterung für Home Assistant.
Hast du Fragen oder Probleme bei der Einrichtung? Hinterlasse einen Kommentar und teile deine Erfahrungen mit der Community!
Was ist Apache Guacamole?
Apache Guacamole ist eine clientlose Remote-Desktop-Gateway-Lösung, die es ermöglicht, auf Desktop-Systeme über einen Webbrowser zuzugreifen. Guacamole unterstützt verschiedene Protokolle wie VNC, RDP und SSH, sodass Benutzer ihre Systeme unabhängig vom verwendeten Gerät oder Betriebssystem remote steuern können.
Welche Protokolle unterstützt Apache Guacamole?
Apache Guacamole unterstützt die folgenden Protokolle:
RDP (Remote Desktop Protocol): Für den Zugriff auf Windows-basierte Systeme.
VNC (Virtual Network Computing): Für den Zugriff auf Unix-basierte Systeme oder Systeme, die VNC unterstützen.
SSH (Secure Shell): Für den sicheren Zugriff auf Unix-basierte Systeme über eine Kommandozeile.
Benötige ich spezielle Software auf meinem Computer, um Apache Guacamole zu nutzen?
Nein, Apache Guacamole ist ein clientloser Remote-Desktop-Client, den du direkt über einen Webbrowser verwenden kannst. Du benötigst keine spezielle Software, sondern nur einen Webbrowser, der HTML5 unterstützt.
Kann ich mehrere Benutzer in Apache Guacamole verwalten?
Ja, Apache Guacamole ermöglicht dir die Verwaltung von Benutzern und deren Berechtigungen. Du kannst Benutzerkonten erstellen und die Berechtigungen für spezifische Remote-Verbindungen festlegen. Das ist besonders nützlich, wenn du Guacamole in einer Unternehmensumgebung einsetzt.
Wie sicher ist Apache Guacamole?
Apache Guacamole bietet sichere Remote-Desktop-Verbindungen durch Verschlüsselung und ermöglicht die Verwendung von Authentifizierungsmethoden wie LDAP, Zwei-Faktor-Authentifizierung (TOTP) und Single Sign-On (SSO). Es ist jedoch wichtig, den Guacamole-Server gut zu konfigurieren und regelmäßig zu aktualisieren, um Sicherheitslücken zu vermeiden.
Kann ich Apache Guacamole für den Zugriff auf Cloud-basierte Systeme verwenden?
Ja, Apache Guacamole lässt sich für den Remote-Zugriff auf Cloud-basierte Systeme nutzen, solange diese RDP, VNC oder SSH unterstützen. Du kannst Guacamole auch in einer Cloud-Umgebung wie AWS oder Azure einsetzen, um von überall auf deine Systeme zuzugreifen.
Ist Apache Guacamole kostenlos?
Ja, Apache Guacamole ist Open Source und kostenlos. Es wird unter der Apache 2.0-Lizenz angeboten, was bedeutet, dass du es kostenlos verwenden, ändern und weiterverteilen kannst.
Welche Betriebssysteme werden von Apache Guacamole unterstützt?
Apache Guacamole läuft auf Linux, aber auch auf Windows oder macOS, sofern du geeignete Tools oder Virtualisierungslösungen verwendest. Der Zugriff auf Remote-Desktops ist über alle modernen Webbrowser möglich.
Kann ich Guacamole mit anderen Tools wie LDAP oder Google Auth integrieren?
Ja, Apache Guacamole lässt sich mit verschiedenen Authentifizierungssystemen wie LDAP, Google Authenticator (für Zwei-Faktor-Authentifizierung) und CAS (Central Authentication Service) integrieren. Dadurch kannst du eine zentralisierte Benutzerverwaltung einrichten und zusätzliche Sicherheitsmaßnahmen nutzen.
Welche Hardwareanforderungen gibt es für Apache Guacamole?
Die Hardwareanforderungen hängen von der Anzahl der Benutzer und Verbindungen ab, die du erwartest. Für kleine bis mittlere Installationen genügt ein Server mit moderaten Ressourcen (2-4 GB RAM, mehrere CPUs) und ausreichend Speicherplatz. Für größere Installationen solltest du zusätzliche Ressourcen einplanen, vor allem, wenn viele gleichzeitige Verbindungen bestehen.
Wie kann ich die Leistung von Apache Guacamole optimieren?
Um die Leistung von Apache Guacamole zu optimieren, solltest du sicherstellen, dass dein Server genügend CPU- und RAM-Ressourcen zur Verfügung hat. Es empfiehlt sich, die Netzwerkverbindung zu überwachen und die Serverkonfiguration gegebenenfalls anzupassen, um die Benutzererfahrung zu verbessern.
Bietet Apache Guacamole eine API?
Ja, Apache Guacamole stellt eine RESTful API zur Verfügung, mit der du Benutzer verwalten, Verbindungen konfigurieren und andere Funktionen programmatisch steuern kannst.