🎯 ipset: списки IP-адресов и подсетей в Zapret 2

О чём заметка

Полное объяснение списков адресов в Zapret 2: когда профилю нужен список адресов, а не сайтов, что такое подсеть и как её записать, формат файла, порядок проверки включающих и исключающих списков, частые ошибки и то, как списки адресов устроены в программе Zapret GUI. Парная заметка про списки доменов — hostlist, общий порядок проверок профиля — фильтры профиля.

TL;DR

  • ipset — файл с IP-адресами и подсетями, по одной записи на строку. Профиль с таким списком работает только для соединений с этими адресами.
  • Адрес сервера известен с первого пакета соединения, поэтому список адресов решает сразу. Список сайтов (hostlist) ждёт приветствия TLS с именем сайта.
  • Подсеть записывается как адрес/число: 10.0.0.0/8 — все адреса от 10.0.0.0 до 10.255.255.255. IPv4 и IPv6 можно писать в один файл. Диапазоны через дефис и имена сайтов движок не понимает.
  • Сначала проверяются исключающие списки (--ipset-exclude), потом включающие. Исключение сильнее: адрес из исключений профиль не возьмёт, даже если он есть во включающем списке.
  • Пустой файл значит «все адреса». Префиксов ^ и !, как у списков сайтов, у ipset нет.

Когда нужен список адресов, а не сайтов

У профиля два способа сказать, к какому трафику он относится по месту назначения: по имени сайта (hostlist) и по адресу сервера (ipset). Имя удобнее — оно понятно человеку и не меняется, когда сайт переезжает на другой сервер. Но имени бывает недостаточно:

  • Имени в соединении нет. Голосовые каналы Discord, игры, мессенджеры и многие приложения ходят по UDP или по своим протоколам, где нет приветствия TLS с именем сайта. Такое соединение можно узнать только по адресу и порту.
  • Блокируют сам адрес. Если провайдер режет все соединения с определённой подсетью, независимо от имени, профиль по адресам ловит именно эти соединения.
  • Решение нужно с первого пакета. Некоторым стратегиям важно начать работу ещё до приветствия TLS. Профиль со списком сайтов в это время в выборе не участвует, а профиль по адресам — участвует.
  • Нужно исключить целую сеть. Например, российские адреса в широком профиле «все сайты»: так в стандартных пресетах Zapret GUI сделан профиль «Все сайты (айпи)» с исключающим списком ipset-ru.txt.

Проще говоря: hostlist отвечает «к какому сайту», ipset — «на какой сервер». Первое удобнее, второе срабатывает раньше и работает там, где имени нет.

IP-адрес и подсеть простыми словами

IP-адрес версии 4 — четыре числа от 0 до 255 через точку: 142.250.74.46. Так записывают один компьютер в сети. Компании получают адреса не по одному, а блоками, и такой блок называют подсетью. Подсеть записывают как первый адрес блока, косую черту и число: 142.250.0.0/15.

Число после косой черты говорит, сколько первых битов адреса общие у всех адресов подсети. В адресе IPv4 32 бита, поэтому чем меньше число, тем больше подсеть: каждый бит меньше удваивает её размер.

ЗаписьСколько адресовКакие адреса
1.2.3.4 или 1.2.3.4/321только 1.2.3.4
1.2.3.0/24256от 1.2.3.0 до 1.2.3.255
10.1.0.0/1665 536от 10.1.0.0 до 10.1.255.255
10.0.0.0/816 777 216от 10.0.0.0 до 10.255.255.255

Проще говоря: /24 — это «последнее число любое», /16 — «последние два числа любые», /8 — «любые три последних числа».

IP-адреса версии 6 длиннее и пишутся через двоеточие: 2a00:1450:4010::200e, подсеть — 2a00:1450::/32. Правило то же, только битов 128. Движок принимает IPv4 и IPv6 в одном файле.

Формат файла

Файл — обычный текст, одна запись на строке. Движок разбирает строку так (функция разбора в исходнике nfq2/ipset.c):

  • пробелы и табуляция в начале пропускаются;
  • строка, которая начинается с #, ; или /, — комментарий;
  • запись — адрес или подсеть IPv4 либо IPv6; всё после первого пробела отбрасывается;
  • строку, в которой не адрес и не подсеть, движок пропускает и пишет в журнал bad ip or subnet. Так пропадут и диапазон 1.1.1.1-2.2.2.2, и имя сайта youtube.com;
  • файл можно сжать gzip.
