1. 项目定位与用途
BPB Worker Panel 是一个专注于提供免费、私密代理服务的 Web 应用面板，部署于 Cloudflare Workers 环境。它通过直观的 GUI 帮助用户快速生成和管理 VLESS、Trojan、Warp 配置以及私有 DoH 服务，适用于网络审查严重地区，确保用户能够稳定访问互联网的同时保护隐私。主要用户群体包括需要绕过封锁的普通用户、多设备用户以及追求高自定义度的技术爱好者。
项目档案应用项目
BPB Worker Panel 免费代理配置生成器 | Cloudflare Workers 部署与使用指南
bia-pain-bache/BPB-Worker-Panel：BPB Worker Panel 是一个基于 Cloudflare Workers 的免费代理配置生成面板，提供 VLESS、Trojan、Wa本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
BPB Worker Panel 是一个基于 Cloudflare Workers 的免费代理配置生成面板，提供 VLESS、Trojan、Warp 及私有 DoH 服务，支持多客户端订阅与高级网络优化功能。
中文项目介绍
BPB Worker Panel 是一个图形化管理面板，旨在为用户提供免费、安全且私密的代理配置生成服务。它支持 VLESS、Trojan 和 Warp 等协议，并集成私有 DoH 服务器，确保在域名或 Warp 服务被 ISP 封锁时仍能保持连接。
针对网络审查严格地区的用户，该项目解决了获取稳定代理服务的难题。通过提供可自定义的配置选项、链式代理修复 IP、Fragment 分片优化以及 comprehensive 路由规则（如绕过伊朗/中国/俄罗斯、屏蔽 QUIC/广告/恶意软件），有效应对网络封锁和流量干扰。
适用于需要绕过国家网络审查、保护 DNS 查询隐私、为多平台代理客户端生成兼容配置的用户。技术上，它部署于 Cloudflare Workers 或 Pages，采用 TypeScript 模块化架构，支持 Xray、Sing-box、Clash/Mihomo 等核心，提供密码保护面板和丰富的环境变量配置（如 UUID、TR_PASS、DOH_URL 等）。
详细信息与使用说明
2. 核心功能与特性
项目提供免费且私有的代理服务，支持 VLESS、Trojan 和 Warp 协议，并集成可自定义底层 DNS 的私有 DoH 服务器。关键特性包括：Fragment 分片支持以应对 restrictive 网络；Warp Pro 优化配置； comprehensive 路由规则（绕过特定国家、屏蔽 QUIC/广告/恶意软件/钓鱼网站）；链式代理（支持 VLESS、Trojan、Shadowsocks、socks、http）修复 IP 问题；为 Xray、Sing-box、Clash/Mihomo 等客户端生成订阅链接；密码保护的面板安全访问；以及高度可自定义的选项（如 clean IP 域名、代理 IP、DNS 服务器、端口、Warp 端点等）。
3. 技术架构与实现
项目基于 Cloudflare Workers 无服务器架构，使用 TypeScript 开发，采用模块化设计。源码结构清晰：src/cores 目录下分别实现 Xray、Sing-box、Clash 三大客户端核心的配置生成逻辑；src/protocols 实现 VLESS 和 Trojan 的 WebSocket 传输层以及 Warp 协议；src/common 包含共享工具、请求处理器和初始化逻辑。构建流程使用 esbuild、terser 和 html-minifier 进行打包、压缩和混淆，依赖 jose 处理 JWT、jszip 处理压缩包。tsconfig.json 通过路径别名明确划分模块依赖，提升可维护性。
4. 安装与部署
项目支持两种部署方式：Cloudflare Workers 和 Cloudflare Pages。安装需先配置环境变量（如 UUID、TR_PASS、PROXY_IP、PREFIX、SUB_PATH、FALLBACK、DOH_URL 等），然后通过 npm run build 构建项目。然而，仓库中未明确给出具体的部署命令或步骤，详细安装流程需参考官方在线文档中的安装向导章节。
5. 使用方式
部署成功后，用户可通过密码访问面板界面。在面板中可生成或查看 VLESS、Trojan、Warp 配置，获取订阅链接或 raw 配置内容。生成的订阅可在支持的客户端（如 v2rayNG、MahsaNG、v2rayN、Sing-box、Clash Meta 等）中导入使用。用户还可通过面板或环境变量自定义 DNS 服务器、路由规则、Fragment 设置、Warp 端点等高级选项，以满足特定网络环境需求。
6. 限制与注意事项
项目存在已知限制：在 Workers 部署下，VLESS 和 Trojan 协议无法正确处理 UDP 传输，因此默认禁用，影响依赖 UDP 的功能（如 Telegram 视频通话），同时 UDP DNS 也不支持；DoH 服务默认启用以增强安全。每个 Worker 每天最多处理 10 万次请求，适合 2-3 名用户使用；Warp 配置无请求限制。用户需根据自身需求权衡这些限制。
思维导图
BPB Worker Panel
核心模块
Xray 配置生成
Sing-box 配置生成
Clash 配置生成
协议实现
VLESS over WebSocket
Trojan over WebSocket
Warp 协议
公共工具
请求处理器
初始化与配置
通用辅助函数
构建与资源
构建脚本
静态资源
多语言文档
常见问题
如何部署 BPB Worker Panel？
项目支持 Cloudflare Workers 和 Pages 两种部署方式。需先配置环境变量（如 UUID、TR_PASS 等），然后运行 npm run build 构建。但仓库中未明确给出具体部署命令，详细步骤请参考官方在线安装向导文档。
支持哪些代理客户端？
支持 v2rayNG、MahsaNG、v2rayN、v2rayN-PRO、Sing-box、Streisand、Clash Meta、Clash Verge Rev、FLClash、AmneziaVPN、WGTunnel 等。不同客户端对 Fragment 和 Warp Pro 的支持情况见 README 中的表格。
UDP 传输是否可用？有哪些限制？
在 Workers 部署下，VLESS 和 Trojan 的 UDP 传输默认禁用，因此不支持依赖 UDP 的功能（如 Telegram 视频通话），同时 UDP DNS 也不支持。DoH 服务默认启用以增强安全。每个 Worker 每天最多处理 10 万次请求，适合 2-3 名用户；Warp 配置无请求限制。
如何自定义代理配置？
可通过环境变量（如 UUID、TR_PASS、PROXY_IP、DOH_URL、FALLBACK 等）或面板界面调整 DNS 服务器、路由规则、Fragment 设置、Warp 端点、链式代理等参数，以满足特定网络环境需求。
项目的主要技术架构是什么？
项目基于 Cloudflare Workers 无服务器架构，使用 TypeScript 开发。源码模块化划分：cores 目录生成 Xray、Sing-box、Clash 配置；protocols 实现 VLESS、Trojan、Warp 协议；common 包含共享工具与请求处理。构建使用 esbuild、terser、html-minifier，并通过 tsconfig 路径别名管理依赖。