byJoey/cfnew-panel

选用指南

AI 根据 README 整理 · 2026/10/17 22:51:09

使用方式

通过 Vercel 一键部署，或使用 Node.js 22 本地运行，默认监听 127.0.0.1:3100，需反代 HTTPS。

查看 README 依据

1. 先部署 [CFnew 精简内核](https://github.com/byJoey/cfnew/tree/core-only)，设置 Worker 变量 `u` 为自己的 UUID。需要在线保存配置时，绑定 KV，名称填 `C` 或 `c`。已有用户保留原 UUID 和 KV 绑定，兼容日期用 `2026-01-20`。 2. 点击上面的 Deploy 按钮，登录 Vercel，按页面提示连接 GitHub 并创建自己的仓库副本。 3. Application Preset（旧界面叫 Framework）选择 **Other**；如果自动识别成 Node，请改为 Other。根目录保持仓库根目录，无需手填构建命令。点击 Deploy，等待完成。 4. 打开分配的面板域名，填写自己的 Worker 域名与 UUID 或自定义路径，即可连接。 5. 在面板中配置并复制订阅到客户端。订阅使用面板域名；节点的 SNI / Host 与代理入口仍是 Worker。 部署按钮会引导平台登录、Git 授权和创建项目，这些步骤仍需用户在自己的账号完成。项目无需付费数据库或面板 KV。 如果仓库列表为空，先到 Vercel 账号的 Authentication → Sign-in Methods 连接 GitHub，再返回部署页面。

这是按流量和处理次数估算的保护，Worker 无法读取实时 CPU 余量，不能保证所有免费账号零超限。客户端需自行重连，正在进行的下载、视频和长连接可能中断，不会自动续传。 ## 自有服务器与 Docker Node.js 22： ```bash git clone https://github.com/byJoey/cfnew-panel.git cd cfnew-panel npm start # 可选：固定自己的 Worker w=https://your-worker.example.com npm start ``` 运行不需要 npm 依赖，默认监听 `127.0.0.1:3100`。用 Nginx / Caddy 反代并启用 HTTPS。不要对外开放未加 HTTPS 的管理入口。 Docker： ```bash docker compose up -d --build # 固定 Worker 可在 .env 中填写 w，或通过环境变量传给 compose。 ``` 面板不把 UUID 或配置写入数据库。勾选“记住节点”只保存在当前浏览器；UUID 和订阅地址相当于访问凭据，勿公开分享，反代访问日志建议不记录这些入口。 ## 更新与限制 - 一键部署得到自己的仓库副本。更新面板源码需同步上游并重新部署；修改环境变量也要重新部署。

部署要求

需要先部署 CFnew 精简内核并设置 Worker 变量 u；如需在线保存配置，需绑定 KV。

查看 README 依据

1. 先部署 [CFnew 精简内核](https://github.com/byJoey/cfnew/tree/core-only)，设置 Worker 变量 `u` 为自己的 UUID。需要在线保存配置时，绑定 KV，名称填 `C` 或 `c`。已有用户保留原 UUID 和 KV 绑定，兼容日期用 `2026-01-20`。 2. 点击上面的 Deploy 按钮，登录 Vercel，按页面提示连接 GitHub 并创建自己的仓库副本。 3. Application Preset（旧界面叫 Framework）选择 **Other**；如果自动识别成 Node，请改为 Other。根目录保持仓库根目录，无需手填构建命令。点击 Deploy，等待完成。 4. 打开分配的面板域名，填写自己的 Worker 域名与 UUID 或自定义路径，即可连接。 5. 在面板中配置并复制订阅到客户端。订阅使用面板域名；节点的 SNI / Host 与代理入口仍是 Worker。 部署按钮会引导平台登录、Git 授权和创建项目，这些步骤仍需用户在自己的账号完成。项目无需付费数据库或面板 KV。 如果仓库列表为空，先到 Vercel 账号的 Authentication → Sign-in Methods 连接 GitHub，再返回部署页面。

已知限制

在线 IP 检测在面板服务器执行，IPv6 在线检测可能出错；请求正文上限 1 MiB；GitHub Pages 无法运行本项目。

查看 README 依据

- 原 WebSocket、XHTTP、出站代理、ECH、IPv6 与客户端订阅生成保留；代理数据面仍由配套核心处理。 - 在线 IP 检测在面板服务器执行，延迟是服务器视角。Vercel 实测 IPv4 检测可用，IPv6 在线检测出现平台出站错误；IPv6 节点生成和 Worker 实际连接已验证，不能用在线检测结果代替客户端测速。 - sing-box 使用 1.12 起的 DNS / 路由格式，内置分流规则，不要求启动时下载规则文件。规则许可见 [NOTICE](./NOTICE.md) 和 `/rules-license`。 - 请求正文上限 1 MiB，大量地址可改用在线列表 URL。健康检查为 `/health`。 - GitHub Pages 只能托管静态页面，不能运行本项目的服务端配置转发、订阅转换和在线检测；本项目使用 Vercel Functions。 ## 开发与验证 ```bash npm ci npm test ``` 测试使用内存 KV 与本地隔离 Worker，不访问你的真实 Worker。`CFNEW_ALLOW_PRIVATE=yes` 仅供隔离测试，线上不要设置。 可生成单独的压缩运行包： ```bash npm run build:vercel -- /一个空目录 ```