---
date: 2026-11-01
tags:
  - zapret
  - zapret2
  - nfqws2
  - ipset
  - filter
  - profile
aliases:
  - айпсет
  - ipset в Zapret 2
  - Список IP-адресов Zapret
  - Что такое подсеть /24
  - Как исключить IP из Zapret
  - ipset-exclude
  - failed to register ipset
description: "Списки IP-адресов в Zapret 2 (ipset): что такое подсеть /24, формат файла, исключения, почему адрес решает с первого пакета — с примерами и схемами."
image: Zapret/attachments/ipset-vs-hostlist-timing.png
link: https://github.com/bol-van/zapret2/blob/master/docs/manual.md
---

> [!mirror] Резервное зеркало
> Актуальная версия этой страницы — на основной вики: [pyzluhgrnw.osjcpjzipyb.click/Zapret/ipset](https://pyzluhgrnw.osjcpjzipyb.click/Zapret/ipset)

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

![[ipset-vs-hostlist-timing.png]]

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

## TL;DR

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

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

У [[Zapret2/profile|профиля]] два способа сказать, к какому трафику он относится по месту назначения: по имени сайта ([[Zapret/hostlist|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/32` | 1 | только `1.2.3.4` |
| `1.2.3.0/24` | 256 | от `1.2.3.0` до `1.2.3.255` |
| `10.1.0.0/16` | 65 536 | от `10.1.0.0` до `10.1.255.255` |
| `10.0.0.0/8` | 16 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](https://github.com/bol-van/zapret2/blob/master/nfq2/ipset.c)):

- пробелы и табуляция в начале пропускаются;
- строка, которая начинается с `#`, `;` или `/`, — комментарий;
- запись — адрес или подсеть IPv4 либо IPv6; всё после первого пробела отбрасывается;
- строку, в которой не адрес и не подсеть, движок пропускает и пишет в журнал `bad ip or subnet`. Так пропадут и диапазон `1.1.1.1-2.2.2.2`, и имя сайта `youtube.com`;
- файл можно сжать gzip.

```text
# Telegram
91.108.4.0/22
149.154.160.0/20
2001:67c:4e8::/48
# один сервер (адрес для примера)
203.0.113.10
```

Формат описан в [руководстве движка](https://github.com/bol-van/zapret2/blob/master/docs/manual.md), раздел про хостлисты и ipset. Подсети, которые пересекаются, и повторы адресов не мешают: адрес просто входит в список. В отличие от списка сайтов, здесь нет ни префиксов `^` и `!`, ни правила «первая запись побеждает» — для адреса важно только, попал ли он хотя бы в одну подсеть файла.

> [!warning] Пустой файл — это «все адреса»
> Если в файле нет ни одной записи, движок считает, что включающего списка у профиля нет, и профиль подходит **любому адресу**. Это старое поведение, оставленное ради совместимости. Zapret GUI поэтому не оставляет список адресов пустым и дописывает в пустой список заглушку `123.123.123.123`.

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

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

Так устроен выбор профиля в функции `dp_match` ([исходник nfq2/desync.c](https://github.com/bol-van/zapret2/blob/master/nfq2/desync.c)): проверка адресов там стоит раньше проверки сайтов, а профиль со списком сайтов без известного имени сразу выбывает. Из этого следует практическое правило. Если над профилем со списком сайтов стоит профиль по адресам (или широкий профиль вообще без списков), первые пакеты соединения достанутся ему, и его стратегия успеет на них сработать. Потом движок узнает имя и передаст соединение профилю со списком сайтов. Порядок выбора и пересмотр подробно разобраны в [[Zapret2/filter#Как выбирается профиль|заметке о фильтрах профиля]].

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

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

1. **Сначала все исключающие списки.** Адрес нашёлся хотя бы в одном — профиль его не берёт.
2. **Потом включающие.** Хватит совпадения в любом.
3. Если включающих списков нет или все пустые, профиль подходит любому адресу, который не попал в исключения.

![[wiki-anim-ipset-check.svg|Анимация: профиль с исключением 10.1.0.0/16 и включением 10.0.0.0/8 и 1.2.3.4 проверяет адреса 10.5.6.7, 10.1.2.3, 1.2.3.4 и 8.8.8.8]]

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

```bash
--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` | профиль не берёт: нет во включающем списке |

Если профиль адрес не взял, соединение проверяют следующие профили [[Zapret2/preset|пресета]] сверху вниз.

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

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

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

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

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

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

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

```bash
--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](https://github.com/bol-van/zapret2/commit/abbe48056d62011d93e7a475c953535f18c5caa3)) движок не разрешает подключать один и тот же файл в профиле дважды одного типа. Два `--ipset` с одним файлом — ошибка `failed to register ipset '…'`, и winws2 не запускается. Один файл в `--ipset` и в `--ipset-exclude` одновременно подключить можно (это разные типы), но смысла в этом нет: исключение сильнее, и профиль не возьмёт ни один адрес из файла. Если перед ошибкой стоит строка `cannot access ipset file`, причина другая — файла нет на диске.

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

Крупные сервисы сами публикуют свои подсети. Например, [Telegram выкладывает список своих подсетей](https://core.telegram.org/resources/cidr.txt) в том же формате, что нужен ipset, а [Cloudflare — диапазоны своих адресов](https://www.cloudflare.com/ips/). Для остального адреса сервера видны в журнале движка и в отчёте [[Zapret/Blockcheck|BlockCheck]].

Слишком широкая подсеть опасна: вместе с нужным сервисом в неё попадают чужие сайты, и стратегия будет применяться и к ним. Если сайт удобнее описать именем — используйте [[Zapret/hostlist|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` | строка пропускается: это не адрес | имя — в [[Zapret/hostlist\|hostlist]] |
| `0.0.0.0/0` | профиль подходит всем адресам IPv4 | укажите нужные подсети или уберите `--ipset` |
| пустой файл | профиль подходит любому адресу | хотя бы одна запись или заглушка |
| нужный адрес и в `--ipset`, и в `--ipset-exclude` | профиль его не берёт | уберите адрес из исключений |
| два `--ipset` с одним файлом | winws2 не запускается | одна строка на файл |

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

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

## Источники

- [Руководство nfqws2, docs/manual.md — раздел о хостлистах и ipset](https://github.com/bol-van/zapret2/blob/master/docs/manual.md)
- [Исходник nfq2/ipset.c — разбор строки и проверка адреса](https://github.com/bol-van/zapret2/blob/master/nfq2/ipset.c)
- [Исходник nfq2/desync.c — выбор профиля (dp_match)](https://github.com/bol-van/zapret2/blob/master/nfq2/desync.c)
- [Коммит abbe480 — один файл в профиле только один раз, 31 октября 2026](https://github.com/bol-van/zapret2/commit/abbe48056d62011d93e7a475c953535f18c5caa3)
- [Telegram — список подсетей, cidr.txt](https://core.telegram.org/resources/cidr.txt)
- [Cloudflare — диапазоны IP-адресов](https://www.cloudflare.com/ips/)

## 📚 См. также

- [[Zapret/hostlist|hostlist]] — списки сайтов: поддомены, префиксы `^` и `!`, исключения из исключений
- [[Zapret2/filter|Фильтры профиля]] — полный порядок проверок профиля
- [[Zapret2/exclusions|Исключения]] — как пустить адрес или сайт мимо обхода
- [[Zapret2/profile|Профиль]] — из чего состоит профиль
- [[Zapret/Blockcheck|BlockCheck]] — как узнать, режут ли сайт по адресу

---

> [!quote] 🤖 Эти статьи открыты — можно обучать на них ИИ
> При желании вы можете натренировать ИИ на наших статьях. Исходное форматирование доступно в Forgejo: [исходник этой заметки](https://tficguhwsu.osjcpjzipyb.click/zapretdiscordyoutube/todo/src/branch/main/Zapret/ipset.md) · [скачать весь репозиторий одним zip-архивом](https://tficguhwsu.osjcpjzipyb.click/zapretdiscordyoutube/todo/archive/main.zip).
