链式代理后置节点配置工具(cf-sub)

一个家宽链式代理节点注入工具

演示站：https://sub.iodevo.com

---

项目简介

cf-sub 为机场节点自动附加后置家宽代理（支持 SOCKS5, HTTP, HTTPS, SS, Trojan, VLESS 出口），以家宽 IP作为终点出口，同时保留机场原生节点与原有的分流策略。可以将标准的机场节点订阅转化为Clash / Mihomo、Sing-box的配置。

---

核心特性

• 多客户端：
  • Clash / Mihomo (YAML) -> 利用 dialer-proxy 链式代理
  • Sing-box (JSON 1.8+) -> 利用 detour 链式代理
• 家宽敏感信息零暴露：支持在 Workers 环境变量中存储家宽 IP、端口与密码
• 剩余流量与到期时间显示：直观展示已用流量、剩余流量及到期倒计时
• 一键客户端导入：可一键调用客户端快捷导入链接

---

工作原理

[ 用户客户端 ] 
            │
            ▼ (访问目标网站)
    [ 前置节点 (机场节点) ] ── (中继流量) ──► [ 出口节点 (家宽出口) ] ──► [ 目标网站 ]

---

⚡ 部署指南

方式一：网页一键部署 (推荐)

1、Fork 本仓库

2、点击下方按钮，登录 Cloudflare 账号

3、在 Cloudflare 中连接你 Fork 的仓库

---

方式二：命令行部署 (使用Wrangler CLI)

# 1. 克隆项目仓库
git clone https://github.com/Mareixcode/cf-sub.git
cd cf-sub

# 2. 安装依赖
npm install

# 3. 部署至 Cloudflare Workers
npx wrangler deploy

---

配置说明

方法 A：使用 Web UI 界面

方法 B：环境变量 (推荐)

前往 Dashboard -> Workers & Pages -> 选择对应 Worker -> Settings -> Variables，添加以下环境变量：

变量名	说明
SOCKS_TYPE	出口协议类型 (socks5 | http | https | ss | trojan | vless)
SOCKS_SERVER	家宽出口服务器 IP 或域名
SOCKS_PORT	出口服务端口
SOCKS_USERNAME	认证用户名 (可选)
SOCKS_PASSWORD	认证密码 (可选)

---

API 路由与动态参数

• 订阅转换端点：GET /sub
  • url: 原始机场订阅 URL（需 URL 编码）
  • target: 目标客户端
  • socks_type: 出口协议类型 (socks5, http, https, ss, trojan, vless)
  • socks_server: 家宽出口 IP/域名
  • socks_port: 家宽出口端口

---

致谢

• tindy2013/subconverter -订阅转换工具与客户端转换
• Metacubex/mihomo - Clash Meta 内核
• SagerNet/sing-box - 网络代理工具
• Loyalsoldier/clash-rules - 分流规则集
• ACL4SSR/ACL4SSR - 策略组与规则定义

---

⚠️ 免责声明 (Disclaimer)

1. 仅供学习交流：本项目（cf-sub）仅供网络技术研究、开源代码学习及个人测试使用，请勿用于任何违反所在国家或地区法律法规的用途。
2. 风险自负：使用者在部署和使用本项目时，应自行承担相关风险。开发者不对因使用、复制、修改或分发本软件而产生的任何直接或间接损失、法律纠纷、设备故障或安全后果承担任何责任。
3. 第三方服务：本项目依赖 Cloudflare Workers 及第三方订阅节点，第三方服务的稳定性、安全性及合法性由对应服务提供方负责，本项目不做任何形式的保证或担保。
4. 合规使用：请使用者严格遵守所在国家/地区的法律法规及网络管理规定，如因违规使用产生任何法律后果，均由使用者自行承担，与本项目开发者无关。

---

联系方式

• ​Email​: ceohunk@gmail.com
• ​GitHub​: MareixHunk

---

开源协议

本项目采用 MIT License 协议开源。

感谢 LINUX DO 社区开发者对本项目的支持