#clash #yaml #radix-trie #networking #aho-corasick

clash_rules

a clash yaml rule parser and matching algorithms provider

20 releases

0.1.19 Feb 23, 2025
0.1.18 Feb 19, 2025

#158 in Configuration

Download history 279/week @ 2025-02-07 877/week @ 2025-02-14 287/week @ 2025-02-21 173/week @ 2025-02-28 264/week @ 2025-03-07

1,610 downloads per month

MIT/Apache

74KB
2K SLoC

This project can parse the rules and rule-sets in Clash’s YAML configuration files and provides an optimized matching algorithm. The project uses functional programming.

DOMAIN-SUFFIX, IP-CIDR(6) uses radix trie ,DOMAIN-KEYWORD uses Aho-Corasick Automaton. DOMAIN-REGEX uses RegexSet. PORT uses binary search.

For examples, see the test at the end of the lib.rs and benches/algorithms.

There's a convenient struct ClashRuleMatcher and an enum Rule.

Also has feature to load and save to sqlite.

Supported rules are: RULE-SET, GEOSITE, AND, OR, NOT, DOMAIN, DOMAIN-KEYWORD, DOMAIN-SUFFIX, DOMAIN-REGEX, IP-CIDR, IP-CIDR6, GEOIP, PROCESS-NAME, NETWORK, DST-PORT, SRC-PORT, IN-PORT, MATCH

Use external crate geosite-rs to support GEOSITE.

Dependencies

~29MB
~553K SLoC