Total Pageviews

Saturday, 21 November 2026

翻墙工具CFPilot

 Cloudflare Workers 代理微内核 · 真连接优选面板 · 一键部署(VLESS/Trojan/XHTTP + 优选订阅 + 本地真连接优选器 + 中文部署向导)

CFPilot

Cloudflare 代理微内核 · 真连接优选面板 · 盲中继与云监测台 · 异地组网(+mesh) AGPL-3.0 License · 控制面+数据面完全自研(无第三方内核依赖)

· 把「代理内核 + 优选订阅 + 本地真连接优选 + 盲中继 / 云监测台 + 异地组网(+mesh)」整合成一套方案;

· 采用双项目拆分部署:控制面(Web 管理面板)跑 Pages,数据面(流量转发)可选 Pages(默认) 或 Workers;

· 静态脱敏 + 内核独立热更新通道(kernel-latest),转发内核始终保持正式版升级形态;

· 解决优选 IP 困扰:本地真连接优选避免导入后延迟 -1;反代入口池内置双通自愈机制与动态保活清单,开箱即用。

目录

部署

⚠️ 部署前必读

全自动化:填 Token → 自动部署 → 自动优选换 IP → 自动更新内核 → 日常维护 。

  1. 全自动化使用需获取 Cloudflare Api Token 至少三个权限(数据面选 Workers 时是六个,见下文权限表)。
  2. 控制面 + 数据面必须分开(控制面固定 Pages;数据面可选 Pages 或 Workers)。 选 Workers 时必须配一个自有域名,*.workers.dev 直连不可访问。
  3. 不要与其它项目共用 KV 。
  4. 免 Api Token 部署请选择手动部署流程。
① 远程部署(npx,无需安装)





② CLI 安装部署(npm 全局安装)






③ 桌面版(Go 图形界面,推荐)
















CFPilot Go 版凭据页:自动检测账号并自动选中唯一的 CFPilot 实例









































































④ 手动部署(Cloudflare 控制台)




























































盲中继 / 云监测台与异地组网(+mesh)

CFPilot 在原有代理部署与优选能力之外,提供盲中继 / 云监测台部署能力,以及 +mesh 异地组网模块,用于把分散在不同网络(家宽 / 办公室 / 云主机 / 手机)的设备安全连入同一张虚拟局域网。

模块简介

  • 盲中继(Cloudflare Workers + Durable Objects):基于零知识房间转发端到端加密数据包(Noise IKpsk2 + ChaCha20-Poly1305),中继节点本身不持有私钥、无法解密业务流量,用于在双端对称 NAT 无法直连时自动降级兜底;
  • 云监测台(Cloudflare Workers + D1):免费托管的只读设备状态面板,展示各组网节点的在线状态、心跳时间与延迟概览;
  • 异地组网(+mesh):
    • 优先 UDP P2P 直连(STUN 探测 + 协同打洞),不通时自动平滑降级到 盲中继(WSS) 或自建 服务器中继,网络恢复后自动回切直连;
    • 支持 邀请链接一键入网:一端生成邀请链接,其余设备粘贴即可自动填入网络名、PSK、盲中继与监测台参数;
    • 桌面端界面提供实时网络拓扑与状态视图,支持「组网入口」WSS 优选;
    • Android +mesh 版为独立组网客户端(基于 VpnService),打开即可粘贴邀请链接一键入网。

快速开始

  1. 部署盲中继与云监测台(普通版 / +mesh 版均支持):
    • 打开 CFPilot 桌面版「部署 → 盲中继 / 云监测台」页签(或运行 cfpilot edge deploy);
    • 选择已托管在 Cloudflare 账号下的域名与子域、设置监测台密码,点击一键部署;
    • 部署完成后点击「填入组网配置」自动带入中继域名与监测台信息。
  2. 启动第一个组网节点(需安装 +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)及盲中继域名,点击启动。
  3. 加入其它设备:
    • 在已配置好的节点上复制「邀请链接」;
    • 在另一台电脑(+mesh 桌面版)或手机(cfpilot-<版本>+mesh-android.apk)粘贴邀请链接,修改本机虚拟 IP(如 10.99.0.2/24)后点击启动,即可互通并自动发现对端。

如需在自有 VPS 部署专用 UDP 服务器中继,可在「组网 → 高级选项」中一键生成部署命令并回填输出参数。


优选 IP

部署完成后,建议跑一次本地真连接优选,把「看起来快但实际不可用」的 IP 剔掉。

# 已安装 CLI
cfpilot scan

# 或直接用 npx
npx -y cfpilot@latest scan

交互式引导会:识别实例 → 自动填域名与 WS 路径 → 扫描 → 询问是否回填面板。

通用流程

  1. 关掉所有代理工具(含 TUN 模式与系统代理)
  2. 选择实例(或手动填数据面域名 + WS 路径)
  3. 设置采样数与是否跳过测速后开始优选(建议默认)
  4. 扫描完成后选 y 自动回填,或选 N 复制结果手动粘贴
  5. 回填后面板「节点来源 → 手动优选 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。


使用须知

API Token 权限

在 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 导致节点不可用。

📋 点开看「照着勾」的图解(哪些必勾 / 哪些不用勾 / 操作步骤)Cloudflare API Token 权限勾选指引

数据面出站能力边界

目标类型 能否打通
普通站点(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(Encrypted Client Hello)

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 订阅池的最低速度 / 最高延迟阈值

常用 KV 键

键 内容
CONFIG 用户配置 JSON(含 uuid / wsPath / trojanPassword)
CFP_DEPLOY_MANIFEST 部署清单,判断 KV 归属的唯一依据
LOCAL_PREFERRED_IPS 本地优选结果
SCANNER_TOKEN 扫描回填令牌

scanner 常用参数

参数 默认 说明
--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