IPTV single-line reuse: VLAN, IGMP proxy and STB passthrough
Status: E1 documentation. VLAN IDs, STB DHCP options and IGMP behavior are ISP/STB-specific. Use only your own legitimate IPTV service; source lists, decryption and bypassing operator restrictions are out of scope.
Two ways to do “single-line reuse”
Section titled “Two ways to do “single-line reuse””| Mode | What OpenWrt does | STB location | Complexity | When |
|---|---|---|---|---|
| IPTV VLAN passthrough | Bridges the IPTV VLAN to a dedicated port, untagged | Wired to that port | Low | STB does its own DHCP/IGMP; best first choice |
| IGMP proxy | Routes the IPTV VLAN to LAN and proxies multicast | Any LAN port/Wi-Fi | Higher | You need one LAN and no dedicated STB port |
Do not mix them blindly. Passthrough is a Layer-2 bridge; IGMP proxy is Layer 3 routing plus multicast. “IPTV works” means different things in each mode.
Topology
Section titled “Topology”ONT (bridge) │ one cable, tagged VLANs ├── VLAN 41 → PPPoE → internet └── VLAN 45 → IPTV ├── passthrough: br-wan.45 → iptv port (untagged) → STB └── IGMP proxy: br-wan.45 → igmpproxy → LAN → STBVLAN IDs are examples. Get the real internet/IPTV VLANs from the ISP, the ONT, or the old router. Do not copy 41/45.
Before changing
Section titled “Before changing”cat /etc/openwrt_releaseuci show networkuci show firewallip -d link showbridge vlan show 2>/dev/null- Record the old router’s IPTV VLAN, STB port, DHCP option 60/61 if used, and whether the STB does PPPoE/DHCP itself.
- Back up OpenWrt and, if possible, the ONT config.
- Keep the old router/STB path until the new path works.
- Change one layer at a time: ONT bridge → VLAN → passthrough or IGMP.
ExpectedYou can restore the old router/ONT and still reach a console.
Mode A: IPTV VLAN passthrough
Section titled “Mode A: IPTV VLAN passthrough”This is the simplest and most robust option when the STB can do its own DHCP/IGMP.
# Example DSA bridge: internet and IPTV tagged on WAN, IPTV untagged on a dedicated portuci set network.brwan=deviceuci set network.brwan.name='br-wan'uci set network.brwan.type='bridge'uci add_list network.brwan.ports='wan'uci add_list network.brwan.ports='iptv'
uci add network bridge-vlanuci set network.@bridge-vlan[-1].device='br-wan'uci set network.@bridge-vlan[-1].vlan='41'uci add_list network.@bridge-vlan[-1].ports='wan:t'
uci add network bridge-vlanuci set network.@bridge-vlan[-1].device='br-wan'uci set network.@bridge-vlan[-1].vlan='45'uci add_list network.@bridge-vlan[-1].ports='wan:t'uci add_list network.@bridge-vlan[-1].ports='iptv:u'
uci commit network/etc/init.d/network reloadwan:t= tagged WAN;iptv:u= untagged STB port;- do not put the IPTV port in the LAN bridge;
- no IP address/firewall zone is required for pure passthrough;
- the STB must send its own DHCP/IGMP on that port;
- if the STB needs a tagged VLAN, use
iptv:tand configure the STB accordingly.
Verify:
bridge vlan showip -d link show br-wanMode B: IGMP proxy
Section titled “Mode B: IGMP proxy”Use this only when the STB must sit on the normal LAN.
apk add igmpproxyuci set network.iptv=interfaceuci set network.iptv.proto='dhcp'uci set network.iptv.device='br-wan.45'uci commit network/etc/init.d/network reload
uci set igmpproxy.@igmpproxy[0]=igmpproxyuci set igmpproxy.@igmpproxy[0].quickleave='1'uci set igmpproxy.@phyint[0]=phyintuci set igmpproxy.@phyint[0].network='iptv'uci set igmpproxy.@phyint[0].direction='upstream'uci add_list igmpproxy.@phyint[0].altnet='0.0.0.0/0'uci set igmpproxy.@phyint[1]=phyintuci set igmpproxy.@phyint[1].network='lan'uci set igmpproxy.@phyint[1].direction='downstream'uci commit igmpproxy/etc/init.d/igmpproxy enable/etc/init.d/igmpproxy restartThen:
- put
iptvin a firewall zone that allows IGMP and the IPTV UDP traffic; - allow forwarding from
iptvtolanfor multicast, not a blanket WAN→LAN forward; - make sure the LAN has an IGMP querier/snooping policy appropriate for your switches/APs;
- check
logread -ffor IGMP joins andigmpproxyerrors; - if the STB uses DHCP option 60/61, configure the DHCP client/relay accordingly;
- do not enable NAT for multicast; NAT is for unicast.
Verify
Section titled “Verify”bridge vlan showip -d link show br-wanip addr show br-wan.45logread -fcat /proc/net/igmpOn the STB/client:
- does it get an IP in the expected IPTV subnet?
- does it join a multicast group?
- does video start only after a channel change?
- does passthrough work when connected directly to the ONT/old router?
ExpectedYou know whether the failure is VLAN, DHCP, IGMP or firewall.
Failure matrix
Section titled “Failure matrix”| Symptom | Check first | Common cause |
|---|---|---|
| No IPTV after ONT bridge | IPTV VLAN ID, tag/untag, ONT bridge | wrong VLAN; IPTV port still in LAN bridge; ONT not trunking |
| STB gets IP, no video | IGMP join, multicast route, firewall | IGMP proxy not running; multicast blocked; wrong upstream |
| IPTV works, internet fails | internet VLAN/PPPoE, default route | IPTV VLAN mixed with WAN; PPPoE on wrong device |
| Video freezes/stutters | IGMP snooping/querier, bandwidth, Wi-Fi | multicast flooded; weak Wi-Fi; STB on Wi-Fi |
| Works on old router only | old router’s IPTV VLAN/port | new VLAN or STB DHCP option differs |
| Works after reboot only sometimes | service order, DHCP lease, IGMP cache | igmpproxy not enabled; STB lease timing |
Recovery
Section titled “Recovery”- Reconnect the STB to the old router/ONT path.
- Restore the OpenWrt backup or remove the IPTV VLAN changes.
- If passthrough fails, try a dedicated untagged port before adding IGMP proxy.
- If IGMP proxy fails, fall back to passthrough; do not stack both.
- Keep console access; a bad bridge/VLAN can cut both internet and IPTV.
E1 status
Section titled “E1 status”- No real IPTV line, STB or multicast service was tested.
- VLAN IDs, DHCP options, IGMP behavior and firewall needs vary by ISP/STB.
- Passthrough and IGMP proxy are separate modes; do not mark either as E2 without a reproducible lab or line test.
- No independent reviewer; no guarantee for a specific operator.
- Legal/ToS: only your own service; no source lists, decryption or restriction bypass.
Sources
Independent OpenWrt notes. Every page states the firmware, device, package manager and way back.
Icons: Solar by 480 Design, CC BY 4.0