Doorgaan naar hoofdinhoud

Netwerken

Onofficiële Beta-vertaling

Deze pagina is vertaald door PageTurner AI (beta). Niet officieel goedgekeurd door het project. Een fout gevonden? Probleem melden →

Als serversoftware biedt Jellyfin verschillende diensten aan via het netwerk. Specifiek ondersteunt Jellyfin het streamen van inhoud en wordt geleverd met een webclient. Dit werkt uitsluitend via de HTTP(S)-poorten.

Daarnaast biedt Jellyfin in lokale netwerken diverse automatische detectiediensten. Deze werken niet buiten je lokale subnet.

Als volledig zelf-gehoste software draait Jellyfin onafhankelijk van het internet. Je hoeft je server niet via het internet toegankelijk te maken. Jellyfin vereist ook geen internetverbinding om te functioneren; let er wel op dat metadata wordt geladen van verschillende aanbieders, wat zonder internetverbinding niet werkt.

Poortbindingen

Dit gedeelte geeft een beheerder inzicht in welke poorten Jellyfin gebruikt en waarvoor ze dienen.

PortProtocolConfigurableDescription
8096TCP✔️Default HTTP
8920TCP✔️Default HTTPS
7359UDPClient Discovery
See details
  • HTTP Traffic (8096/TCP): The web frontend can be accessed here. You can modify this setting from the Networking page in the admin settings.

  • HTTPS Traffic (8920/TCP): Used when https is enabled. By default this port will not be used. This setting can also be modified from the Networking page to use a different port.

  • Client Discovery (7359/UDP): Allows clients to discover Jellyfin on the local network. A broadcast message to this port will return detailed information about your server that includes name, ip-address and ID.

Jellyfin benaderen

Dit gedeelte richt zich op het toegankelijk maken van Jellyfin binnen netwerken. Hier vind je beschrijvingen voor zowel lokale toegang als toegang via het internet.

Over het algemeen is Jellyfin lokaal beschikbaar op de opgegeven poort via het host-IP - bijv. http://10.0.0.2:8096. Het is ook mogelijk een lokale DNS-entry aan te maken die naar je Jellyfin-server verwijst - bijv. http://jellyfin.local:8096.

Learn more about limitations with local DNS

Devices like Google Chromecast or Google Streamer use hardcoded DNS Servers - therefore they will not make use of your local DNS entries. There are multiple workarounds for this issue.

The easiest involves the usage of IPv6 Entries in the public DNS. Since IPv6 addresses do not differentiate between local and public, the address will be abled to be resolved locally. This, however, requires the use of a public DNS server - The Jellyfin Server does not have to be accessible from the outside though!

Firewall / Poortforwarding

Netwerken worden meestal van elkaar gescheiden door firewalls. Deze blokkeren al het inkomende verkeer om het netwerk te beschermen. Om Jellyfin door deze grenzen heen te bereiken, moeten de poorten worden doorgestuurd / geopend in de betreffende firewalls.

Let op: het openen van een poort geeft volledige toegang tot die poort voor het hogere netwerk. Een poort direct naar het internet openen is daarom onveilig en wordt afgeraden.

Firewalls kunnen op verschillende lagen worden geplaatst:

LayerExampleDescription
LocalDocker, VMOpen ports at this layer to allow traffic from the Host to enter the Application
Hostphysical machine, operating systemOpen ports at this layer to allow traffic from the Network to enter the Host device
NetworkRouterOpen ports at this layer to allow traffic from the Internet to enter the Local Network
Port forwarding vs. opening a Port

Whilst Routers often allow you to forward a port, firewalls typically only allow you to open one. The difference is within the Target. Opening a Port essentially just means that traffic on this Port will go through. Forwarding a Port you typically do in NAT scenarios - traffic is coming in on your public IP Address, what device inside your network should receive it. Sometimes, port forwarding also lets you map an external port to a different internal port.

How to open a Port

How exactly a port will be opened depends on your firewall software and its UI. Here is linked below how to open ports for:

Externe toegang

Omdat Jellyfin volledig zelf wordt gehost, moet je het handmatig beschikbaar maken voor internet. Hiervoor heb je een methode nodig om de HTTP(S)-poorten op afstand te benaderen. Automatische detectie werkt alleen lokaal en mag niet extern worden blootgesteld.

Voor externe toegang tot een server moet er een manier zijn om deze of zijn netwerk op internet te vinden. Dit kan via het publieke IP-adres van het apparaat of bij IPv6 rechtstreeks via het IP-adres van de server.

