Quelltext der Seite PiKVM hinter Apache Reverse Proxy

'''<u>Changelog:</u>'''
* 2021-01-29 erste Version
* 2021-10-05 Regeln für Terminal hinzugefügt, funktioniert nun auch
----
==Vorwort==
Hurra! mein PiKVM läuft! Sogar mit einem zusätzlichen 4 Port HDMI/USB KVM Switch! https://github.com/pikvm/pikvm<br>
Fehlt noch der Zugriff von extern darauf:<br>
<br>
Ich betreibe eigentlich immer alles unter einer jeweils eigenen Subdomain hinter einem Apache Revers Proxy. Dieser verwaltet dann auch die dazu passenden Lets Encrypt Zertifikate<br>
Dementsprechent wollte ich auch meinen PiKVM so erreichbar machen, scheiterte aber zunächst an der WebSocket Konfiguration. Ein wenig davon kannte ich schon Gucamole, aber es zickte Anfangs rum.<br>
Wie so oft musste ich mir die Lösung aus vielen Quellen zusammensuchen<br>
<br>
In diesem Beispiel gilt folgenden
 192.168.178.2   = IP-Adresse des Apache Reverse Proxy Linux Servers (Ubuntu 20.04)
 192.168.178.18  = IP-Adresse des PiKVM
 kvm.znil.net    = Subdomain unter welcher der PiKVM per Reverse Proxy erreichbar sein soll
<br>
----

==Voraussetzungen Apache Reverse Proxy==
Folgende Module des Apache müssen aktiviert sein:
 a2enmod rewrite
 a2enmod proxy_http
 a2enmod ssl
 a2enmod proxy_wstunnel
<br>
----
==Konfiguration der Subdomain==
Hier eine eigene Konfigurationsdatei, angelegt als
 /etc/apache2/sites-available/kvm.znil.net.vhost
mit folgendem Inhalt:<br>
<source>
<VirtualHost 192.168.178.2:80>
        # Umleitung http zu https
        ServerName kvm.znil.net
        ServerAdmin webmaster@znil.net
        RewriteEngine On
        RewriteCond %{HTTPS} !=on
        RewriteRule ^/?(.*) https://%{SERVER_NAME}/$1 [R,L]
</VirtualHost>

<VirtualHost 192.168.178.2:443>
        ServerName kvm.znil.net
        ServerAdmin webmaster@kvm.znil.net
        SSLEngine on
        SSLProtocol All -SSLv2 -SSLv3 -TLSv1 -TLSv1.1
        SSLCertificateFile /etc/letsencrypt/live/kvm.znil.net/fullchain.pem
        SSLCertificateKeyFile /etc/letsencrypt/live/kvm.znil.org/privkey.pem

        SSLProxyEngine On
        SSLProxyVerify none
        SSLProxyCheckPeerCN off
        SSLProxyCheckPeerName off
        SSLProxyCheckPeerExpire off

        RewriteEngine on
        RewriteCond ${HTTP:UPGRADE} ^WebSocket$ [NC]
        RewriteCond ${HTTP:CONNECTION} ^Upgrade$ [NC]
        RewriteRule .* wss:/192.168.178.18%{REQUEST_URI} [P,L]

        ProxyPass /extras/webterm/ttyd/ws wss://192.168.178.18/extras/webterm/ttyd/ws
        ProxyPass /extras/webterm/ttyd/ https://192.168.178.18/extras/webterm/ttyd/
        ProxyPassReverse /extras/webterm/ttyd/ https://192.168.178.18/extras/webterm/ttyd/

        ProxyPass / https://192.168.178.18/
        ProxyPassReverse / https://192.168.178.18/

        <Location /api/ws>
                Order allow,deny
                Allow from all
                ProxyPass wss://192.168.178.18/api/ws
                ProxyPassReverse wss://192.168.178.18/api/ws
        </Location>

        ProxyRequests off
</VirtualHost>
</source>
Ihr müsste also alle
 * <code>192.168.178.2</code> durch die lokale IP-Adresse von eurem Apache Revers Proxy ersetzen
 * <code>192.168.178.18</code> durch die IP-Adresse eures PiKVM ersetzen
 * <code>kvm.znil.net</code> durch eure Domäne/Subdomäne ersetzen
 * <code>webmaster@kvm.znil.net</code> durch eine eurer Email-Adressen ersetzen
 * <code>/etc/letsencrypt/live/kvm.znil.net/</code> mit den Pfaden zu eurem Zertifikat ersetzen
<br>
Jetzt könnt die die Seite noch aktivieren<br>
 a2ensite kvm.znil.net.vhost
und den Apache neu starten:<br>
 systemctl restart apache2.service
<br>
Jetzt müsste es gehen!<br>
Für die Verlängerung des Lets Encrypt Zertifikates empfehle ich euch [[Lets Encrypt Zertifikate erneuern mit Apache Reverse Proxy]]
<br>
----

==Kommentare==
<comments />