explaingit

bia-pain-bache/bpb-worker-panel

10,358TypeScriptAudience · generalComplexity · 3/5Setup · moderate

TLDR

A self-hosted proxy control panel that runs on Cloudflare's free serverless platform, letting people in internet-censored regions set up a private VPN-like bypass and generate subscription links for popular VPN apps.

Mindmap

mindmap
  root((BPB Panel))
    What it does
      Self-hosted proxy
      Censorship bypass
      Private DNS-over-HTTPS
    Protocols
      VLESS
      Trojan
      WireGuard via Warp
    Setup
      Cloudflare Workers
      Cloudflare Pages
      Free tier
    Features
      Web panel UI
      Subscription link generator
      Routing rules
      Chain proxies
    Client apps
      v2rayNG
      Clash
      Sing-box
      AmneziaVPN
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

Things people build with this

USE CASE 1

Set up a personal proxy server on Cloudflare's free tier to bypass internet censorship without renting a dedicated server.

USE CASE 2

Generate subscription links for VPN apps like v2rayNG, Clash, or Sing-box that users can paste in and connect instantly.

USE CASE 3

Enable DNS-over-HTTPS to prevent your internet provider from monitoring or intercepting your DNS queries.

USE CASE 4

Share proxy access with two to three other users within the free Cloudflare Workers request limits.

Tech stack

TypeScriptCloudflare WorkersCloudflare PagesVLESSTrojanWireGuard

Getting it running

Difficulty · moderate Time to first run · 30min

Requires a free Cloudflare account and basic familiarity with deploying Cloudflare Workers or Pages.

In plain English

BPB Panel is a self-hosted control panel that lets you set up your own private internet proxy service, primarily aimed at people in regions where internet access is restricted or censored. It runs on Cloudflare Workers or Cloudflare Pages, which are serverless computing platforms, meaning there is no traditional server to maintain. The free tier of Cloudflare is enough to get it running. The panel supports several proxy protocols: VLESS, Trojan, and WireGuard via Cloudflare's Warp service. Without getting into technical depth, these are different methods for tunneling internet traffic through an intermediate server in a way that is harder for network censors to detect and block. The panel also includes a private DNS-over-HTTPS server, which prevents DNS queries from being monitored or intercepted by your internet provider. Setup is managed through a web-based graphical interface rather than raw configuration files. From the panel you can configure which ports and protocols to use, set clean IP addresses, define routing rules to bypass or block certain categories of traffic (such as ads, malware, or country-specific restrictions), and add chain proxies to help mask the origin IP. The panel is password protected so only authorized users can access its settings. Subscription links are generated automatically in formats that work with popular VPN client apps including v2rayNG, Sing-box, Clash, and AmneziaVPN, among others. This means users can paste the subscription link into a supported app on their phone or computer and the app handles the rest. There are some limitations: each worker instance handles up to 100,000 requests per day, which fits roughly two to three users for the VLESS and Trojan protocols. UDP traffic is not supported under those protocols, which affects things like video calls on Telegram. Warp-based configs do not have this request cap. The README is written with both English and Farsi versions available.

Copy-paste prompts

Prompt 1
I'm deploying BPB Panel on Cloudflare Workers for the first time. Walk me through every step from creating a Cloudflare account and deploying the Worker to logging into the web panel and generating my first VLESS subscription link.
Prompt 2
How do I configure the routing rules in BPB Panel to block ads and malware traffic while allowing everything else to pass through the VLESS proxy?
Prompt 3
I want to add a chain proxy to my BPB Panel to help hide the Cloudflare origin IP. What setting in the panel controls this, and what format should the upstream proxy address be in?
Open on GitHub → Explain another repo

← bia-pain-bache on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.