Наборы правил

Вы можете использовать набор правил из URL, из настроенного провайдера правил (Rule Provider) или из раздела в самой конфигурации. Chute также предоставляет два встроенных набора правил.

Встроенные наборы правил

SYSTEM

RULE-SET,SYSTEM,DIRECT

Включает правила для большинства запросов, отправляемых самой macOS и iOS. Запросы от App Store, iTunes и других контент-сервисов не включены.

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

Эти правила могут обновляться с обновлениями Chute. Актуальный список подправил см. в описании внутри приложения.


LAN

RULE-SET,LAN,DIRECT

Включает правила для IP-адресов локальной сети и суффикса .local. Обратите внимание, что этот набор правил вызовет DNS-запрос.

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

Внешние наборы правил

Набор правил из http(s) URL. Файл набора правил должен быть текстовым файлом. Каждая строка содержит объявление правила без политики.

Внимание: Файлы наборов правил поддерживают только простые (нелогические) типы правил. Логические правила (AND/OR/NOT), SCRIPT и строки DOMAIN-SET отбрасываются. Строка RULE-SET в файле, загруженном по RULE-SET,<url>, инертна: парсер оставляет только встроенные значения SYSTEM и LAN, да и те никогда не разворачиваются, так что такая строка не совпадает никогда. Вложенные ссылки работают в полезной нагрузке [Rule Provider] и во разделе [Ruleset] в самой конфигурации. Строка, содержащая только CIDR (например, 1.2.4.0/24), принимается как правило IP-CIDR.

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

Необязательный параметр update-interval задаёт в секундах, насколько старой может стать загруженная копия. Таймера нет: первое сопоставление после того, как копия стала старше этого значения, обновляет её в фоне, и уже загруженная копия продолжает использоваться для сопоставления, пока это происходит. При загрузке конфигурации кэшированная копия моложе этого значения используется как есть, без скачивания; копия старше используется, пока её скачивают заново. Без update-interval кэшированная копия сохраняется, и набор скачивается, только когда копии нет. Если скачивание не удалось, имеющаяся копия остаётся — или ничего, если её не было, — а повторная попытка выполняется в фоне через 30 секунд, с удвоением после каждой неудачи до часа, но не дольше интервала самого набора и не раньше чем через 10 секунд. Записанная в строке RULE-SET опция no-resolve применяется к каждому правилу на основе IP в наборе.

Внимание: Chute Android пока так не делает. Там кэшированная копия старше update-interval при загрузке конфигурации не используется, поэтому набор должен скачаться, прежде чем начнёт сопоставляться; неудачное скачивание только записывается в журнал — без копии набор остаётся пустым до следующей загрузки конфигурации, — а неудачное обновление повторяется при следующем сопоставлении, без нарастающей задержки.

Пример файла набора правил:

DOMAIN,exampleA.com
DOMAIN,exampleB.com

Чтобы использовать локальный файл, определите запись в разделе [Rule Provider] с параметром path= и ссылайтесь на неё по имени:

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

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

Параметры провайдера правил: type (http или file; для http требуется url=), behavior (classical для объявлений правил, domain для набора доменов, ipcidr для списка CIDR без типа правила — также применимо к провайдерам Clash/mihomo, чьи данные с CIDR без типа правила принимаются; по умолчанию classical), format (native — или surge — для строк правил Chute, mihomo-yaml для YAML-файла rule-provider в формате Clash/mihomo, sing-box-source — или sing-box, source — для набора правил sing-box в формате source (JSON); по умолчанию mihomo-yaml) и interval (в секундах, по умолчанию 86400). При загрузке конфигурации кэшированная копия моложе interval используется как есть, без скачивания; копия старше используется, пока её скачивают заново, а при неудаче повтор выполняется так же, как для скачивания RULE-SET. 0 скачивает только при отсутствии кэшированной копии; отрицательное значение не скачивает никогда — даже по update-interval строки RULE-SET, — так что провайдер остаётся неактивным, если нет кэшированной копии. Пока Chute работает, провайдер обновляется из собственного источника при первом сопоставлении после того, как копия стала старше интервала; если в строке RULE-SET указан update-interval, этот набор следует вместо него значению строки. Chute Android всё ещё работает по-старому: положительный interval скачивает данные заново при каждой загрузке конфигурации, кэшированная копия старше него не используется, неудачное скачивание не повторяется, а пока Chute работает, провайдер обновляется только через строку RULE-SET с update-interval. В строке [Rule Provider] нет ключа, который нёс бы правила, поэтому type=inline там даёт пустой провайдер; набор правил внутри конфигурации записывайте как раздел [Ruleset <name>].

policy=<name> загружает полезную нагрузку через эту политику или группу — это proxy: в mihomo, — например my-rules = type=http, url=https://example.com/rules.yaml, policy=Proxy; для группы используется её выбор на момент начала загрузки. Без него или с policy=DIRECT полезная нагрузка загружается напрямую. Неопределённое имя отклоняет загрузку, а не загружает напрямую.

