shitouxiaoge-commits/CFAPEX

项目介绍

CFAPEX 是一个部署在 Cloudflare Workers 或 Pages Advanced Mode 上的代理面板，提供 VLESS/WS、Trojan/WS 和 VLESS/XHTTP 节点，并允许在网页中管理优选 IP、按地区设置 Proxy IP、配置真实出站代理和节点 UUID。客户端可获取 Clash/Mihomo YAML、通用 URI 或 sing-box JSON 订阅。设置保存在 KV 命名空间，面板密码与订阅令牌分开使用。

它适合已经熟悉 Cloudflare Workers/Pages 和代理客户端、希望自己维护面板而不是使用托管服务的人。

快速使用

1. 先在 Cloudflare 创建一个专用 KV 命名空间（例如 CFAPEX_CONFIG），绑定到项目时名称填 K。KV 是绑定，不是普通文本环境变量。
2. 选择一种部署物：把 dist/CFAPEX-worker.1.3.js 作为单个模块 Worker 部署，或上传 Pages Advanced Mode 的 ZIP（根目录只含 _worker.js），也可上传 dist/pages-panel 目录。不要把 Pages ZIP 粘贴进 Worker 编辑器。
3. 设置必填环境变量 A，值作为面板密码。代码会从它派生默认节点 UUID；另有 TROJAN_PASSWORD、TROJAN=0、XHTTP=0、OUTBOUND_PORTS 等可选变量。
4. 保存并部署，然后访问 https://<部署域名>/<A的值> 登录面板。密码包含空格、中文、/、?、#、% 时需要 URL 编码，建议直接使用仅含字母、数字和安全符号的随机值。
5. 在概览中复制独立的 /s/<令牌> 订阅地址。Clash/Mihomo 选 YAML，v2rayN 可试通用 URI，sing-box 桌面版选 ?format=singbox。导入后更新订阅并重连。

部署方式和各客户端的详细选项见项目的使用教程。

使用约束

• 面板版和轻量版 src/worker.js 是不同入口，教程步骤针对面板版。src/worker.js.pre-harden 是旧基线，不应部署。
• 不绑定名称为 K 的 KV 时，设置只存于边缘缓存，缓存回收后可能恢复默认。还原默认会清空整个绑定命名空间，应使用专用 KV。
• 自定义优选 IP 单次最多 1000 条去重节点、262144 字符，单远程来源 256 KiB；远程来源失败时保留旧列表。
• 地区 Proxy IP 最多 100 条、16000 字符，只接管 Cloudflare IPv4 目标，且不保证是最终查到的出口 IP。
• 自定义出站支持 SOCKS5、HTTP(S) 和三种 AEAD 方法的 Shadowsocks，不支持 SS2022 和插件。auto 可回退直连，only 失败即报错。
• 更换 A 会改变面板路径、订阅令牌和派生的默认 UUID，客户端必须重新导入订阅。
• README 说明代码已通过本地语法、协议、KV 读量和 workerd 回归，但公网线路、移动网络、sing-box 桌面导入和 Cloudflare 线上额度仍需部署后验证。
• 仓库元数据未声明许可证。

HotRepo 点评

站内目前只有 2026-11-12 的新项目榜记录：119 Star、71 Fork，观察窗口内新增 8 Star。Star 曲线只覆盖当天很短的一段时间，不足以判断趋势。比数字更值得注意的是 Fork 与 Star 接近的比例：这是一个面向部署者的单文件面板，部署者往往会 Fork 或改造，这与高 Fork 比例相符。该仓库没有记录到 GitHub 全语言日榜名次，因此没有依据称其为热门项目，更适合按部署和验证细节来评估。