CFNext 部署教程：六种代码形态、MASQUE 与家宽模式的订阅管理面板

项目地址：PAICNI/CFNext · 当前版本 3.1.1 · 热度约 2874 Star / 1408 Fork（2026-11 仓库页数据）· Telegram 交流群：t.me/SZ_PAI · 发布频道：t.me/PaiCNX · 作者 YouTube 频道：数字派 @PAI_CN

CFNext 是部署在 Cloudflare Workers / Pages 上的代理订阅管理面板：一个文件同时实现 VLESS / Trojan / XHTTP 多协议代理与图形化配置，进面板、拿订阅、优选节点、换落地都在一个地方。它的特点是模式多——除了常规 Worker 模式，还有 WARP、MASQUE 和家宽模式，再加一套前后端分离部署形态。本文按官方 README 最新口径（3.1.1）写全：六种代码形态怎么选、两种部署方法、全部变量、订阅地址规则和排障。提醒：本项目仅供学习与网络技术研究，请遵守当地法律法规与平台条款；官方明确提示明文版代码仅供阅读与二次开发，不建议直接线上部署。

主要功能

功能	说明
图形化面板	自定义路径进入，玻璃拟态界面，深/浅双主题
四种运行模式	Worker / WARP / MASQUE / 家宽四种模式面板内一键切换
节点优选	内置优选源，按地区 / 运营商 / IP 版本多维筛选
节点数量控制	`nodeLimitCount` 默认 300，可调
轮询下发	`preferredIPs` 多 IP 轮换下发，均衡负载
ECH 加密	SNI 隐蔽，抗 SNI 阻断
落地与出站代理	`PROXYIP` / 出站代理 / 反代落地，多源按节点落地国家自动匹配（2.8.0 起）
前置节点	`warpFront` 链式拨号
MASQUE 凭据	自动注册、自动续用，不用手动填
多后端管理	前后端分离版专属：多后端聚合 / 选择下发
反滥用加固	指纹消隐、限流、反扫描兜底页、字节差异化
Telegram 用量通知	每日用量推送（可选）
备份与恢复	配置一键导入 / 导出

协议与兼容性：VLESS / Trojan / XHTTP / MASQUE / OpenVPN（家宽）；订阅输出 Clash（mihomo / Verge）、sing-box、Karing、v2rayN 等格式；存储用 Cloudflare KV，绑定变量名统一为 K。客户端方面，Worker 模式三协议理论支持所有客户端，MASQUE 模式需 Clash Meta 系内核客户端（Clash Verge / Mihomo Party / Stash 等）。

准备工作

一个 Cloudflare 账号（免费计划即可）
一个域名（可选）：绑自定义域后地址更好记、也更稳定；没有域名可先用 workers.dev / pages.dev 默认地址
客户端：常规模式任意主流客户端；MASQUE / 家宽模式需要 Mihomo 内核客户端（Clash Verge、Mihomo Party、FlClash 等）

第一步：选代码形态（六种，别下错）

形态	文件名	部署目标	说明
单文件·明文版	`CFNext-明文版.js`	Worker	源码可读，仅供阅读/二开，不建议直接部署
单文件·小说混淆版	`CFNext-小说混淆版.js`	Worker	面板+后端一体，正文嵌入语料，体积最大，单文件部署用这个
单文件·Pages 版	`CFNext-小说混淆Pages版.zip`	Pages（高级模式）	混淆版打包为 `_worker.js` 走 Pages 通道
分离版·后端	`CFNext-后端Worker版.js`	Worker	纯节点/订阅/API，无面板、无登录
分离版·前端	`CFNext-前端Pages版.zip`	Pages（高级模式）	面板 UI + 登录 + 多后端管理 + 聚合下发

怎么选：一个人自用选单文件版（小说混淆版或 Pages 版），一次部署即用；有多个后端、想跨账户聚合管理才选前后端分离版——前端 Pages 管面板/登录/多后端，后端 Worker 只存参数、生成订阅，后端不暴露独立入口，只能经前端访问。注意：自 3.1.0 起官方只维护明文版、小说混淆版和小说混淆 Pages 版，原混淆版与混淆 Pages 版已停更，别下错文件。

部署方法一：Worker 部署（单文件版）

