README

CFnew 精简内核




把代理转发留在 Cloudflare，把控制台、优选操作和订阅生成交给独立面板。内核 37,806 字节，较原完整版本减少约 92%。节点流量直接连接你自己的 Worker。

打开面板 · 下载最新版 · 视频教程 · 完整变量表

当前默认分支是 core-only。旧完整版保留在 main，旧版发行是 v3.1。独立面板源码在 cfnew-panel。

 接入面板和客户端

1. 打开 cfnew.xy.kg，填写自己的 Worker 域名和同一个 UUID。域名填 HTTPS 根地址，不带 UUID、路径或查询参数。
2. 在配置管理中选择协议、优选来源、出站方式等，点击保存。未绑定 KV 时可以读取环境配置、生成订阅，不能在线保存。
3. 复制面板生成的订阅地址，导入对应客户端。订阅域名是面板，节点的 SNI / Host 和实际代理入口仍是你的 Worker。

也可以自己部署面板。Vercel 部署步骤和可选变量 w 见该仓库；w 设置在面板项目，不要填到 Worker。

UUID、自定义路径和完整订阅链接都能用于访问你的配置，请妥善保管。“记住节点”只保存在当前浏览器，删除已保存节点不会删除 Worker 或 KV 配置。

 先选下载文件

Windows、macOS、Linux 都用同一份文件，按部署方式选择即可。

| 部署方式 | 下载文件 | 怎么用 |
| --- | --- | --- |
| Cloudflare Pages | Pages.zip | 整包直接上传，不用解压。包根目录只有 _worker.js。 |
| Cloudflare Workers | _worker.js | 在 Worker 编辑器中完整替换代码，再部署。 |
| 校验下载 | SHA256SUMS.txt | 用 SHA-256 核对文件是否完整。 |

仓库里的 pages.zip 与发行的 Pages.zip 字节一致。GitHub 自动生成的 Source code (zip / tar.gz) 是整个仓库源码，不能直接当 Pages 部署包上传。

 第一次部署

准备一个 Cloudflare 账号，以及自己生成的 UUID。所有示例里的域名和凭据都要换成自己的。

 Cloudflare Pages

1. 下载上面的 Pages.zip。
2. Cloudflare 控制台 → Workers 和 Pages → 创建应用 → Pages → 直接上传 / 上传资产。创建项目，把整个 Pages.zip 上传并部署。
3. 项目设置 → 变量和机密，在生产环境添加文本变量 u，值填自己的 UUID。大写 U 也支持。
4. 需要在面板保存设置时，创建一个 Workers KV 命名空间，在 Pages 项目的绑定设置中添加 KV，绑定名称填 C 或 c。
5. 兼容日期设置为 2026-01-20。添加变量、绑定或更改兼容日期后，重新部署，使新设置进入生产版本。
6. 使用可访问的 pages.dev 地址，或给项目绑定自己的域名，然后按上面的步骤接入面板。

Pages 页面若只允许拖文件夹，可把压缩包解压后上传包含 _worker.js 的目录，确保它在上传内容的根目录。

 Cloudflare Workers

1. 新建 Worker，先完成初始部署，再进入代码编辑器。
2. 下载 _worker.js，把文件内容完整粘贴到编辑器。使用 ES Module 格式，保留 import 和 export default，保存并部署；不要复制 GitHub 网页的 HTML。
3. 在设置 → 变量和机密中添加 u，值填自己的 UUID；需要在线保存设置时，添加名为 C 或 c 的 KV 绑定。
4. 兼容日期设为 2026-01-20，重新部署后绑定可用域名。

打开 Worker 首页显示 hello 就是本版预期行为。管理页面和订阅已经移到独立面板，不在 Worker 首页。

 常用变量

变量设置在 Cloudflare Worker / Pages 项目。除 u 和 KV 绑定外，大多数设置可以直接在面板修改，无需逐项添加环境变量。

| 变量 | 默认值 | 用途 |
| --- | --- | --- |
| u / U | 请自行设置 | 代理 UUID，也是面板的登录凭据。 |
| C / c | 未绑定 | KV 命名空间绑定，用来在线保存配置。不是普通文本变量。 |
| d / D | 空 | 自定义面板登录路径，例如 /Admin/Panel。 |
| ev、et、ex | yes、no、no | 分别开启 VLESS WS、Trojan WS、VLESS XHTTP。 |
| p / P | 空 | 指定 ProxyIP，支持 host:port 与 [IPv6]:port。 |
| s / S | 空 | SOCKS5、HTTP 或 HTTPS 出站代理。 |
| qj / QJ | 空 | 出站策略：空为代理优先，no 为直连优先，only 为只走代理。详见完整变量表。 |
| yx / YX | 空 | 手填优选地址列表，每行一个，可带端口和备注。 |
| yxURL / YXURL / YX_URL | 空 | 在线优选列表地址，搭配“仓库优选”开关使用。 |
| jk / JK | no | 开启家宽链式订阅，面板会提供“CLASH 家宽”入口。 |
| freeCpu / FREE_CPU | no | Free CPU 预算保护，达到预算会断开连接。 |

全部 32 项配置、环境变量别名、默认值、请求参数和 API →

配置优先级是 KV 已保存的配置  环境变量  内置默认值。因此修改环境变量后，KV 里保存过的同名值仍会覆盖它。通过面板修改并保存，或按完整变量表说明清理对应 KV 字段。环境变量更改后需要重新部署。

 协议与订阅

| 功能 | 当前支持 |
| --- | --- |
| 代理入站 | VLESS WebSocket、Trojan WebSocket、VLESS XHTTP。 |
| XHTTP | HTTP/2，使用 stream-one；不要改成 packet-up、stream-up，auto 也不作为本版兼容保证。 |
| 出站 | 直连、ProxyIP 回退、SOCKS5、HTTP、HTTPS。 |
| DNS | VLESS 的 UDP DNS 转发；不提供通用 UDP、游戏 UDP 或 QUIC 隧道。 |
| 订阅格式 | Base64 / V2Ray、Clash、Stash、sing-box、Surge、Loon、Quantumult X，按客户端适配。 |
| 家宽链式 | 开启 jk 后使用面板的“CLASH 家宽”订阅；依赖外部节点，速度和可用性会变化。 |

sing-box 使用 1.12 及以上版本的配置格式。不同客户端能用的协议不同，优先用面板提供的对应入口。精简内核不提供 Shadowsocks 入站。

| 客户端 |