Om het IP-adres op te slaan is een domeinnaam gebruiken de eenvoudigste optie, waarbij je vertrouwt op DNS om dit op te lossen. Dit kan ook worden gebruikt om het 'huidige IP-adres' op te slaan bij een dynamisch publiek IP-adres. Het gebruik van een domeinnaam is echter niet verplicht.

Er zijn meerdere manieren om Jellyfin extern beschikbaar te maken - de meest voorkomende zijn:

  • poorten rechtstreeks naar internet doorsturen (niet aanbevolen!)

  • doorsturen via een reverse proxy

  • een VPN-verbinding gebruiken om het netwerk binnen te komen

  • een VPS gebruiken als reverse proxy naar je thuisnetwerk

Meer informatie over reverse proxies vind je in onze speciale gids voor reverse proxies.

SSL / HTTPS

Het gebruik van HTTPS om de server te benaderen wordt aanbevolen. Standaard is HTTPS uitgeschakeld omdat hiervoor een SSL-certificaat vereist is.

SSL-certificaten worden meestal uitgegeven door een derde partij en verifiëren dat de server en URL aan elkaar zijn toegewezen. Gebruik een vertrouwde certificaatautoriteit zoals Let's Encrypt bij gebruik van HTTPS.

let op

Zelfondertekende certificaten veroorzaken beveiligings- en compatibiliteitsproblemen en worden sterk afgeraden.

Hoewel Jellyfin HTTPS ondersteunt, raden we sterk aan om HTTPS-terminatie apart af te handelen op een reverse proxy. Meer informatie over de instellingen vind je op onze pagina over reverse proxies.

Het wordt ten zeerste aanbevolen om je SSL-sterkte en serverbeveiliging te controleren op SSLLabs als je deze services via internet beschikbaar stelt.

Basis-URL

Het uitvoeren van Jellyfin met een pad (bijv. https://example.com/jellyfin) wordt ondersteund.

let op

Basis-URL staat erom bekend compatibiliteitsproblemen te veroorzaken met HDHomeRun, de DLNA-plugin, Sonarr, Radarr en MrMC.

De Basis-URL-instelling wordt gebruikt om het URL-voorvoegsel op te geven waaronder je Jellyfin-instance toegankelijk is. In de praktijk voegt dit een URL-fragment toe aan het begin van elk URL-pad. Bijvoorbeeld: als je een Jellyfin-server hebt op http://myserver en de hoofdpagina op http://myserver/web/index.html, zal het instellen van een Basis-URL als /jellyfin deze hoofdpagina veranderen in http://myserver/jellyfin/web/index.html. Dit kan handig zijn als beheerders meerdere Jellyfin-instances onder één domeinnaam willen benaderen, of als de Jellyfin-instance alleen op een subpad van een ander domein draait waar ook andere services actief zijn op /.

De ingevoerde waarde op de configuratiepagina wordt automatisch genormaliseerd met een voorafgaande / als deze ontbreekt.

Voor het wijzigen van deze instelling is een serverherstart vereist, om te voorkomen dat bestaande paden ongeldig worden tot de beheerder klaar is voor de verandering.

Er zijn drie belangrijke aandachtspunten bij deze instelling.

  1. Bij het instellen van een nieuwe Basis-URL (bijv. van / naar /baseurl) of het wijzigen ervan (bijv. van /baseurl naar /newbaseurl), zal de Jellyfin-webserver automatisch omleidingen afhandelen om te voorkomen dat gebruikers ongeldige pagina's zien. Zo wordt bij een server met Basis-URL /jellyfin die op het pad / wordt benaderd, automatisch /jellyfin toegevoegd. Bij het volledig verwijderen van een Basis-URL (bijv. van /baseurl naar /, een lege waarde in de configuratie) gebeurt dit echter niet - alle URL's met het oude pad worden ongeldig en geven 404-fouten. Houd hier rekening mee bij het verwijderen van een bestaande Basis-URL.

  2. Clientapplicaties ondersteunen momenteel over het algemeen de Basis-URL-omleidingen niet impliciet. Daarom moet bijvoorbeeld in de Android TV-app de Host-instelling ook de Basis-URL bevatten (bijv. http://myserver:8096/baseurl), anders mislukt de verbinding.

  3. Eventuele reverse-proxy-configuraties moeten worden aangepast voor een nieuwe Basis-URL. Over het algemeen werkt het doorsturen van / naar de Jellyfin-instance in alle gevallen goed, waarbij de paden automatisch worden genormaliseerd. Dit is de standaardconfiguratie in onze voorbeelden. Houd hier echter rekening mee bij geavanceerdere routering.