登录 Cloudflare 控制台 → Workers 和 Pages → 创建 → 创建 Worker
把对应 .js 文件的全部内容粘贴进在线编辑器（或用 Wrangler / API 部署）
绑定 KV：新建 KV 命名空间并绑定，变量名填 K
设置环境变量（见下表，只填必填项：L 必填）
部署后访问 https://<名称>.<子域>.workers.dev/<入口> 进入面板；首次访问会进 SETUP 页强制设置管理密码

部署方法二：Pages 部署（单文件 Pages 版）

创建 Pages 项目（高级模式 / 直接上传）
上传 Pages 版 zip（内含 _worker.js）
绑定 KV，变量名 K（生产 + 预览环境都绑）
设置环境变量（只填必填项）
顺序别错：先建项目 → 设环境变量 → 绑定 KV → 最后部署。绑定和变量只对之后新建的部署生效，顺序反了就要重新部署一次

分离版部署要点

后端 Worker 部署 CFNext-后端Worker版.js，绑 KV（K），并设置专用变量 API（前后端共享密钥，后端必填），前端请求时注入 X-CF-Api 头校验
前端 Pages 部署 CFNext-前端Pages版.zip，在前端里添加/管理多个后端，聚合或选择下发
后端没有面板、没有登录入口，单独访问后端地址是看不到配置界面的，这是设计如此

登录与订阅地址

入口路径由环境变量 L（等价写法 login）决定，例如 L=admin，面板就在 /admin
首次访问面板进 SETUP 页设置管理密码（保存在 KV，之后可在面板内改）；也可用环境变量 ADMIN 强制覆盖密码（设了之后面板内不可改）
订阅地址：/<入口>/sub/clash（Clash）、/<入口>/sub/singbox（sing-box）、/<入口>/sub/karing（Karing），/<入口>/sub?c=<格式> 是面板预览用；订阅地址无需登录（客户端不带 cookie），所以入口路径和订阅地址要妥善保管

环境变量表

基础（单文件版 / 分离版通用，未列出的均非必填）：

变量	值	说明
`L`	如 `admin`	面板入口路径（等价 `login`）。必填
`K`	—	KV 命名空间绑定，绑定变量名就是 `K`。必填
`ADMIN`	密码	强制覆盖管理密码（留空则首次在面板设置）
`U`	UUID	自定义 UUID，仅作兜底（KV 中的 uuid 优先）

分离版专用：

变量	说明
`API`	后端共享密钥，前端注入校验用。后端必填

MASQUE 相关：

变量	说明
`MASQUE_ENDPOINTS`	覆盖 MASQUE 端点，`IP:端口` 列表
`MASQUE_SNI`	MASQUE 的 SNI，默认 `www.microsoft.com`

面板内配置项（存 KV，面板里直接改，不用动环境变量）：mode 运行模式（worker / warp / masque / home）、masqueEps 端点列表（一行一个，按顺序尝试）、nodeLimitCount 节点上限（默认 300）、preferredIPs 优选 IP（可带国家码 / 端口 / 标签）、subUrl / path 订阅与节点路径段、host 自定义优选域名、tgToken / tgChat Telegram 用量通知。

四种模式下发什么

模式	下发内容
`worker`	VLESS / Trojan / XHTTP 节点（默认 300 个），流量经你的 Worker 转发，开箱即用
`warp`	WARP 节点，客户端直连、流量不经过本服务；可设前置节点解锁流媒体与 AI（仅 Mihomo 内核）
`masque`	MASQUE 节点（28 个端点，走 QUIC / UDP-443），可设前置节点（仅 Mihomo 内核）
`home`	家宽节点（VPN Gate 的 OpenVPN + 自定义证书），细讲见配套文章《CFNext 家宽模式教程》

节点命名带地区标签；preferredIPs 支持国家码前缀、自定义端口、#标签 后缀与多源逗号分隔，按地区 / 运营商 / IP 版本筛选后再下发。

性能与安全设计（了解即可）

订阅结果进程内缓存 60 秒
配额安全：面板内开启用量监控与自动调节（需配置 Cloudflare 账户 ID 与 API 令牌），防止免费额度被异常流量打爆
/sub 反滥用限流：同 IP 60 秒内第 31 次请求起静默返回欢迎页
反扫描：未匹配路径统一返回同一份欢迎页，不给扫描者任何提示
健康检查统一走 generate_204；Free 计划单请求 CPU 硬上限 10ms，cpuLimit 默认关闭

