Skip to content

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.

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.

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 → STB

VLAN IDs are examples. Get the real internet/IPTV VLANs from the ISP, the ONT, or the old router. Do not copy 41/45.

Router shellRecord the working IPTV path and a rollback
Terminal window
cat /etc/openwrt_release
uci show network
uci show firewall
ip -d link show
bridge 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.

This is the simplest and most robust option when the STB can do its own DHCP/IGMP.

Terminal window
# Example DSA bridge: internet and IPTV tagged on WAN, IPTV untagged on a dedicated port
uci set network.brwan=device
uci 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-vlan
uci 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-vlan
uci 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 reload
  • wan: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:t and configure the STB accordingly.

Verify:

Terminal window
bridge vlan show
ip -d link show br-wan

Use this only when the STB must sit on the normal LAN.

Terminal window
apk add igmpproxy
uci set network.iptv=interface
uci 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]=igmpproxy
uci set igmpproxy.@igmpproxy[0].quickleave='1'
uci set igmpproxy.@phyint[0]=phyint
uci 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]=phyint
uci 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 restart

Then:

  • put iptv in a firewall zone that allows IGMP and the IPTV UDP traffic;
  • allow forwarding from iptv to lan for multicast, not a blanket WAN→LAN forward;
  • make sure the LAN has an IGMP querier/snooping policy appropriate for your switches/APs;
  • check logread -f for IGMP joins and igmpproxy errors;
  • if the STB uses DHCP option 60/61, configure the DHCP client/relay accordingly;
  • do not enable NAT for multicast; NAT is for unicast.
Router shellCheck VLAN, STB address, IGMP membership and video
Terminal window
bridge vlan show
ip -d link show br-wan
ip addr show br-wan.45
logread -f
cat /proc/net/igmp

On 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.

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
  1. Reconnect the STB to the old router/ONT path.
  2. Restore the OpenWrt backup or remove the IPTV VLAN changes.
  3. If passthrough fails, try a dedicated untagged port before adding IGMP proxy.
  4. If IGMP proxy fails, fall back to passthrough; do not stack both.
  5. Keep console access; a bad bridge/VLAN can cut both internet and IPTV.
  • 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

Router.Homes

Independent OpenWrt notes. Every page states the firmware, device, package manager and way back.

Icons: Solar by 480 Design, CC BY 4.0