Cloudflare Workers 代理微内核 · 真连接优选面板 · 一键部署(VLESS/Trojan/XHTTP + 优选订阅 + 本地真连接优选器 + 中文部署向导)
CFPilot
Cloudflare 代理微内核 · 真连接优选面板 · 盲中继与云监测台 · 异地组网(+mesh) AGPL-3.0 License · 控制面+数据面完全自研(无第三方内核依赖)
· 把「代理内核 + 优选订阅 + 本地真连接优选 + 盲中继 / 云监测台 + 异地组网(+mesh)」整合成一套方案;
· 采用双项目拆分部署:控制面(Web 管理面板)跑 Pages,数据面(流量转发)可选 Pages(默认) 或 Workers;
· 静态脱敏 + 内核独立热更新通道(kernel-latest),转发内核始终保持正式版升级形态;
· 解决优选 IP 困扰:本地真连接优选避免导入后延迟 -1;反代入口池内置双通自愈机制与动态保活清单,开箱即用。
⚠️ 部署前必读
全自动化:填 Token → 自动部署 → 自动优选换 IP → 自动更新内核 → 日常维护 。
- 全自动化使用需获取 Cloudflare Api Token 至少三个权限(数据面选 Workers 时是六个,见下文权限表)。
- 控制面 + 数据面必须分开(控制面固定 Pages;数据面可选 Pages 或 Workers)。 选 Workers 时必须配一个自有域名,
*.workers.dev直连不可访问。- 不要与其它项目共用 KV 。
- 免 Api Token 部署请选择手动部署流程。
① 远程部署(npx,无需安装)
② CLI 安装部署(npm 全局安装)
CFPilot 在原有代理部署与优选能力之外,提供盲中继 / 云监测台部署能力,以及 +mesh 异地组网模块,用于把分散在不同网络(家宽 / 办公室 / 云主机 / 手机)的设备安全连入同一张虚拟局域网。
- 盲中继(Cloudflare Workers + Durable Objects):基于零知识房间转发端到端加密数据包(Noise IKpsk2 + ChaCha20-Poly1305),中继节点本身不持有私钥、无法解密业务流量,用于在双端对称 NAT 无法直连时自动降级兜底;
- 云监测台(Cloudflare Workers + D1):免费托管的只读设备状态面板,展示各组网节点的在线状态、心跳时间与延迟概览;
- 异地组网(+mesh):
- 优先 UDP P2P 直连(STUN 探测 + 协同打洞),不通时自动平滑降级到 盲中继(WSS) 或自建 服务器中继,网络恢复后自动回切直连;
- 支持 邀请链接一键入网:一端生成邀请链接,其余设备粘贴即可自动填入网络名、PSK、盲中继与监测台参数;
- 桌面端界面提供实时网络拓扑与状态视图,支持「组网入口」WSS 优选;
- Android
+mesh版为独立组网客户端(基于VpnService),打开即可粘贴邀请链接一键入网。
- 部署盲中继与云监测台(普通版 / +mesh 版均支持):
- 打开 CFPilot 桌面版「部署 → 盲中继 / 云监测台」页签(或运行
cfpilot edge deploy); - 选择已托管在 Cloudflare 账号下的域名与子域、设置监测台密码,点击一键部署;
- 部署完成后点击「填入组网配置」自动带入中继域名与监测台信息。
- 打开 CFPilot 桌面版「部署 → 盲中继 / 云监测台」页签(或运行
- 启动第一个组网节点(需安装
+mesh版):- Windows 运行
cfpilot-<版本>+mesh-windows-amd64-setup.exe安装(安装器会自动注册提权组网服务并下载校验wintun.dll); - Linux 安装对应架构的
.deb包(sudo dpkg -i cfpilot-<版本>+mesh-linux-<arch>.deb); - 在「组网」页填写网络名称、预共享密钥(PSK)、虚拟 IP(同网络所有设备使用同一网段不同地址,如
10.99.0.1/24)及盲中继域名,点击启动。
- Windows 运行
- 加入其它设备:
- 在已配置好的节点上复制「邀请链接」;
- 在另一台电脑(
+mesh桌面版)或手机(cfpilot-<版本>+mesh-android.apk)粘贴邀请链接,修改本机虚拟 IP(如10.99.0.2/24)后点击启动,即可互通并自动发现对端。
如需在自有 VPS 部署专用 UDP 服务器中继,可在「组网 → 高级选项」中一键生成部署命令并回填输出参数。
部署完成后,建议跑一次本地真连接优选,把「看起来快但实际不可用」的 IP 剔掉。
# 已安装 CLI
cfpilot scan
# 或直接用 npx
npx -y cfpilot@latest scan交互式引导会:识别实例 → 自动填域名与 WS 路径 → 扫描 → 询问是否回填面板。
通用流程
- 关掉所有代理工具(含 TUN 模式与系统代理)
- 选择实例(或手动填数据面域名 + WS 路径)
- 设置采样数与是否跳过测速后开始优选(建议默认)
- 扫描完成后选
y自动回填,或选N复制结果手动粘贴 - 回填后面板「节点来源 → 手动优选 IP」即可看到列表
- 桌面版根据图形界面提示说明操作,易用性更强。
面板首页给出三种订阅地址,按 User-Agent 自动识别格式:
| 客户端 | 拿到的格式 |
|---|---|
| Clash Verge / Clash / mihomo | YAML |
| sing-box | JSON |
| v2rayN / Shadowrocket / NekoBox | Base64 分享链接 |
也可显式指定:?target=clash / ?target=singbox / ?target=base64。
节点的关键约定:server = 优选出的 IP,sni / Host = 你的域名(固定),端口 = 443。
在 Cloudflare 控制台 → API Tokens 创建自定义 Token,按下面三项勾选(分类都是 Account,权限级别都是 **Read/**Edit):
| 权限项(控制台显示名) | 级别 | 分类 | 用途 |
|---|---|---|---|
| Account Settings | Read | 读取账号列表(GET /accounts) |
|
| Workers KV Storage | Edit | Developer Platform | 建 KV、读写部署清单与 CONFIG |
| Pages | Edit | Developer Platform | 建/删 Pages 项目、上传内核、绑 KV、配环境变量、绑自定义域名 |
| Account API Tokens | Read | Account & Billing | 可选,仅用于显示 Token 有效期 |
| Account Analytics | Read | Analytics & Logs | 可选,仅用于「用量/额度」面板(查 Workers 与 KV 的已用量) |
数据面用 Workers 模式时,再加一项:
| 权限项(控制台显示名) | 级别 | 分类 | 用途 |
|---|---|---|---|
| Workers | Admin | Developer Platform | 上传 / 更新数据面 Worker 脚本 |
✅ 不需要
Workers Routes,也不需要DNS—— 工具不碰自定义域名: Workers 模式只把数据面部署到*.workers.dev,自定义域名请你在控制台自行绑定, 然后到面板「设置 → 数据面域名」填一次(CONFIG.subDomain优先级高于DATA_HOST)。⚠️ Workers 模式 + 自定义域名时,
workers.dev的生产链接与预览链接会被工具关掉, 节点只走自定义域名(*.workers.dev在多数网络下直连不可访问)。 部署时若填的域名与数据面已绑定的域名不一致、或是控制面 / 账号里别的 Worker 的域名, 工具会直接拒绝部署并说明原因 —— 避免把错域名写进DATA_HOST导致节点不可用。
| 目标类型 | 能否打通 |
|---|---|
| 普通站点(baidu / qq / amazon 等) | ✅ 直连 |
| Cloudflare 网段目标 | ✅ 内置第三方反代入口(面板可自配) |
| Google / YouTube / GitHub 等 443 | ✅ 内置假活检测会自动切反代;若不通建议配 SOCKS5/HTTP 代理落地 |
节点形态在面板「入站配置」里选,默认下发 VLESS + WebSocket 与 VLESS + XHTTP 两种形态。
| 形态 | 支持 |
|---|---|
| VLESS + WS | 全部客户端 |
| Trojan + WS | 全部客户端 |
| VLESS + XHTTP(packet-up) | Xray 内核、新版 mihomo(1.19+);实测稳定 |
mihomo / Clash.Meta 自 1.19+ 已支持 XHTTP 节点;老版本会忽略该节点,不影响 WS 节点。 sing-box 暂不支持,订阅里不下发。
ECH 把 TLS ClientHello 里的真实 SNI 加密,隐藏你访问的是哪个域名。 这是客户端侧的能力 —— 内核只负责把参数写进订阅,由支持 ECH 的客户端 (mihomo / Clash Verge、sing-box 1.13+、v2rayN)实际执行;客户端不支持时参数被忽略,不影响连接。
默认关闭,在面板「出站与抗封锁」页勾选「启用 ECH 加密」后保存即可。
没有自定义域名时客户端连的是 *.pages.dev,ECH 的实际收益有限。
Q:优选结果全是 -1?
按顺序查:① 是否绑了自定义域名;② 客户端 sni 与 Host 是否都指向你的域名;
③ 优选时 --host 是否和实际部署一致;④ 端口是否是 443 等 TLS 端口;
⑤ 跑优选时是否关了代理工具。
Q:配了 SOCKS5 代理但不生效?
检查这几项:① 代理地址是否可公网访问(127.0.0.1 / 192.168.x 这类地址数据面连不到);
② 代理是否支持 TLS 1.3(HTTPS 代理需要);③ 代理服务器是否有 IPv4 公网地址
(数据面的出站只支持 IPv4)。
Q:Linux 版双击没反应 / 没有托盘图标?
浏览器下载的文件默认没有执行位,先 chmod +x,再从终端启动(双击常被文件管理器当成文本打开)。
没有图标说明当前桌面缺 StatusNotifierItem 宿主(GNOME 默认如此),改用 --no-tray 前台运行即可,
服务与界面一致,只是少了托盘菜单;纯命令行 / SSH 环境也用它。
Q:面板打不开 / 404?
面板路径是部署时随机生成的,向导终端里打印过。忘了可以用
npx wrangler kv key get --binding KV PANEL_PATH 查回。
Q:XHTTP 节点连不上?
需要 Xray 内核或新版 mihomo(1.19+,network: xhttp);sing-box 请改用 WS 节点。
老版本 mihomo 会直接忽略 XHTTP 节点(不是报错),不影响其它节点。
默认下发的 XHTTP 节点使用 packet-up 模式并关闭 gRPC 伪装头;若个别网络环境下仍受限,可切回 WS 节点使用。
Q:免费额度 CPU 超限?
内核内置 Free CPU 预算保护,可在面板调低 DLS / MAX_LATENCY 阈值,或减少远程 CSV 行数。
Q:想看「为什么这个目标连不上」? 自研数据面提供完整诊断端点,需要带上完整 UUID(面板「节点配置」里可见):
curl \
-H "x-cfpilot-token: <完整 UUID>" \
https://<数据面域名>/__diag返回最近 20 条完整出站诊断(失败类型 / 原始错误 / 候选 / 修复建议)—— WebSocket close frame 装不下这些(且超长会被边缘静默丢弃),所以单独开了个口子。
⚠️ 只认完整 UUID:早期允许 UUID 前 8 位,但那是 32 bit 搜空间, 可被在线枚举(诊断里有你访问过的目标域名)。失败尝试也有限速(每 isolate 每分钟 10 次)。
Q:/__edge_probe 会不会被别人刷流量?
该端点必须保持免鉴权(它是优选的核心:WS 101 校验 + 流式测速),所以内置两道闸:
单次最多 8 MiB,以及每个 isolate 每 10 分钟约 6 GiB 的总预算,超出返回 429。
正常一轮优选(约 50 条候选 × 8 连接 × 5 MiB)大约 2 GiB,跑不满。
如果你担心被滥用,可在 Cloudflare 控制台给该路径加一条 Rate Limiting 规则。
CFPilot/
├── CFPilot-control.zip # 控制面 Pages 包
├── CFPilot-dataplane.zip # 数据面 Pages 包
├── data/relay-ips.txt # 动态保活反代入口清单
└── packages/
├── worker-core/ # 边缘内核 + 中文面板
├── cli/ # cfpilot —— 部署 + 优选 CLI
├── cli-mesh/ # cfpilot-mesh —— 含组网能力的 CLI
├── ui/ # 界面源码(单一来源,桌面版与安卓版共用)
├── desktop/ # Go 桌面版 / 容器版 / +mesh 组网服务
├── android/ # Android 完整管理面板 App
├── android-mesh/ # Android 独立 +mesh 组网客户端
└── edge-relay/ # 盲中继 + 云监测台 Worker 源码
界面源码独立在
packages/ui,构建时内嵌进桌面版与 Android 管理版,保证多端界面一致。
优先级:KV(CONFIG) > 环境变量 > 内置默认值。
| 变量 | 说明 |
|---|---|
UUID |
VLESS UUID |
WS_PATH |
WebSocket 路径(值要带前导斜杠;PATH 是 Pages 保留名,别用) |
TROJAN_PASSWORD |
Trojan 密码 |
ENABLE_TROJAN / ENABLE_XHTTP |
入站开关 |
DATA_HOST |
数据面域名(拆分部署时控制面用它生成订阅) |
PANEL_PATH / PANEL_PASSWORD |
面板路径与初始密码(不是 ADMIN_PASSWORD) |
PROXYIP |
ProxyIP 池(按直连落地语义解析) |
SOCKS5 / HTTP_PROXY |
落地代理(仅自研数据面)。https:// 前缀表示代理本身走 TLS,可用 #sni=域名 指定握手名 |
NAT64 |
NAT64 前缀,如 64:ff9b:: |
RELAY_POOL / USE_BUILTIN_RELAY |
自定义反代入口池 / 内置表开关 |
RESOLVE_PREFERRED |
出站前自动 DoH 解析优选 IP(默认开) |
SUB_VARIANTS |
下发的节点形态,逗号分隔,默认 vless-ws,vless-xhttp |
OFFICIAL_IP_COUNT / PREFERRED_DOMAIN_COUNT |
内置来源数量(默认 20 / 10) |
DLS / MAX_LATENCY |
订阅池的最低速度 / 最高延迟阈值 |
| 键 | 内容 |
|---|---|
CONFIG |
用户配置 JSON(含 uuid / wsPath / trojanPassword) |
CFP_DEPLOY_MANIFEST |
部署清单,判断 KV 归属的唯一依据 |
LOCAL_PREFERRED_IPS |
本地优选结果 |
SCANNER_TOKEN |
扫描回填令牌 |
| 参数 | 默认 | 说明 |
|---|---|---|
--host |
必填 | 你的域名(作为 SNI / Host) |
--path |
/vless |
目标项目的 WS 路径 |
--sample |
6556 |
候选采样数 |
--top |
15 |
返回条数 |
--countries |
— | 机房国家筛选,如 HK,JP,SG;也接受分组 ASIA / US 与机房码 HKG(自动归一到国家) |
--token |
— | 回填令牌(不填则只输出不回填) |
--no-verify |
— | 只做 101 握手,跳过响应体校验(对接非 CFPilot 项目时用) |
--speed-mode |
auto |
probe(走目标探针端点,最忠实)/ url(公开测速地址,任何项目可用)/ auto |
--cidr / --ip-file |
— | 自定义网段 / 本地 IP 列表 |
cfpilot test --ip <IP> |
— | 测单个 IP:按 TCP → TLS → WS 101 逐阶段给结论(前一阶段失败即停);可加 --speed(测下行)、--uuid / --trojan-password(真实隧道校验)、--json(脚本处理)、--path(非默认探针路径) |
完整参数见 npx -y cfpilot@latest scan --help 与 npx -y cfpilot@latest test --help。
面板「出站与高级 → 配置备份与迁移」可以导出/导入配置。
导出是脱敏的:不含 UUID、Trojan 口令、入站路径、自定义域名,以及带口令的落地代理; 导出时会明确列出哪些字段没带、为什么。导入前会显示逐项差异,确认后才写入。
换账号、迁移项目、备份都靠它。
| 客户端 / 内核 | VLESS-WS | Trojan-WS | VLESS-XHTTP | ECH |
|---|---|---|---|---|
| Xray-core | 支持 | 支持 | 支持(需较新版本) | 支持(需较新版本) |
| sing-box | 支持 | 支持 | 不支持 | 支持(1.12+) |
| mihomo / Clash.Meta | 支持 | 支持 | 支持(1.19+) | 支持(ech-opts) |
| v2rayN / v2rayNG / Shadowrocket | 支持 | 支持 | 跟随内核 | 跟随内核 |
mihomo 自 1.19+ 原生支持 XHTTP(network: xhttp + xhttp-opts),实测可稳定连接。
sing-box 暂无该传输类型,订阅生成时不向其下发 XHTTP 节点;老版本 mihomo 会忽略该节点,
不影响其它节点。详见 客户端兼容性矩阵。
本项目仅作学习交流使用,用于查找资料、学习网络知识,不鼓励、不支持任何违法行为。
-
项目中涉及的所有方法与技术均来自互联网公开资料,仅供交流学习;
-
使用者需自行遵守所在地法律法规与 Cloudflare 服务条款(尤其是 Free 套餐的流量与 CPU 限制),并对自身使用行为负全部责任;
-
任何人因使用本项目产生的任何后果(包括但不限于账号封禁、服务中断、法律责任),本项目及作者概不负责。
from https://github.com/xmwengxing/CFPilot
---------------------------------------------------------------------------------------------
本教程自动搭建,免去手动部署的烦恼,去除复制代码或上传配置文件,去除配置相关密钥,去除手动创建workesKV空间,无需域名.


No comments:
Post a Comment