KPN glasvezel met UniFi gateway instellen: internet en KPN TV werkend krijgen

Steeds meer mensen willen het standaard modem van hun provider vervangen door een UniFi gateway, bijvoorbeeld een UCG Ultra, UCG Fiber, Gateway Max of Dream Machine. KPN biedt ruimte om eigen apparatuur te gebruiken, maar geeft ook aan dat je dan zelf verantwoordelijk bent voor de juiste configuratie en dat het slim is om de KPN-apparatuur achter de hand te houden voor tests bij storingen.

Heb je alleen internet, dan is de basisconfiguratie vrij overzichtelijk. Zodra je ook KPN TV gebruikt, komt daar multicast en IPTV-configuratie bij kijken, en dan moet de UniFi-inrichting echt goed staan om een stabiele verbinding te krijgen.

In dit blog leg ik stap voor stap uit hoe je een UniFi gateway instelt op KPN glasvezel, inclusief KPN TV. De uitleg is gebaseerd op de instellingen die in de praktijk goed werken met routed IPTV via udm-iptv op UniFi OS, waarbij internet via VLAN 6 loopt en IPTV via VLAN 4.

Klinkt dit nu al té technisch?

Maak gebruik van mijn remote-setup dienst.

Wat je nodig hebt

Voor deze opstelling ga ik uit van een werkende KPN glasvezelaansluiting met ONT, een UniFi gateway met UniFi OS en, als je televisie wilt gebruiken, een KPN TV-ontvanger. KPN adviseert op de pagina over eigen apparatuur om eerst goed te controleren welke aansluiting je hebt en om hun eigen modem terug te kunnen plaatsen als je wilt uitsluiten of een storing door je eigen router wordt veroorzaakt.

Gebruik je tussen de gateway en de tv-ontvanger nog een switch, dan is IGMP snooping belangrijk om multicastverkeer goed door te geven. KPN legt uit dat IGMP snooping niet per se verplicht is, maar in de praktijk wel belangrijk is om te voorkomen dat multicastverkeer je netwerk onnodig belast of dat de TV-box problemen krijgt.

Stap 1: internet instellen op de UniFi gateway

Ga in UniFi naar Settings > Internet en open je WAN-verbinding. Voor KPN gebruik je op de internetverbinding VLAN ID 6 en PPPoE.

In documentatie en praktijkvoorbeelden rond UniFi en KPN wordt voor deze methode vaak internet als gebruikersnaam en internet als wachtwoord gebruikt. De kern is in ieder geval dat het KPN-profiel op UniFi uitkomt op PPPoE over VLAN 6.

Gebruik je de gateway direct achter de ONT, laat dan extra IPTV-opties in de normale UniFi WAN-instellingen uit zolang je met udm-iptv werkt. In community-opstellingen en GitHub-discussies rond udm-iptv wordt juist benadrukt dat de IPTV/IGMP-proxy niet dubbel moet worden ingesteld via zowel UniFi als het script.

Stap 2: een apart IPTV-netwerk maken

Maak daarna in UniFi via Settings > Networks een apart netwerk aan voor de tv-ontvanger, bijvoorbeeld een netwerk met VLAN 3 of VLAN 4. Een apart TV-netwerk is een veelgebruikte en aanbevolen aanpak binnen routed IPTV-opstellingen op UniFi, omdat je multicast dan beter kunt scheiden van de rest van het LAN.

Zet op dit IPTV-netwerk IGMP Snooping aan. KPN beschrijft dat IGMP snooping helpt om multicastverkeer alleen naar de juiste poorten te sturen, en dat is precies wat je wilt voor een KPN TV-ontvanger.

Mijn praktische advies voor UniFi is om daarnaast het volgende te gebruiken:

• Fast Leave: aan.

• Auto Unknown Traffic Handling: uit.

• Querier Selection: uit wanneer je udm-iptv gebruikt en je merkt dat UniFi en het script elkaar in de weg zitten.

Dat laatste is vooral belangrijk in situaties waarin de tv-box wel start, maar beeld bevriest of wegvalt zodra multicast moet overnemen. In udm-iptv-omgevingen zie je vaker dat dubbele multicast- of proxyfunctionaliteit juist problemen geeft.

Bij het IPTV-netwerk kun je ook een Custom DHCP Option toevoegen. In routed IPTV-profielen voor KPN wordt DHCP option 60 met de waarde IPTV_RG gebruikt om een IPTV-profiel op te halen.

Voor UniFi voer je dat als volgt in op het IPTV-netwerk:

• Code: 60

• Type: Text

• Value: IPTV_RG

Gebruik daarna op de switchpoort waar de KPN TV-ontvanger op zit het juiste netwerkprofiel, zodat die poort echt in het IPTV-netwerk hangt. De udm-iptv documentatie noemt het controleren van het juiste VLAN en de juiste LAN-interface expliciet als belangrijke troubleshootstap.

Stap 4: udm-iptv installeren

