Configuration
Most functions of Chute are controlled by the configuration file. Chute iOS and Chute Mac can share configuration files via iCloud Drive. You may edit the configuration file with your text editor, Chute iOS app, or Chute Dashboard.
Configuration Sections
The configuration file is organized into named sections:
| Section | Purpose |
|---|---|
[General] |
Global settings (logging, IPv6, DNS, proxy ports, etc.) |
[Report] |
Notification reporting thresholds for anomaly detection |
[Proxy] |
Outbound proxy policy definitions |
[Proxy Group] |
Policy group definitions (select, url-test, fallback, load-balance, ssid) |
[Rule] |
Traffic matching and routing rules |
[Host] |
Local DNS host-to-IP mappings |
[URL Rewrite] |
URL rewrite rules |
[Header Rewrite] |
HTTP header rewrite rules |
[Body Rewrite] |
HTTP body search-and-replace rules |
[Map Local] |
Mock response rules |
[MITM] |
HTTPS decryption settings |
[Script] |
JavaScript script definitions |
[SSID Setting] |
Wi-Fi SSID suspend rules |
[Replica] |
Traffic recording filters |
[Module] |
External module files |
[WireGuard] |
WireGuard tunnel configurations |
[Proxy Provider] |
External proxy list sources |
[Rule Provider] |
External rule set sources |
Comment
Chute configuration file supports comment line, starts with '#', ';' and '//'. Comment inline will also be supported with separation of '//'. The comments for rules and hosts will be kept if editing the configuration with GUI, and the other comments will be deleted after saving.