Clash配置规则集合与JustMySocks订阅转换工具集。本项目整合了多个公开规则源，并提供了跨平台云端部署的订阅转换服务，用于自动将代理配置转换为Clash兼容格式。

这是一个综合性的Clash规则和工具项目，包含两大功能模块：

1. 规则集合模块：集成多个优质规则源，实时更新各类应用和服务的代理规则
2. 订阅转换服务：提供JustMySocks账户订阅转换为Clash配置的API服务，支持多种云端部署方式

Clash配置模板文件，定义了Clash的基础配置结构和策略组定义。包含：

• 端口配置（HTTP、SOCKS、混合代理端口）
• DNS配置（国内国际DNS分流、FakeIP设置）
• 日志和API设置
• 代理策略组模板（快速测试、负载均衡等）
• 代理路由规则模板（通过占位符如{ProxyList}、{ProxiesNames}等填充）

包含来自 blackmatrix7/ios_rule_script 项目的各类服务规则文件。这些是针对特定应用和平台的详细规则，用于精确控制各服务的流量转发。

文件列表（YAML格式，包含域名和IP段规则）:

• Netflix.yaml - Netflix流媒体服务规则
• YouTube.yaml - YouTube视频平台规则
• Disney.yaml - Disney+流媒体规则
• TikTok.yaml - TikTok短视频平台规则
• Telegram.yaml - Telegram即时通讯规则
• Google.yaml - Google服务规则
• Microsoft.yaml - 微软服务规则
• Amazon​PrimeVideo.yaml - Amazon Prime Video流媒体规则
• Hulu.yaml - Hulu流媒体规则

特点:

• 自动化生成：通过GitHub Actions读取 configs/config_blackmatrix7.yml 配置文件自动更新
• 配置驱动：在配置文件中定义规则源URL、名称和默认代理，即可自动生成对应的规则文件
• 灵活管理：修改配置文件可轻松添加、删除或调整指定服务规则

包含来自 Loyalsoldier/clash-rules 项目的通用规则文件。这是作为总体分流基础的规则集，用于将流量分类为不同的路由策略（代理、直连、拒绝等）。

文件列表（文本格式，每行一条规则）：

• gfw.txt - GFW列表（需要代理的网站）
• direct.txt - 直连列表（国内主要网站）
• cncidr.txt - 中国IP段CIDR列表
• lancidr.txt - 局域网IP段列表
• tld-not-cn.txt - 非中国顶级域名列表
• google.txt - Google相关服务
• apple.txt - Apple相关服务
• icloud.txt - iCloud相关服务
• greatfire.txt - GreatwallFirewall相关网站
• proxy.txt - 代理工具相关网站
• reject.txt - 拦截列表（如广告、追踪等）
• applications.txt - 应用程序相关域名
• telegramcidr.txt - Telegram服务IP段
• private.txt - 私有IP段

特点：

• 作为总体分流的基础规则，优先级较低
• 定期自动更新，覆盖主流应用和网络基础设施

项目维护的自定义规则，补充和优化来自其他源的规则。

文件列表（YAML格式）：

• CustomProxy.yaml - 自定义代理规则（GitHub、Z-Library、platformio等常用工具和服务）
• CustomDirect.yaml - 自定义直连规则（国内服务和本地服务）
• Streaming.yaml - 流媒体和娱乐服务规则补充

用途：

• 补充开源规则中缺失的域名
• 修正错误的分类规则
• 添加用户特定需求的域名
• 与其他规则源的冲突解决

使用Vercel Serverless Functions部署的JustMySocks订阅转换服务。详见：vercel/README.md

使用阿里云ESA(Edge Serverless Application)部署的JustMySocks订阅转换服务。详见：aliyunesa/README.md

使用Cloudflare Workers部署的JustMySocks订阅转换服务。详见：worker/README.md

配置文件
├─→ configs/config_blackmatrix7.yml (指定服务规则配置)
│   ├─ mirror_site: 镜像站点
│   ├─ target_dir: 输出目录
│   └─ rules: 规则列表（含URLs、默认代理等）
│   ↓
│   gen_blackmatrix7.yml (GitHub Actions工作流)
│   ↓
│   scripts/gen_blackmatrix7.js (Node.js处理脚本)
│   ↓
│   [gen_blackmatrix7/] (生成服务YAML规则文件)
│   ↓
│   ClashConfigTemp.yaml (自动更新proxy-groups、规则来源和分流逻辑)
│   ↓
│   用户按需使用
│
└─→ Loyalsoldier/clash-rules (总体分流规则)
    ↓
    gen_loyalsoldier.yml (GitHub Actions工作流)
    ↓
    [gen_loyalsoldier/] (生成总体分流文本规则)
    ↓
    用户作为基础规则引入Clash配置

工作流执行步骤：
    ↓
1. 读取 configs/config_blackmatrix7.yml 配置
2. 遍历配置中的每个规则
3. 检查规则URL可用性
4. 下载并处理规则内容
5. 生成YAML格式规则文件
6. 更新ClashConfigTemp.yaml中的三个区块：
   - 代理配置（含default_proxy优先级）
   - 规则提供者配置
   - 分流规则配置