Na het inloggen via SSH installeer je udm-iptv met het bekende installatiescript. In KPN/UniFi praktijkvoorbeelden wordt daarvoor het volgende commando gebruikt:

sh -c "$(curl https://raw.githubusercontent.com/fabianishere/udm-iptv/master/install.sh -sSf)"

Start daarna de configuratie met: udm-iptv configure

Kies in de wizard het KPN-profiel. De tool ondersteunt KPN expliciet en beschrijft dat internet via VLAN 6 loopt en IPTV via VLAN 4.

Kies vervolgens de juiste LAN interface voor jouw TV-netwerk. Gebruik je in UniFi bijvoorbeeld een IPTV VLAN met ID 3, dan hoort daar in de praktijk meestal br3 bij; gebruik je VLAN 4, dan is dat doorgaans br4. De koppeling tussen je TV-netwerk en de juiste LAN-interface is cruciaal, omdat de multicaststream anders op het verkeerde netwerk uitkomt.

Kies bij de IGMP-versie bij voorkeur IGMP v3. In moderne KPN IPTV-opstellingen en routerprofielen is IGMPv3 de logische keuze, onder meer vanwege Source-Specific Multicast-ondersteuning.

Heb je meerdere KPN TV-ontvangers in huis, zet quickleave dan uit. In praktijkvoorbeelden met UniFi en udm-iptv wordt genoemd dat quickleave anders de stream van een andere decoder kan verstoren zodra iemand van zender wisselt.

Stap 5: testen en controleren

Controleer na de configuratie altijd eerst of internet nog werkt. Voer daarna het volgende commando uit om de IPTV-configuratie te controleren: udm-iptv diagnose

Een goede diagnose laat zien dat het script een IP-adres op VLAN 4 heeft opgehaald, dat routes zijn aangemaakt en dat de IGMP proxy is gestart. Zie je daarna geen timeouts of andere fouten terug, dan is dat meestal een goed teken dat de routed IPTV-configuratie correct draait.

Controleer in de diagnose vooral deze onderdelen:

• WAN Interface: bijvoorbeeld eth4 op een Cloud Gateway.

• WAN VLAN: 4.

• LAN Interfaces: bijvoorbeeld br3 of br4, afhankelijk van jouw IPTV-netwerk.

• Service Logs: zonder terugkerende timeout-meldingen.

Blijft LAN Interfaces toch op br0 staan terwijl je een apart IPTV-netwerk gebruikt, controleer dan de configuratie opnieuw en kijk of de juiste bridge-interface is gekozen. De udm-iptvdocumentatie noemt expliciet dat je moet controleren of de ontvanger op het juiste VLAN zit en of IPTV-verkeer naar het juiste netwerk wordt doorgestuurd.

Veelvoorkomende problemen

Werkt KPN TV nog niet goed, controleer dan eerst of de tv-ontvanger echt op het juiste IPTV-netwerk zit. Een verkeerde VLAN-toewijzing is één van de meest voorkomende oorzaken van een niet-werkende of vastlopende TV-box in een UniFi-opstelling.

Krijg je wel kort beeld maar bevriest het daarna, kijk dan kritisch naar je multicast-instellingen. Problemen met IGMP snooping, queriergedrag of dubbele proxyfunctionaliteit zorgen in UniFi-omgevingen relatief vaak voor beeld dat na enkele seconden of minuten wegvalt.

Gebruik je een tussenliggende switch, test dan ook altijd even rechtstreeks op de gateway. De udm-iptv troubleshooting noemt dat je moet controleren of het IPTV-verkeer naar het juiste VLAN wordt doorgestuurd, en bij KPN TV zie je in de praktijk dat een switch zonder goede IGMP-afhandeling snel voor problemen zorgt.

Bij sommige compacte switches ontbreken multicastfuncties of is de ondersteuning beperkt. Ubiquiti-communityvoorbeelden laten bijvoorbeeld zien dat de Flex Mini geen IGMP snooping ondersteunt, wat direct invloed kan hebben op KPN TV via multicast.

Zelf doen of laten instellen?

Met de juiste instellingen is KPN glasvezel op een UniFi gateway prima werkend te krijgen, ook met KPN TV. Het belangrijkste is dat je de basis goed neerzet: internet op VLAN 6 met PPPoE, IPTV via VLAN 4 met udm-iptv, een apart TV-netwerk, correcte DHCP/IGMP-instellingen en de juiste bridge-interface in de configuratie.

Wil je liever dat ik het voor je op afstand goed instel, controleer en optimaliseer? Bekijk dan mijn dienst Remote setup van uw UniFi netwerk en laat mij de instellingen van je UniFi netwerk of console netjes voor je inregelen.

Remote Setup: Ik configureer uw netwerk op afstand.

Heeft u UniFi apparatuur aangeschaft, maar ontbreekt het aan tijd of kennis om deze naar wens in te stellen? Ik kan dit als UniFi specialist op afstand voor u inregelen.

Gebruik mijn Remote Setup dienst →