explaingit

ab77/netflix-proxy

Analysis updated 2026-07-03

3,729PythonAudience · ops devopsComplexity · 3/5LicenseSetup · moderate

TLDR

A self-hosted DNS proxy you run on a cheap cloud server to unblock geo-restricted streaming services like Netflix, Hulu, and BBC iPlayer from anywhere, using Docker with a web-based admin panel to manage allowed devices.

Mindmap

mindmap
  root((netflix-proxy))
    What it does
      Unblocks geo-restricted streams
      DNS-based routing
      Device allowlist control
    How It Works
      Cloud server in target country
      dnsmasq for DNS
      sniproxy for traffic
      Docker containers
    Admin Panel
      Port 8080
      Add and remove IPs
      Auto-redirect on block
    Supported Services
      Netflix Hulu HBO
      BBC iPlayer
      Amazon Pandora Vudu
    Setup
      DigitalOcean or any VPS
      Docker required
      Bash install script
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Rent a $5/month cloud server in the US, install netflix-proxy, and watch US Netflix from abroad by changing your home router's DNS.

USE CASE 2

Use the web admin panel to add your phone and laptop IP addresses so multiple devices in your home can stream through the proxy.

USE CASE 3

Edit the configuration file to add a streaming service not in the default list so the proxy routes its traffic correctly.

USE CASE 4

Follow the DigitalOcean step-by-step setup commands to have the proxy running in under 30 minutes without prior Linux server experience.

What is it built with?

PythonDockerdnsmasqsniproxyBash

How does it compare?

ab77/netflix-proxycrypto101/bookmarblexu/pythonplantsvszombies
Stars3,7293,7293,728
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/51/52/5
Audienceops devopsgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a cloud server with a public IP in the target country and an open port 53 for DNS, keeping the built-in firewall rules active is important for security.

Licensed under the MIT License, use freely for any purpose, including personal or commercial, with no restrictions beyond keeping the copyright notice.

In plain English

This project is a self-hosted DNS proxy that lets you watch streaming services like Netflix, Hulu, HBO Now, and BBC iPlayer from countries where those services are not normally available. The idea is that you rent a cheap cloud server in a country where the streaming service works, install this software on it, and then point your home internet connection's DNS settings at that server. Your devices think they are browsing from that country, so the streaming service unlocks. The setup runs entirely inside Docker containers, which are self-contained software packages that bundle all the required pieces together. Two core tools do the work: dnsmasq handles DNS lookups (the process your device uses to find websites by name), and sniproxy handles the actual traffic routing for the video streams. The build script handles installing everything automatically once you have a compatible Linux server. The project includes a small web-based admin panel, accessible at port 8080 on your server, where you can add and remove the IP addresses of devices you want to allow through the proxy. This matters because the proxy is only useful to people whose IP addresses you have authorized. If your home internet connection has a changing IP address, the admin panel lets you update it whenever needed, and the system will redirect your browser to the admin page automatically when it detects an unauthorized IP. The README covers setup instructions for several cloud providers, including DigitalOcean, with step-by-step commands to copy and run. It also notes some important security considerations: the DNS server is configured with recursion turned on by default, which the project says is safe as long as the firewall rules put in place by the build script remain active. Disabling the firewall without understanding the implications could expose the server to misuse. The project is free under the MIT License and supports a fairly long list of streaming services beyond Netflix, including Amazon Instant Video, Pandora, Vudu, Crackle, and NBC Sports. Additional services can be added by editing a configuration file.

Copy-paste prompts

Prompt 1
I want to set up netflix-proxy on a DigitalOcean droplet to watch US Netflix from Europe. Walk me through creating the droplet, running the install script, and changing my router's DNS settings.
Prompt 2
The netflix-proxy admin panel is at port 8080. My home IP address changes daily with my ISP. Write a cron job or script that detects my current public IP and updates the allowed list automatically via the admin API.
Prompt 3
I want to add BBC iPlayer to my netflix-proxy configuration. Show me which config file to edit and what entries to add to route bbc.co.uk traffic through the proxy.
Prompt 4
Explain the security risk of leaving DNS recursion enabled on a netflix-proxy server and show me the firewall rules I need to keep active to prevent it from being misused as an open DNS resolver.

Frequently asked questions

What is netflix-proxy?

A self-hosted DNS proxy you run on a cheap cloud server to unblock geo-restricted streaming services like Netflix, Hulu, and BBC iPlayer from anywhere, using Docker with a web-based admin panel to manage allowed devices.

What language is netflix-proxy written in?

Mainly Python. The stack also includes Python, Docker, dnsmasq.

What license does netflix-proxy use?

Licensed under the MIT License, use freely for any purpose, including personal or commercial, with no restrictions beyond keeping the copyright notice.

How hard is netflix-proxy to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is netflix-proxy for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub ab77 on gitmyhub

Verify against the repo before relying on details.