配套主文:《CFNext 部署教程》 · 项目地址:PAICNI/CFNext · 官方频道:数字派 @PAI_CN

CFNext(以及同类 CF 代理面板)最常见的三个「故障」是:部署时报 Error 1101、访问时报 522、账号收到滥用提示。但这里有个反直觉的前提:CFNext 有一部分「报错」是它故意装的——2.7 版起它给未授权访问统一返回伪装页,其中就包括伪造的 1101 页。所以排障第一步不是修,而是先分清:你看到的到底是真故障,还是自己开的伪装。本文按官方更新日志的修复口径整理。提醒:以下方法只用于排查你自己部署的服务,请遵守 Cloudflare 服务条款。

先分清:路由伪装 MASK 不是故障

2.7.0 引入了两个机制,先理解它们能省掉一半误判:

  • 反跳转:移除了固定 /login 入口和全部未授权 302 跳转(仅保留 http→https 的 301)。未登录、根路径、路径不匹配一律直接渲染静态欢迎页——对外只呈现一个静态站点,扫描者看不到任何跳转链
  • 路由伪装 MASK:默认返回静态欢迎页;设 MASK=1101 时返回伪造的 Cloudflare 1101 错误页;MASK=off 返回 404;2.8.1 起新增 522 形态

所以:用无痕窗口/未登录状态打开你的域名,看到欢迎页、1101 页甚至 522,都可能是正常伪装。判断真故障要带正确入口路径、登录后看,或换已登录的浏览器对比。

Error 1101:两类成因

1101 是 Worker 代码运行时异常的报错页。放在 CFNext 语境里分两类:

  1. 部署期被拦截:代码里的静态特征(敏感词、典型结构)在部署阶段被识别,直接部署失败或部署后打开即 1101。官方的应对在 2.7.0 写得很清楚:特征词运行时消隐、面板注释归档,并提供 JS 混淆版 / 小说分片版产物,就是为了降低部署时被静态特征查杀、报 Error 1101 的概率。结论:线上部署不要用明文版,用小说混淆版或混淆 Pages 版(主文《CFNext 部署教程》的形态表)
  2. 运行期真异常:代码粘贴不完整、KV 没绑对(变量名必须是 K)、环境变量缺失(L 必填)。按主文部署步骤逐项复查:KV 绑定名、入口路径、Pages 的部署顺序(先变量/KV、后部署)

命名也有讲究:官方视频里特别提醒,Worker 名称、节点名尽量别出现 VLESS、VMess、CFNext 这类容易触发特征的名字。

522 与「连接超时」类现象

  • 如果你没开 MASK 伪装却看到 522:多为自定义域/源站侧问题——检查域名解析是否正确指向、Pages/Worker 的自定义域是否已激活、证书是否生效
  • 如果开了 MASK 的 522 形态:那是伪装,换登录入口验证即可
  • 节点能连但掉速、延迟大面积 -1:这是另一个官方已知项。2.x 的处理是出站逻辑回滚到 1.0.1 口径:直连目标永远最先尝试,自定义落地其次,内置地区反代最后;仍掉速时,把节点配置里的出站模式改成其它模式、再改回默认(优先代理,失败直连)即可刷新

滥用提示与账号受限

2.7.0 这一版的标题就叫「修复滥用及 1101」:除了上面的反跳转与伪装,还做了入站解析与出站请求的超时/异常边界补齐(2.8.1 继续加固)。使用层面的自保要点:

  • 入口路径 L 不要用 admin、login 这类常见词,订阅地址妥善保管(订阅免登录,泄露等于公开节点)
  • 开启面板的「配额安全」做用量监控与自动调节,别让免费额度被异常流量打爆
  • /sub 自带限流(同 IP 60 秒内第 31 次请求起返回欢迎页),异常拉取先查是不是有人在刷你的订阅地址,必要时换入口路径
  • 不要把部署了面板的域名到处公开传播

一套排查顺序(从省事到费事)

  1. 无痕窗口打开域名根路径 → 欢迎页/伪装页属正常;带 /<入口> 能进登录页,说明服务活着
  2. 登录异常 → 查 ADMIN 是否覆盖了面板密码、KV 里密码是否被改;忘了密码按主文的恢复办法处理
  3. 部署即 1101 → 换小说混淆版重新部署,检查 Worker 命名避开特征词
  4. 改完设置不生效 → Pages 重新部署一次;检查 KV 绑定是否绑到生产环境
  5. 节点 -1/掉速 → 出站模式切换复位法(见上)
  6. 还不行 → 看仓库更新日志是否已有对应修复版本,直接升级到最新版往往比在旧版上修更快;交流群 t.me/SZ_PAI 里搜相同报错

视频教程

在 YouTube 打开原视频 ↗

在 YouTube 打开原视频 ↗

资料来源

  • CFNext 仓库 README 更新日志 V2.7.0 / V2.8.1 与维护者答疑(2026-11)
  • 数字派官方视频与社区教程(见上)