常见问题与检查维修

部署后打不开面板：先查三件事——KV 绑定变量名是不是 K；环境变量 L 有没有填、访问路径是不是 /<L 的值>；Pages 部署是不是在绑 KV/设变量之后才做的部署（顺序反了重新部署一次）
忘了密码：密码存在 KV 里；若设过 ADMIN 环境变量，以变量为准（改变量后重新部署）；没设变量时按项目说明走 KV 内密码重置，或清空相关 KV 后重新走 SETUP
订阅拉不到/节点数为 0：检查面板里 mode 与客户端是否匹配（MASQUE 只能用 Meta 系内核客户端）；preferredIPs 筛选条件是否过严（地区+运营商+版本同时筛可能筛空），先放宽筛选验证
筛选不生效（历史版本已知问题）：升级到最新版；3.x 已修复多项筛选与命名问题，更新日志里对每个版本都有记录
被扫描/滥用：换入口路径 L、开严格模式（配额安全，2.8.0 起支持），并利用自带的 /sub 限流与欢迎页兜底

和同系列另外两款的区别

edgetunnel：社区最大、教程最多的全能面板，协议含 Shadowsocks，胜在成熟稳定，见《edgetunnel 2.1 部署教程》
CFnew 精简内核：做减法的路线——内核只管转发、面板独立外置，胜在轻与可控，见《CFnew 精简内核部署教程》
CFNext 的定位是功能最全的订阅管理面板：MASQUE、家宽、多后端聚合是它独有的玩法

配套工具：CFNext 专用优选器（CFScan）

官方另有一个配套的优选工具 PAICNI/CFScan，适用于 CFNext 所有历史版本：

基于 CFData-Web 二次开发的 Go 程序，电脑和安卓客户端通用
支持官方地址库抽样、自定义 CIDR 网段全量扫描，也能测第三方 IP / 域名与端口；支持 EDT 数据拉取与 FOAF 数据自动读取及识别
延迟检测、下载测速、链路复验、结果筛选在一个界面完成；支持自动上报 / 手动上报、自动拉取 EDT 的 IP 源
优选结果可复制、导出，或直接追加上报到 CFNext 的「自定义订阅（支持汇聚）」，省掉手动粘贴

面板自带的在线优选器胜在不用装东西；想要在自己本地网络环境里认真扫一遍（优选结果本来就应该以本地实测为准），用 CFScan 更合适。作者频道「数字派」刚发布了它的使用教程视频（见下节）。

视频教程

作者官方 YouTube 频道是 数字派（@PAI_CN），CFNext 的版本发布与教程都在这个频道：

3.0 新版本部署教程（官方）
2.0 Worker 模式视频使用教程（官方）
CFNext 正式版发布（官方）：全新编写版总览，优选器与订阅生成器演示
零门槛优选 IP 终极指南（官方）：三种优选方式实操，配套阅读《CFNext 优选 IP 指南》
家宽模式三种自定义手写参数教程（官方）：配套阅读《CFNext 家宽模式教程》
CFNext 专用优选器发布与使用方法（官方）

社区教程（版本与本文的 3.1.1 不完全一致，操作以本文和官方 README 为准，视频主要看流程手感）：

CFNext 2.0 正式版升级与部署教程（Cenfeng 科技，2026-10）：Workers 与 Pages 两种方案、KV 绑定、自定义域、订阅导入、分组测速全流程
最新 Cloudflare 免费节点搭建教程（Tech Ark，2026-10）：用 CFNext 走 Pages 部署的最新搭法，含后台节点配置演示

配套文章（本站 CFNext 系列）

《CFNext 家宽模式教程：三种手写参数写法》：本地上传 / Base64 / 纯手写，VPN Gate 住宅出口的完整玩法
《CFNext 优选 IP 指南》：面板在线优选、随机优选、CFScan 本地优选与上报回面板
《CFNext 部署排障：1101 / 522 / 滥用提示》：先分清 MASK 伪装再动手修，含掉速/-1 的复位法

资料来源

项目仓库 README（2026-11，版本 3.1.1）：https://github.com/PAICNI/CFNext
配套优选器 CFScan：https://github.com/PAICNI/CFScan
作者 YouTube 频道「数字派」：https://www.youtube.com/@PAI_CN
项目 Telegram 交流群：https://t.me/SZ_PAI