7. 清理临时文件
8. 提交变更

配置文件格式说明（configs/config_blackmatrix7.yml）：

mirror_site: https://mirror.ning.host          # 镜像站点用于加速URL访问
target_dir: gen_blackmatrix7                    # 规则输出目录
rules:
  - name: Microsoft                             # 规则名称
    urls:                                       # 规则源URLs（支持多个）
      - https://raw.githubusercontent.com/...
      - https://raw.githubusercontent.com/...
    default_proxy: Direct                       # 可选：默认代理（优先级最高）
  - name: YouTube
    urls:
      - https://raw.githubusercontent.com/...
    # 不指定default_proxy则使用默认代理顺序

规则加载顺序说明：

• 指定服务规则（gen_blackmatrix7）优先级高，精确匹配特定应用
• 总体分流规则（gen_loyalsoldier）作为基础，处理未被指定规则覆盖的流量
• 本地自定义规则可补充和修正两种规则集的遗漏或冲突

JustMySocks账户信息
    ↓
API请求参数解析 (service, id, useDomain等)
    ↓
并行获取数据
    ├─→ 流量查询 (BW统计API)
    ├─→ 代理配置 (Base64编码的SS/VMess)
    └─→ Clash模板 (ClashConfigTemp.yaml)
    ↓
数据处理
    ├─→ Base64解码
    ├─→ 代理协议解析 (SS → Clash, VMess → Clash)
    ├─→ 代理名称映射 (c6s1→美国1, c6s4→日本等)
    └─→ 流量信息计算 (1024→1000进制转换, 过期日期计算)
    ↓
配置生成
    ├─→ YAML格式转换
    ├─→ 模板占位符替换 ({ProxyList}, {ProxiesNames}等)
    └─→ 代理组生成 (快速测试, 负载均衡等)
    ↓
动态文件名生成 (UTC+8时区)
    ↓
返回Clash配置文件 (可直接导入)

在Clash配置中添加规则提供者：

rule-providers:
  # 黑名单规则（需代理的网站）
  netflix:
    type: http
    url: https://raw.githubusercontent.com/ningjx/Clash-Rules/master/gen_blackmatrix7/Netflix.yaml
    interval: 86400

  # 白名单规则（直连网站）
  gfw:
    type: http
    url: https://raw.githubusercontent.com/ningjx/Clash-Rules/master/gen_loyalsoldier/gfw.txt
    interval: 86400

  # 自定义规则
  custom-proxy:
    type: http
    url: https://raw.githubusercontent.com/ningjx/Clash-Rules/master/local_rules/CustomProxy.yaml
    interval: 86400

使用订阅转换服务获取包含所有规则和代理的完整配置。见下文。

三种部署方案均提供相同的API接口，选择任一方案即可：

请求格式：

GET /justmysocks?service=SERVICE_ID&id=SUBSCRIPTION_GUID&useDomain=true

参数说明：

• service (必需)：JustMySocks服务ID（8位数字）
• id (必需)：订阅GUID
• useDomain (可选)：是否使用域名，默认true
• track (可选)：追踪ID

响应：

• 直接返回Clash配置文件（.yaml格式）
• 文件名自动生成：ClashConfig-YYYY-MM-DD-HH-MM-SS.yaml
• 响应头包含流量信息：Subscription-Userinfo

配置导入：

1. 获取配置文件URL
2. 在Clash应用中导入配置
3. 自动关联所有规则和代理

推荐选择：

• 国际用户优先：Cloudflare Workers
• 快速部署：Vercel

1. 修改或创建 local_rules/ 下的yaml文件
2. 按照Clash规则格式添加payload

编辑 ClashConfigTemp.yaml 来自定义：

• DNS配置
• 端口设置
• 代理策略组
• 规则路由

• blackmatrix7规则：每日自动更新
• loyalsoldier规则：每日自动更新
• 本地规则：手动维护
• 规则缓存：建议设置为86400秒（每日）

Q: 规则文件什么时候更新？ A: GitHub Actions每日定时自动更新blackmatrix7和loyalsoldier的规则，查看Actions标签可看到最新更新时间。

Q: gen_blackmatrix7和gen_loyalsoldier有什么区别？ A: 两者都是规则集，功能不同：

• gen_blackmatrix7：指定服务的精细规则，每个文件针对一个具体应用（如Netflix、YouTube），规则数量多、覆盖详细，优先级高
• gen_loyalsoldier：总体分流的基础规则，包含通用的代理/直连/拦截列表，优先级低
• 推荐组合使用：先用gen_blackmatrix7精确控制已知服务，再用gen_loyalsoldier处理其他流量
• 管理方式：通过编辑 configs/config_blackmatrix7.yml 来添加、删除或调整指定的服务规则

Q: 如何选择合适的部署方案？ A: 建议使用Cloudflare Workers，或者Vercel。

Q: 流量信息在哪里看？ A: 导入配置后，在代理应用中查看Subscription-Userinfo响应头的流量信息（使用量/总量）。

Q: 支持其他协议吗？ A: 目前支持SS和VMess协议。其他协议支持需要扩展代码。

• blackmatrix7规则项目
• Loyalsoldier规则项目