# Telegram
91.108.4.0/22
149.154.160.0/20
2001:67c:4e8::/48
# один сервер (адрес для примера)
203.0.113.10

Формат описан в руководстве движка, раздел про хостлисты и ipset. Подсети, которые пересекаются, и повторы адресов не мешают: адрес просто входит в список. В отличие от списка сайтов, здесь нет ни префиксов ^ и !, ни правила «первая запись побеждает» — для адреса важно только, попал ли он хотя бы в одну подсеть файла.

Пустой файл — это «все адреса»

Если в файле нет ни одной записи, движок считает, что включающего списка у профиля нет, и профиль подходит любому адресу. Это старое поведение, оставленное ради совместимости. Zapret GUI поэтому не оставляет список адресов пустым и дописывает в пустой список заглушку 123.123.123.123.

Когда список адресов срабатывает

Соединение начинается с пакета SYN, и в нём уже есть адрес сервера. Значит, профиль по адресам может забрать соединение с самого первого пакета. Имя сайта движок узнаёт позже — из приветствия TLS (ClientHello), четвёртого пакета соединения. До этого профиль со списком сайтов в выборе не участвует. Диаграмма в начале заметки показывает это на одном HTTPS-соединении.

Так устроен выбор профиля в функции dp_match (исходник nfq2/desync.c): проверка адресов там стоит раньше проверки сайтов, а профиль со списком сайтов без известного имени сразу выбывает. Из этого следует практическое правило. Если над профилем со списком сайтов стоит профиль по адресам (или широкий профиль вообще без списков), первые пакеты соединения достанутся ему, и его стратегия успеет на них сработать. Потом движок узнает имя и передаст соединение профилю со списком сайтов. Порядок выбора и пересмотр подробно разобраны в заметке о фильтрах профиля.

Включение и исключение: что важнее чего

У профиля может быть несколько включающих списков (--ipset, --ipset-ip) и несколько исключающих (--ipset-exclude, --ipset-exclude-ip). Движок проверяет адрес так (функция IpsetCheck_ в nfq2/ipset.c):

  1. Сначала все исключающие списки. Адрес нашёлся хотя бы в одном — профиль его не берёт.
  2. Потом включающие. Хватит совпадения в любом.
  3. Если включающих списков нет или все пустые, профиль подходит любому адресу, который не попал в исключения.
Сначала исключения, потом включения: так профиль проверяет адрес Профиль с --ipset-exclude=10.1.0.0/16 и --ipset=10.0.0.0/8,1.2.3.4. Адрес из исключений профиль не берёт, даже если он входит во включающий список. Адрес вне включающего списка профиль тоже не берёт. Остальные профили проверяются дальше. условия профиля 1. исключения--ipset-exclude = 10.1.0.0/16 2. включения--ipset = 10.0.0.0/8, 1.2.3.4 адрес сервера 10.5.6.7 ✕ нет ✓ входит в 10.0.0.0/8 профиль берёт соединение 10.1.2.3 ✓ входит в 10.1.0.0/16 профиль НЕ берёт: исключение сильнее, хотя адрес есть и в 10.0.0.0/8 1.2.3.4 ✕ нет ✓ точное совпадение профиль берёт соединение 8.8.8.8 ✕ нет ✕ нет профиль НЕ берёт: адреса нет во включающем списке Адрес сервера известен с первого пакета соединения, поэтому решение по списку адресовпринимается сразу, ещё до того, как движок узнает имя сайта. Если файлов несколько, хватитсовпадения в любом.

Пример с анимации в виде строк пресета:

--ipset-exclude-ip=10.1.0.0/16
--ipset-ip=10.0.0.0/8,1.2.3.4
Адрес сервераИтог
10.5.6.7профиль берёт: входит в 10.0.0.0/8, в исключения не попал
10.1.2.3профиль не берёт: входит в исключённую 10.1.0.0/16, хотя есть и в 10.0.0.0/8
1.2.3.4профиль берёт: точное совпадение
8.8.8.8профиль не берёт: нет во включающем списке

Если профиль адрес не взял, соединение проверяют следующие профили пресета сверху вниз.

ipset и hostlist в одном профиле

Условия одного профиля объединяются логикой «И»: должны совпасть все. Поэтому профиль с --ipset и --hostlist сразу сработает, только если и адрес сервера в списке адресов, и имя сайта в списке сайтов. Проверяются они по порядку: сначала адреса, потом сайты.