GET /api/rules/providers в HTTP API управления сообщает о каждой записи [Rule Provider] и каждом разделе [Ruleset]: загрузились ли они, почему нет и какие были предупреждения конвертации. Его rule_count считает строки раздела [Ruleset] и остаётся 0 для загружаемого или файлового провайдера. RULE-SET,<url> и DOMAIN-SET,<url> в список не входят; неудачная загрузка такого набора видна только в журнале.

На Android у полезной нагрузки провайдера правил — загруженной или прочитанной из файла — есть предел размера, потому что приложение выполняет ядро в собственной куче: 400 КБ для sing-box-source и 1 МБ для всех прочих форматов. Полезная нагрузка сверх предела не загружается, а причина указывается в состоянии провайдера. На iPhone и Apple TV предела нет: нагрузка native или surge копируется и индексируется как файл без построения массива строк, а большая нагрузка mihomo-yaml или sing-box-source преобразуется в памяти с предупреждением в журнале, а не отклоняется. RULE-SET,<url> и DOMAIN-SET,<url> потоково пишутся на диск на всех платформах и предела не имеют. На настольных системах предела тоже нет, поэтому большой опубликованный набор (geosite/cn и подобные) загружается на всех платформах, если записан как native или surge; если как mihomo YAML или sing-box source, он преобразуется в памяти с тем же предупреждением. Индекс наборов правил держит открытыми одновременно не более 24 соединений с базой данных на iPhone, Apple TV и Android (128 на компьютере).

Если данные mihomo-yaml не удаётся разобрать, но они выглядят как обычный список строк правил, они читаются как native, а в журнал записывается уведомление. Строка данных mihomo с поведением classical не указывает политику, поэтому всё, что следует за её значением, читается как параметры: no-resolve сохраняется, а любой другой параметр — например, src из mihomo — отбрасывается. Логическое правило и правило …-REGEX сохраняют остаток строки как своё значение.

Данные, представляющие собой объект JSON, сначала пробуются как набор правил sing-box, поэтому набор правил sing-box, объявленный с форматом по умолчанию, тоже загружается. В наборе правил sing-box правило, все условия которого одного вида, превращается в одну строку на каждое значение. Виды такие: назначение (domain, domain_suffix, domain_keyword, domain_regex, ip_cidr, geoip и ip_is_private, которое превращается в диапазоны частных адресов с no-resolve), порт назначения (port, port_range), адрес источника (source_ip_cidr, source_ip_is_private), порт источника (source_port, source_port_range), а также protocol, network, process_name и process_path — каждый как отдельный вид. clash_mode: rule игнорируется, поскольку Chute работает только в режиме правил; любой другой clash_mode отбрасывает правило. Правило, сочетающее разные виды (например, домен и порт), правило с invert и правило logical нельзя записать одной строкой: они пропускаются и перечисляются в предупреждениях набора. Скомпилированные двоичные форматы прочитать нельзя. Провайдер .srs из sing-box распознаётся как таковой — по format=srs, по format=binary или по расположению, оканчивающемуся на .srs, — и остаётся неактивным со статусом, который советует указать на исходную (.json) форму sing-box. .mrs из mihomo не распознаётся: его полезная нагрузка просто не декодируется как текст, поэтому набор остаётся неактивным с общим статусом об ошибке загрузки. На macOS импортёр перенаправляет двоичный набор на исходную (source) версию рядом с ним, если издатель её предлагает; на iOS, Apple TV и Android — нет.

RULE-SET и DOMAIN-SET можно использовать как подправила внутри логических правил AND/OR/NOT — NOT,((RULE-SET,cn_ip)),Proxy работает, а вложенный набор сопоставляется тем же фильтром полезной нагрузки, что и записанный отдельно.


Набор правил внутри конфигурации

Раздел [Ruleset <name>] хранит набор правил прямо в файле конфигурации (синтаксис Surge). Каждая строка в нём — объявление правила без политики, как в файле набора правил, а правило ссылается на раздел по имени:

[Ruleset Streaming]
DOMAIN-SUFFIX,netflix.com
IP-CIDR,198.51.100.0/24,no-resolve

[Rule]
RULE-SET,Streaming,Proxy

Раздел работает как запись [Rule Provider] с type=inline и format=native и сохраняется обратно в виде раздела. Два набора правил с одинаковым именем — ошибка конфигурации.

Раздел в самой конфигурации — как и данные провайдера правил — может содержать RULE-SET,SYSTEM, RULE-SET,LAN или RULE-SET,<другой раздел в конфигурации>. Они раскрываются при загрузке правил, не глубже 8 уровней. Ссылка, образующая цикл, а также ссылка на набор правил типа file или http, на набор доменов или на DOMAIN-SET отбрасывается с предупреждением.


Набор доменов

Набор доменов похож на внешний набор правил, но предназначен специально для доменных имён и использует более компактный формат файла.

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

Первое поле после типа должно быть http(s) URL. Файл набора доменов содержит только доменные имена (без типа правила), по одному в строке (НЕ объявления правил):

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

Строки, начинающиеся с # или //, являются комментариями.

S. Smart Rabbit LLC © All Rights Reserved            updated 2026-10-27 02:39:57

Эта страница — перевод английской версии. При расхождениях приоритет имеет английская версия.

results matching ""

    No results matching ""