Setup guide

MediaFlow Proxy setup

MediaFlow Proxy lets you route debrid stream URLs through your own proxy. Use it when a debrid CDN link is locked to a specific IP, or when your ISP or region blocks the stream. This guide covers running MediaFlow Proxy and pointing the TPB 4K Porn addon at it.

What it does

Some debrid providers return CDN links that only play from the IP that requested them. MediaFlow Proxy sits between Stremio and those links: Stremio asks your proxy for the stream, the proxy fetches it from the debrid CDN, and passes the bytes back. The CDN sees your proxy's IP, not Stremio's, so the link plays wherever your proxy runs.

It also helps when your home ISP or country blocks debrid traffic: run the proxy on a network that is not blocked, and Stremio reaches it from home.

1. Run MediaFlow Proxy

The official project is at github.com/mhdzumair/MediaFlowProxy. The quickest path is Docker:

docker run -d --name mediaflow-proxy \
  -p 8888:8888 \
  -e API_PASSWORD=your-secret-password \
  ghcr.io/mhdzumair/mediaflow-proxy:latest

Pick a strong API_PASSWORD. You will paste it into the addon in the next step. Note the proxy URL, for example http://your-server:8888.

Bare-metal and pip install options are in the project README. If you run it at home, make sure your Stremio device can reach that port.

2. Point the addon at your proxy

Open the TPB 4K Porn configure page. In the MediaFlow Proxy card:

  • Turn on Proxy stream URLs through MediaFlow.
  • Set Proxy URL to your proxy, for example http://your-server:8888.
  • Set API Password to the value you chose above.

Save the config and (re)install. Debrid stream URLs will now be wrapped through your proxy. AllDebrid is exempt: it resolves through its own local redirector (see the AllDebrid redirector guide).

3. Verify

Play any debrid stream in Stremio. If the proxy is working, the request log on your MediaFlow Proxy instance will show the debrid CDN fetch, and the stream will play even if the raw CDN link would have been IP-locked. If playback fails, check that Stremio can reach the proxy URL and that the API password matches.

More questions

Do I need MediaFlow Proxy to use TPB 4K Porn?
No. Most debrid providers (Real-Debrid, TorBox, Premiumize, and others) hand you CDN links that play directly. MediaFlow Proxy is only for cases where the CDN link is locked to a specific IP, or where your ISP or region blocks the debrid stream.
Where should I run MediaFlow Proxy?
On any machine that can reach both your debrid provider and your Stremio player. A small VPS or a home server works. If your ISP blocks debrid traffic, run it somewhere that is not subject to that block, then point the addon at that address.
Does MediaFlow Proxy work with AllDebrid?
No. AllDebrid resolves client-side through its own local redirector (see the AllDebrid redirector guide). MediaFlow Proxy wraps server-resolved CDN links for the other providers. The two are independent and can both be configured at the same time.
Is the API password sent to the addon server?
The password is stored in your install URL config and used to build the proxied stream URL. It is only sent to your own MediaFlow Proxy instance, not to the addon server. Keep your install URL private, as you would any debrid token.