Nginx Proxy für TVHeadend mit Unterverzeichnis

Meine TVHeadend Instanz Zuhause sollte über das Internet erreichbar werden. Hinter dem DSL Router ist ein Webserver erreichbar, den ich dafür als Proxy zu meinem TVHeadend-Server nutzen will. Über den Webserver laufen allerdings noch ein paar andere Dienste, sodass ich TVH nicht das Rootverzeichnis überlassen will. Das THV Webinterface soll stattdessen über ein Unterverzeichnis „/tv/recorder“ erreichbar sein, also z.B. so: https://server.tld/tv/recorder.

TVHeadend läuft auf dem Server mit der IP 192.168.2.111 auf Port 9981. Die Konfiguration von Nginx kann z.B. so aussehen:

server {
    server_name server.tld;
    
    listen 80 default_server;
    listen [::]:80 default_server;
    
    root /var/www;
    
    [ ... ]
    
    location /tv/recorder {
        access_log off;
        proxy_pass http://192.168.2.111:9981/;
    }
}

Von wesentlicher Bedeutung ist hier eigentlich nur der location Block, der /tv/recorder behandelt. Besonders wichtig ist der Abschließende Trailing-Slash hinter der Zieladresse mit dem Ziel-Port! Ohne den Slash kann TVHeadend die Anfrage nicht verarbeiten, weil die angeftagte Adresse für die Software dann so aussieht: /tv/recorder/extjs.html. Dieser Pfad existiert für TVH nicht. Durch den Trailing-Slash wird der Unterverzeichnis-Pfad für TVH entfernt, sodass es die Anfrage verarbeiten kann.

Wenn das TVHeadend Webinterface über das Internet erreichbar ist, empfehle ich, eine HTTP Base Auth gleich mit einzurichten: Nginx: HTTP Base Auth einrichten