Списки

Вписывать сотни доменов руками неудобно, а готовые списки часто кто-то уже ведёт. Поэтому группа может брать правила по ссылке. firc скачивает список, разбирает его и обновляет по расписанию. Своих правил у такой группы может не быть совсем, а может быть несколько — они работают вместе со списком.

У одной группы может быть один список. Нужно два списка — сделайте две группы.

Как подключить список

Откройте Настройки группы (или создайте новую кнопкой Добавить группу).
Включите переключатель Список по URL.
В поле Адрес вставьте ссылку на список. Подходят только адреса http:// и https://.
Выберите, как часто обновлять: раз в час, раз в 6 часов, раз в день, раз в неделю или вручную.
Нажмите Предпросмотр: firc скачает и разберёт список, ничего не сохраняя, и покажет, сколько в нём правил и каких типов.
Сохраните группу, затем нажмите Сохранить изменения на странице.

Новая группа со списком по URL и результатом предпросмотра

Предпросмотр помогает поймать ошибку до сохранения. Строка Строки, не являющиеся правилами показывает, сколько строк firc не смог прочитать как правило. Если правил ноль, а таких строк много, значит, список в формате, который firc не обрабатывает (например, файл hosts или фильтр для блокировщика рекламы), и под счётчиком будет надпись об этом.

Какие форматы понимает firc

Формат firc определяет по содержимому, а не по расширению файла.

Текстовый список. Одно правило на строку, можно и через запятую. Строки, начинающиеся с #, — комментарии. Тип каждой строки firc определяет сам, так же как при Импортировать список в группе:

имя домена — Namespace (домен со всеми поддоменами);
адрес или подсеть — IPv4 subnet или IPv6 subnet;
шаблон со * или ? — Wildcard;
регулярное выражение — только если строка начинается с ^ и заканчивается на $.

# сервисы для туннеля
example.com
example.net, example.org
203.0.113.0/24

Rule-set sing-box. И исходный JSON, и скомпилированный файл .srs. Из правил берётся то, что относится к адресу назначения:

Поле rule-set	Правило firc
`domain`	Domain
`domain_suffix`	Namespace
`domain_keyword`	Wildcard вида `слово`
`domain_regex`	Regex
`ip_cidr`	IPv4 subnet или IPv6 subnet
`network`, `port`, `port_range`	протокол и порты у правила-подсети

Правило rule-set, в котором есть условия, которых firc не умеет (например, по адресу источника или по имени процесса), firc пропускает целиком и считает в Строки, не являющиеся правилами.

Протокол и порты у firc бывают только у подсетей. Если в rule-set домен ограничен протоколом или портом, firc возьмёт домен без ограничения и покажет, сколько таких имён, в строке Имена без ограничения протокола.

Список в группе

У группы со списком под названием видны метка список, ссылка, время последнего обновления, интервал (Обновлять:) и счётчик вида «2 из списка + 0 своих».

Группа со списком: свои правила и правила из списка

Развёрнутая группа делится на два блока:

Свои правила — правила, которые вы добавили сами. Они проверяются вместе со списком и относятся к той же группе.
Из списка — то, что пришло по ссылке. Большой список листается и ищется постранично. Отдельное правило списка можно выключить или сменить ему тип. firc запомнит такую правку и после обновления списка, а у правила появится метка изменено; счётчик «изменено вручную» показывает, сколько их.

Обновление

По расписанию — с интервалом, выбранным в Обновлять:. Интервал меняется прямо в строке группы.
Вручную — кнопка Обновить список в строке группы. Если в группе есть несохранённые правки правил, firc предупредит, что они пропадут. У новой, ещё не сохранённой группы кнопка неактивна: сначала сохраните группу.

Правила списка firc держит в памяти и не записывает в файл настроек, поэтому после перезапуска демона список скачивается заново. Пункт вручную в расписании так и подписан: один раз после запуска демона, дальше — только по кнопке.

Если скачать или разобрать список не удалось, причина видна у списка и в журнале.

Группы и правила Устройства