Self-host iptv-proxy
v4.7.1IPTV reverse proxy for M3U and Xtream Codes
- Stars
- 736
- Ports
- 8080 (HTTP proxy server), 5004 (HDHomeRun tuner (optional))
pierro777/iptv-proxyWhat is iptv-proxy?
This tool sits between your IPTV provider and your players. You give it a playlist URL or Xtream Codes credentials, and it serves the same content from a local address using a username and password you define. Apps like TiviMate, IPTV Smarters, VLC, and Kodi connect to the proxy instead of the provider directly. Media servers such as Plex, Jellyfin, Emby, and Channels DVR can treat the live channels as a virtual HDHomeRun tuner with a matched electronic program guide. The software runs as a single Go binary or Docker image with no database. It supports multiple users with individual stream limits, regular-expression channel filtering, HLS proxying, cached failover when the provider goes down, and merging several provider accounts into one catalogue. All settings come from flags, environment variables, or a YAML file. A read-only status page shows current streams and system health.
Should you self-host iptv-proxy?
iptv-proxy scores 55/100 on selfhost.directory (how scoring works) and ranks #24 of 54 in Media Streaming. It has 736 GitHub stars.
It shipped 10 stable releases in the past year. The latest, v4.7.1, came out on 5 October 2026.
Setup is easy: most people get it running in one sitting. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Go.
Its closest alternative on selfhost.directory is Invidious (81/100, 25 800 stars). It scores higher overall, so compare the two before you pick. See iptv-proxy vs Invidious side by side.
Features
- Channel Filtering
- Configuration via flags, env vars, or YAML
- HDHomeRun tuner emulation
- HLS stream proxying
- Logo proxying
- M3U/M3U8 playlist proxy
- Multiple provider sources merging
- Multiple users with connection limits
- No Database Required
- Provider failover with cached responses
- Read-only status page
- Reverse proxy / HTTPS support
- Stream sharing
- Xtream Codes API proxy
- Xtream passthrough mode
iptv-proxy README
More in Proxy
LadderSelf-hosted, open-source HTTP proxy that strips CORS and paywall headers, injects code, and applies per-domain YAML rulesets; runs as a Go binary, Docker or Helm chart.
LucX-UILucX-UI is a self-hosted Xray VPN panel forked from 3x-ui adding kernel-mode AmneziaWG, tunnel sidecars, and advanced subscriptions.
marretaOpen-source, self-hosted paywall bypasser that cleans pages, strips tracking parameters and blocks domains, run via Docker Compose with an admin panel and REST API.
meridianMeridian is an open-source CLI that deploys censorship-resistant VLESS+Reality, XHTTP, and Hysteria2 proxy servers on your VPS with automatic hardening.
MirrorProxyMirrorProxy is a self-hosted, open-source mirror acceleration gateway for GitHub, Docker/OCI, language packages, and Linux/BSD repos with access control and quotas.
mtgmtg is a self-hosted, open-source MTProto proxy for Telegram designed to work in censored environments with domain fronting, traffic mimicry, and proxy chaining support.
mullgateSelf-hosted command-line tool converting a Mullvad account into multiple authenticated proxy endpoints for selective traffic routing.
naiveproxyYurich Panel is a Bash script that automates deploying a proxy service on Ubuntu VPS with Caddy, Naive transport, Xray, Hysteria 2, WARP, and Unbound DNS.
NetsGoSelf-hosted tunneling platform with built-in web console, REST API, and single-binary deployment for exposing private HTTP, TCP, and UDP services.
nginx-proxySelf-hosted Nginx reverse proxy for Docker: this open-source container writes vhost configs from running containers and reloads them, with HTTPS and load balancing.
Nova ServerSelf-hosted proxy running Xray, sing-box, AmneziaWG behind one port with trilingual admin panel, multi-user management, Iran bridge tunnels, Telegram bot.
npsSelf-hosted, open-source Go NAT-traversal proxy: pair the nps server with npc clients to expose tcp, udp, domain, socks5 and p2p services behind private networks.
0 comments