Ruleset

You may use a bundle of rules from an URL or a configured rule provider. Chute also provides two internal rulesets.

Internal Ruleset

SYSTEM

RULE-SET,SYSTEM,DIRECT

Includes rules for most requests sent by macOS and iOS itself. The requests sent by App Store, iTunes and other content services are not included.

USER-AGENT,*com.apple.mobileme.fmip1
USER-AGENT,*WeatherFoundation*
USER-AGENT,%E5%9C%B0%E5%9B%BE*
USER-AGENT,%E8%AE%BE%E7%BD%AE*
USER-AGENT,com.apple.geod*
USER-AGENT,com.apple.Maps
USER-AGENT,FindMyFriends*
USER-AGENT,FindMyiPhone*
USER-AGENT,FMDClient*
USER-AGENT,FMFD*
USER-AGENT,fmflocatord*
USER-AGENT,geod*
USER-AGENT,locationd*
USER-AGENT,Maps*
DOMAIN,api.smoot.apple.com
DOMAIN,captive.apple.com
DOMAIN,configuration.apple.com
DOMAIN,guzzoni.apple.com
DOMAIN,smp-device-content.apple.com
DOMAIN,xp.apple.com
DOMAIN-SUFFIX,ess.apple.com
DOMAIN-SUFFIX,push-apple.com.akadns.net
DOMAIN-SUFFIX,push.apple.com
DOMAIN,aod.itunes.apple.com
DOMAIN,mesu.apple.com
DOMAIN,api.smoot.apple.cn
DOMAIN,gs-loc.apple.com
DOMAIN,mvod.itunes.apple.com
DOMAIN,streamingaudio.itunes.apple.com
DOMAIN-SUFFIX,lcdn-locator.apple.com
DOMAIN-SUFFIX,lcdn-registration.apple.com
DOMAIN-SUFFIX,ls.apple.com
PROCESS-NAME,trustd

These rules may be updated with Chute updates. Please refer the description in the software to get the latest sub-rules.

LAN

RULE-SET,LAN,DIRECT

Includes rules for LAN IP addresses and .local suffix. Please notice this ruleset will trigger a DNS lookup.

DOMAIN-SUFFIX,local
IP-CIDR,192.168.0.0/16
IP-CIDR,10.0.0.0/8
IP-CIDR,172.16.0.0/12
IP-CIDR,127.0.0.0/8
IP-CIDR,100.64.0.0/10
IP-CIDR,255.0.0.0/8
IP-CIDR,fc00::/7
IP-CIDR,::1/128
IP-CIDR,fe80::/10

External Ruleset

Ruleset from an http(s) URL. The ruleset file should be a text file. Each line contains a rule declaration without the policy.

RULE-SET,https://example.com/my-rules.txt,Proxy
RULE-SET,https://example.com/my-rules.txt,Proxy,update-interval=86400

The optional update-interval parameter re-downloads the ruleset every N seconds (default: no automatic refresh).

Example ruleset file:

DOMAIN,exampleA.com
DOMAIN,exampleB.com

To use a local file, define an entry in the [Rule Provider] section with a path= parameter and reference it by name:

[Rule Provider]
my-rules = type=file, path=my-rules.txt, format=native

[Rule]
RULE-SET,my-rules,Proxy

Rule provider parameters: type (http, file, or inline; http requires url=), behavior (classical for rule declarations, domain for a domain set; default classical), format (native for Chute rule lines, mihomo-yaml for a Clash/mihomo rule-provider YAML payload; default mihomo-yaml), and interval (refresh seconds, default 86400).

RULE-SET and DOMAIN-SET cannot be used as sub-rules inside AND/OR/NOT logical rules.

Domain Set

A domain set is similar to an external ruleset but specifically for domain names, and uses a more compact file format.

DOMAIN-SET,https://example.com/domains.txt,DIRECT
DOMAIN-SET,https://example.com/domains.txt,DIRECT,update-interval=86400

The first field after the type must be an http(s) URL. The domain set file contains bare domains, one per line (NOT rule declarations):

# exact domain
example.com
# the domain and all of its subdomains
.example.org
+.example.net

Lines starting with # or // are comments.