Pagina vier van een lange ZimaOS-ondersteuningsdiscussie volgt de terugkerende problemen van één gebruiker met Jellyfin en Nginx Proxy Manager na de eerste succesvolle configuratie voor externe toegang. De belangrijkste les is niet één magische poort: een 502-fout kan terugkeren wanneer de reverse-proxydoelserver, de poorttoewijzing van Jellyfin, het Docker-netwerk of de applicatiestatus verandert.
Deze pagina behandelt alleen berichten 61–80. De eerdere DuckDNS- en certificaatconfiguratie die elders in dezelfde thread wordt behandeld, wordt niet herhaald.
Scheid de NPM-API-melding van de Jellyfin 502-fout
De gebruiker zag eerst “Communicatie met de API mislukt, draait NPM correct?” Uit beoordeling van communitylogs bleek dat Nginx Proxy Manager zelf actief was en dat de vernieuwing van Let's Encrypt was geslaagd. De tijdelijke API-melding kon daarom het gevolg zijn van een verouderde browsersessie of een korte onderbreking tussen de gebruikersinterface en de backend, terwijl de openbare 502-fout een afzonderlijk proxy-naar-Jellyfin-probleem bleef.
Houd de drie adrestypen gescheiden
| Adrestype | Voorbeeldrol | Moet NPM hiernaar doorsturen? |
|---|---|---|
| Openbaar WAN-adres | Door DuckDNS bijgewerkt adres aan de kant van de internetprovider | Nee |
| ZimaOS-LAN-adres | Stabiel adres op het thuisnetwerk, zoals 192.168.1.50
|
Ja, wanneer Jellyfin een hostpoort publiceert |
| Docker-containeradres of -naam | Interne endpoint zoals jellyfin:8096
|
Ja, maar alleen wanneer NPM toegang heeft tot hetzelfde Docker-netwerk |
In de thread werd herhaaldelijk gewisseld tussen een containernaam, een LAN-adres van de host en een intern Docker-adres. Deze zijn niet onderling uitwisselbaar. Kies één ondersteunde route en test die vanuit de NPM-container voordat je TLS of DNS wijzigt.
Lees de poorttoewijzing in de juiste richting
De Jellyfin-instellingen toonden hostpoort 8097 gekoppeld aan containerpoort 8096. Wanneer NPM verbinding maakt via het ZimaOS-LAN-adres, moet het de gepubliceerde hostpoort gebruiken. Wanneer NPM rechtstreeks via de containernaam op een gedeeld Docker-netwerk verbinding maakt, gebruikt het normaal gesproken de interne poort van Jellyfin.
Een verbindingsreset vanuit NPM liet zien dat de geselecteerde route nog steeds geen geldige Jellyfin-reactie opleverde. Dat is nuttiger bewijs dan simpelweg beide containers opnieuw starten.
Gebruik een gelaagde diagnosevolgorde
- Open Jellyfin lokaal en bevestig het afspelen voordat je de proxy aanpast.
- Controleer of de Jellyfin-container actief is en lees de opgeslagen host-/containerpoortkoppeling.
- Kies óf het stabiele LAN-adres van ZimaOS met de gepubliceerde hostpoort, óf een containernaam met een interne poort op een gedeeld netwerk.
- Test dat exacte eindpunt vanuit de NPM-omgeving.
- Schakel TLS pas opnieuw in nadat HTTP-routering werkt en test vervolgens het openbare domein.
- Herhaal na elke wijziging van een app of herstart de lokale tests en proxyt tests voordat je DNS wijzigt.
Een wijziging van het mediapad kan een ander probleem veroorzaken
Later konden externe gebruikers door Jellyfin bladeren, maar geen media afspelen. De eigenaar wijzigde de containerinstellingen van Jellyfin, waarna de openbare site niet meer reageerde. Uit controle van de communitylogboeken bleek vervolgens dat Jellyfin actief was en bezig was met scannen van /Media/Movies, waardoor de aandacht weer naar het proxyd oel ging. Dit laat zien waarom elke wijziging afzonderlijk moet worden vastgelegd en getest.
Linux-paden zijn hoofdlettergevoelig tijdens het maken van een back-up
Een configuratieback-up mislukte omdat de opdracht verwees naar /DATA/AppData/duckdns, terwijl de echte map /DATA/AppData/DuckDNS. Linux behandelt dit als verschillende paden. In de brondiscussie werd een door de community gemaakt archiveringscommando voorgesteld, maar dit was niet door IceWhale verstrekt en wordt daarom hier niet als officiële back-upprocedure weergegeven.
Maak vóór het archiveren van AppData een lijst van de exacte mapnamen, stop toepassingen wanneer hun databases een consistente momentopname vereisen en controleer het archief door een kopie ervan naar een tijdelijke locatie terug te zetten.
Momenteel ondersteunde toegang op afstand
Voor beheer en bestandstoegang documenteert de huidige ZimaOS-documentatie versleutelde peer-to-peer-toegang via toegang op afstand met ZimaClient. Een openbare reverse proxy voor Jellyfin blijft een geavanceerde workflow van derden en mag alleen de mediaservice beschikbaar stellen, niet het ZimaOS-dashboard.
Jellyfin-FAQ over fout 502
Bewijst ‘NPM API failed’ dat NPM is gestopt?
Nee. In de thread waren de NPM-logboeken en de certificaatvernieuwing in orde, terwijl de browser die melding weergaf.
Moet NPM poort 8096 of 8097 gebruiken?
Gebruik de interne poort bij directe containernetwerken, of de gepubliceerde hostpoort wanneer je doorstuurt naar het LAN-adres van ZimaOS.
Waarom gaf de back-up aan dat DuckDNS niet bestond?
De echte map AppData gebruikte een hoofdletter D, net als DNS; Linux-paden zijn hoofdlettergevoelig.