Чаще встречается другая связка — широкий профиль только с исключениями:

--name=Все сайты (айпи)
--filter-tcp=80,443
--ipset-exclude=lists/ipset-ru.txt
--ipset-exclude=lists/ipset-exclude.txt

Включающего списка у него нет, поэтому он подходит любому адресу, кроме исключённых. Такой профиль ставят ниже профилей с конкретными сайтами: сначала соединение пробуют забрать они, а всё остальное уходит сюда.

Список прямо в строке

Несколько адресов можно не выносить в файл и написать через запятую прямо в пресете:

--ipset-ip=91.108.4.0/22,149.154.160.0/20
--ipset-exclude-ip=192.168.0.0/16,10.0.0.0/8

Как и у --hostlist-domains, в одном профиле такой встроенный список один каждого вида: несколько строк --ipset-ip дописывают адреса в тот же список.

Один файл — один раз в профиле

С 31 октября 2026 года (коммит abbe480) движок не разрешает подключать один и тот же файл в профиле дважды одного типа. Два --ipset с одним файлом — ошибка failed to register ipset '…', и winws2 не запускается. Один файл в --ipset и в --ipset-exclude одновременно подключить можно (это разные типы), но смысла в этом нет: исключение сильнее, и профиль не возьмёт ни один адрес из файла. Если перед ошибкой стоит строка cannot access ipset file, причина другая — файла нет на диске.

Откуда брать адреса

Крупные сервисы сами публикуют свои подсети. Например, Telegram выкладывает список своих подсетей в том же формате, что нужен ipset, а Cloudflare — диапазоны своих адресов. Для остального адреса сервера видны в журнале движка и в отчёте BlockCheck.

Слишком широкая подсеть опасна: вместе с нужным сервисом в неё попадают чужие сайты, и стратегия будет применяться и к ним. Если сайт удобнее описать именем — используйте hostlist, а ipset оставьте для случаев, где имени нет или решение нужно с первого пакета.

Как это выглядит в Zapret GUI

У профиля со списком адресов вкладка списка выглядит так же, как у списка сайтов: «Ваши записи» слева и «Встроенные записи (только просмотр)» справа. Ваши записи хранятся отдельным файлом в папке lists/user и не пропадают при обновлении. Движок получает один итоговый файл — ваши записи вместе со встроенными. Программа проверяет каждую строку: адрес или подсеть она сохранит, имя сайта или диапазон через дефис — нет и покажет, в какой строке ошибка.

Подсказка у поля и кнопка «Что это?» внизу вкладки объясняют формат и порядок проверки, а кнопки в окне справки открывают эту статью и соседние.

Некоторые списки адресов служебные: ipset-dns.txt (адреса публичных DNS-серверов вроде 1.1.1.1 и 8.8.8.8, которые широкие профили исключают из обхода) и ipset-exclude.txt программа использует сама и из интерфейса не правит.

Частые ошибки

Что написаноЧто происходитКак правильно
1.1.1.1-1.1.1.255строка пропускается: диапазонов нет1.1.1.0/24
youtube.comстрока пропускается: это не адресимя — в hostlist
0.0.0.0/0профиль подходит всем адресам IPv4укажите нужные подсети или уберите --ipset
пустой файлпрофиль подходит любому адресухотя бы одна запись или заглушка
нужный адрес и в --ipset, и в --ipset-excludeпрофиль его не берётуберите адрес из исключений
два --ipset с одним файломwinws2 не запускаетсяодна строка на файл

Справочник опций

ОпцияЧто делает
--ipset=<файл>профиль только для адресов и подсетей из файла; можно несколько файлов, хватит совпадения в любом
--ipset-ip=<адреса>то же через запятую прямо в строке; все такие строки профиля — один список
--ipset-exclude=<файл>не применять профиль к адресам из файла; проверяется раньше включающих
--ipset-exclude-ip=<адреса>то же через запятую

Источники

📚 См. также

  • hostlist — списки сайтов: поддомены, префиксы ^ и !, исключения из исключений
  • Фильтры профиля — полный порядок проверок профиля
  • Исключения — как пустить адрес или сайт мимо обхода
  • Профиль — из чего состоит профиль
  • BlockCheck — как узнать, режут ли сайт по адресу

🤖 Эти статьи открыты — можно обучать на них ИИ

При желании вы можете натренировать ИИ на наших статьях. Исходное форматирование доступно в Forgejo: исходник этой заметки · скачать весь репозиторий одним zip-архивом.