amnezia-app-ru-list

KO | EN

gitlite — search

#javascript #python #react #ai #typescript #android #rust #deep-learning #docker #nodejs #pytorch #ios #openai #open-source

amnezia-app-ru-list

(★ 34)

Автоматически генерируемый список IP-адресов и доменов российских сервисов для split tunneling для Amnezia.

amnezia-app-ru-list 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Python](https://img.shields.io/badge/python-3670A0?style=for-the-badge&logo=python&logoColor=ffdd54)
[![Update](https://img.shields.io/github/actions/workflow/status/pincetgore/amnezia-app-ru-list/update.yml?style=for-the-badge&logo=github&label=UPDATE)](https://github.com/pincetgore/amnezia-app-ru-list/actions/workflows/update.yml)
![Tests](https://img.shields.io/badge/Unit_Tests-Passing-brightgreen?style=for-the-badge)
![Data Source](https://img.shields.io/badge/Data_Source-RIPE_NCC_API-ea580c?style=for-the-badge)
[![License](https://img.shields.io/badge/LICENSE-MIT-F6C25B?style=for-the-badge&logo=opensourceinitiative&logoColor=white&labelColor=555555)](https://raw.githubusercontent.com/pincetgore/amnezia-app-ru-list/main/)
<p align="center">
  <a href="https://yoomoney.ru/to/4100119554027650">
    <img src="https://img.shields.io/badge/Поддержать-ЮMoney-8B3FFD?style=for-the-badge&logo=yoomoney&logoColor=white" alt="Поддержать" />
  </a>
</p>

## ⚠️ Юридическая информация

> **Этот проект создан исключительно в ознакомительных и исследовательских целях.**
>
> **Никакие материалы этого проекта не являются призывом к нарушению законов.**

# Оглавление
- [Описание проекта](#описание-проекта)
  - [Источники данных](#источники-данных)
  - [Включённые сервисы](#включённые-сервисы)
  - [Автообновление](#автообновление)
  - [Тесты](#тесты)
- [Инструкция по применению](#инструкция-по-применению)
  - [Получение актуального списка](#получение-актуального-списка)
  - [Настройка приложения AmneziaVPN](#настройка-приложения-amneziavpn)
- [FAQ (Частые вопросы)](#faq-частые-вопросы)
- [Как помочь проекту](#как-помочь-проекту)
- [Локальное развертывание](#локальное-развертывание)
  - [Добавление нового сервиса](#добавление-нового-сервиса)
  - [Ручной запуск тестов](#ручной-запуск-тестов)
  - [Структура проекта](#структура-проекта)
  - [Параметры CLI](#параметры-cli)

# Описание проекта

Автоматически генерируемый список IP-адресов и доменов российских сервисов для **split tunneling** для Amnezia.

Трафик к сервисам из списка идёт **напрямую**, минуя VPN. Всё остальное (включая заблокированные ресурсы) продолжает идти через VPN.

```
           Ваше устройство
┌──────────────────────────────────┐
│        Браузер / Приложение      │
│                │                 │
│                ▼                 │
│  ┌───────────────────────────┐   │
│  │         AmneziaVPN        │   │
│  │  Раздельное тунелирование │   │
│  └─────┬───────────────┬─────┘   │
│        │               │         │
│     Совпало с     Не совпало c   │
│   ip-list.json    ip-list.json   │
│        │               │         │
│        ▼               ▼         │
│    Напрямую        Через VPN     │
│ (Сбербанк, РЖД,   (Telegram,     │
│    WB и др.)     Youtube и др.)  │
└──────────────────────────────────┘
```

---

## Источники данных

1. **RIPE NCC API** (основной) — все анонсированные IPv4-префиксы по ASN организации. Используется **автоматический retry** с экспоненциальным backoff: до 3 повторных запросов (до 4 суммарных попыток) для устойчивости к временным сетевым сбоям.
2. **DNS A-записи** (дополнительный) — многопоточный резолвинг доменов (в первую очередь через DNS-серверы Яндекса) для сервисов без выделенного ASN
3. **bgp.he.net** (fallback) — если RIPE API исчерпал все retry попытки или вернул пустой результат (извлекает CIDR с помощью BeautifulSoup)
4. **Статические подсети и IP-адреса (ip_ranges)** — явно заданные в конфигурации диапазоны

Скрипт собирает CIDR-диапазоны через ASN, дополняет их IP-адресами из DNS и статическими правилами, агрегирует (убирает дубли и вложенные подсети) и формирует в виде `ip-list-<день-месяц-год_время>.json` (в формате AmneziaVPN) и `cidrs-<день-месяц-год_время>.txt` (простой список префиксов).

Готовые файлы обновляются ежедневно и автоматически публикуются на странице **Releases**.

### Конфигурация DNS

DNS-резолвинг настраивается в блоке `dns:` файла `config.yaml`:

```yaml
dns:
  # DNS серверы для резолвинга доменов (порядок приоритета)
  nameservers:
    - 77.88.8.8        # Яндекс.DNS (основной)
    - 77.88.8.1        # Яндекс.DNS (резервный)
    - 8.8.8.8          # Google DNS (fallback)
    - 1.1.1.1          # Cloudflare DNS (fallback)
  
  # Таймаут для резолвинга (секунды)
  timeout: 10
  
  # Максимальное количество параллельных DNS запросов
  max_workers: 20
```

Это позволяет гибко менять DNS-сервера и параметры резолвинга без изменения кода скрипта. Если указаны, `nameservers` должен быть непустым списком IPv4-адресов, а `timeout` и `max_workers` — положительными числами.

### Ограничения

* **Только IPv4**: В данный момент скрипт собирает и агрегирует только IPv4-адреса. IPv6-префиксы игнорируются для совместимости.

## Включённые сервисы

### Локальные и служебные сети

| Сервис | IP-диапазоны | Домены |
| ------ | ------ | ------ |
| Локальные сети (LAN, CGNAT, Multicast) | `10.0.0.0/8`, `100.64.0.0/10`, `169.254.0.0/16` и др. | — |

### IP и GEO чеккеры

| Сервис | Домены |
| ------ | ------ |
| Проверка IP на признак включения VPN | `2ip.io`, `51degrees.com`, `abstractapi.com`, `apiip.net` и др. |

### Бигтех и супераппы

| Сервис | ASN | Домены |
| ------ | ------ | ------ |
| Яндекс | AS13238, AS44534 и др. | `afisha.yandex.ru`, `alice.yandex.ru`, `api.kinopoisk.ru`, `api.music.yandex.net` и др. |
| VK | AS28709, AS47541 и др. | `cloud.vk.com`, `mcs.mail.ru`, `mvk.com`, `userapi.com` и др. |
| Mail.ru + Одноклассники | AS47764, AS49797 и др. | `biz.mail.ru`, `cloud.mail.ru`, `e.mail.ru`, `games.mail.ru` и др. |

### Банки и Финтех

| Сервис | ASN | Домены |
| ------ | ------ | ------ |
| Сбербанк | AS33844, AS35237 и др. | `online.sberbank.ru`, `sber-zvuk.com`, `sber.ru`, `sberbank.com` и др. |
| Т-Банк | AS205638, AS12686 и др. | `api.t-bank-app.ru`, `api.tinkoff.ru`, `as.t-bank-app.ru`, `cdn.t-bank-app.ru` и др. |
| ВТБ | AS24823, AS39154 и др. | `invest.vtb.ru`, `online.vtb.ru`, `vtb-group.ru`, `vtb.ru` и др. |
| Альфа-Банк | AS15632, AS34838 и др. | `alfa.me`, `alfabank.com`, `alfabank.ru`, `alfadirect.ru` и др. |
| Газпромбанк | AS35022, AS48033 и др. | `gazprombank.ru`, `gpb.ru` |
| Россельхозбанк | AS41615 | `online.rshb.ru`, `rshb.ru` |
| Промсвязьбанк | — | `ib.psbank.ru`, `psb.ru`, `psbank.ru` |
| Совкомбанк | AS51136, AS197258 и др. | `halvacard.ru`, `sovcombank.ru` |
| Райффайзен Банк | — | `online.raiffeisen.ru`, `raiffeisen.ru` |
| Московский Кредитный Банк | AS39267, AS50464 и др. | `mkb.ru`, `online.mkb.ru` |
| Открытие | AS5589 | `open.ru` |
| Росбанк | — | `rosbank.ru` |
| Банк Россия | AS50640, AS196796 и др. | `abr.ru` |
| ЮMoney | AS43247 | `yookassa.ru`, `yoomoney.ru` |
| СБП / НСПК | AS21292, AS41185 и др. | `nspk.ru`, `sbp.nspk.ru` |
| Wildberries Банк | — | `wb-bank.ru` |
| МТС Банк | — | `dbo-dengi.online`, `mtsbank.ru`, `mtsdengi.ru`, `tvoyodbo.online` |
| Ozon банк | — | `ozonbank.ru` |
| Мосбиржа | AS48009 | `moex.com` |
| Яндекс Банк / Яндекс Пэй | — | `bank.yandex.ru`, `pay.yandex.ru` |

### Телеком и связь

| Сервис | Домены |
| ------ | ------ |
| МТС | `api.mts.ru`, `id.mts.ru`, `login.mts.ru`, `mts.me` и др. |
| МегаФон | `api.megafon.ru`, `id.megafon.ru`, `lk.megafon.ru`, `megafon.ru` и др. |
| Билайн | `api.beeline.ru`, `beeline.ru`, `id.beeline.ru`, `lk.beeline.ru` и др. |
| Теле2 | `b2c-digest.ru`, `my.tele2.ru`, `t2.com`, `t2.ru` и др. |
| Ростелеком | `lk.rt.ru`, `rostelecom.ru`, `rt.ru` |
| Дом.ру | `domru.ru`, `ertelecom.ru`, `lk.domru.ru` |

### E-commerce и маркетплейсы

| Сервис | ASN | Домены |
| ------ | ------ | ------ |
| Wildberries | AS49053, AS57073 и др. | `digital.wildberries.ru`, `seller.wildberries.ru`, `wb.ru`, `wbstatic.net` и др. |
| Ozon | AS207986, AS44386 | `ozon.app`, `ozon.com`, `ozon.dev`, `ozon.ru` и др. |
| Авито | AS201012 | `avito.com`, `avito.ru`, `avito.st`, `m.avito.ru` и др. |
| СберМегаМаркет | — | `megamarket.ru`, `sbermegamarket.ru` |
| Lamoda | AS57906 | `lamoda.co`, `lamoda.ru` |
| DNS Shop | — | `dns-shop.net`, `dns-shop.ru` |
| М.Видео / Эльдорадо | — | `eldorado.ru`, `mvideo.ru` |
| Ситилинк | — | `citilink.ru` |
| Леруа Мерлен | — | `lemanapro.ru` |
| Золотое Яблоко | — | `api.goldapple.ru`, `gacdn.ru`, `goldapple.ru`, `juicyscore.ru` и др. |
| Детский мир | — | `catalog-cdn.detmir.st`, `detmir.ru`, `go.detmir.st`, `img.detmir.st` |
| Hoff | — | `hoff.ru` |
| Aliexpress | — | `alicdn.com`, `aliexpress.ru`, `api.aliexpress.ru`, `static.alicdn.com` |

### Доставка и логистика

| Сервис | Домены |
| ------ | ------ |
| Купер (бывш. СберМаркет) | `api.kuper.ru`, `kuper.ru` |
| Самокат | `api.samokat.ru`, `cdn.samokat.ru`, `cm.samokat.ru`, `samokat.ru` |
| Delivery Club | `dclub.ru`, `delivery-club.ru` |
| СДЭК | `ad-cdek.ru`, `cdek.ru`, `cdek.shopping`, `lk.cdek.ru` |
| Boxberry | `boxberry.ru` |
| Деловые Линии | `dellin.ru` |

### Ритейл и продукты

| Сервис | ASN | Домены |
| ------ | ------ | ------ |
| Пятёрочка / X5 Group | AS215810, AS44704 | `5ka.ru`, `chizhik.club`, `chizhik.ru`, `myapelsin.ru` и др. |
| Магнит | — | `dostavka.magnit.ru`, `magnit.app`, `magnit.com`, `magnit.ru` |
| Лента | — | `lenta.com`, `online.lenta.com` |
| Metro Cash and Carry | — | `api.metro-cc.ru`, `metro-cc.ru`, `online.metro-cc.ru` |
| FixPrice | — | `fix-price.com`, `fix-price.ru` |
| Дикси | AS202760 | `dixy.ru` |
| ВкусВилл | — | `api-sd.vkusvill.ru`, `api.vkusvill.ru`, `app.vkusvill.ru`, `cdn-mobile-backend.vkusvill.ru` и др. |
| SPAR | — | `api.myspar.ru`, `app.myspar.ru`, `myspar.ru` |
| Rendez-vous | — | `api.rendez-vous.ru`, `rendez-vous.ru` |
| One Price Coffee | — | `api.onepricecoffee.com`, `cloud.onepricecoffee.com`, `delivery.onepricecoffee.com`, `onepricecoffee.com` |
| Best Benefits | — | `app.bestbenefits.ru`, `bestbenefits.ru`, `mobile.bestbenefits.ru` |
| Зоозавр | — | `api.new1.zoozavr.ru`, `api.zoozavr.ru`, `blog.zoozavr.ru`, `feedback.zoozavr.ru` и др. |

### Стриминг, видео и музыка

| Сервис | ASN | Домены |
| ------ | ------ | ------ |
| Rutube | AS207353 | `pic.rutube.ru`, `rutube.ru`, `static.rutube.ru` |
| IVI | — | `api.ivi.ru`, `images.ivi.ru`, `ivi.ru`, `ivi.tv` |
| Okko | — | `api.okko.tv`, `okko.tv` |
| KION | — | `kion.ru`, `kion.tv` |
| Wink | — | `wink.ru`, `wink.tv` |
| START | — | `start.ru`, `start.video` |
| Premier | — | `premier.one` |
| Звук (Сбер) | — | `zvuk.com`, `zvuk.ru` |

### Государственные сервисы

| Сервис | ASN | Домены |
| ------ | ------ | ------ |
| Госуслуги | AS196747, AS48287 и др. | `esia.gosuslugi.ru`, `gosuslugi.ru`, `gu-st.ru`, `lk.gosuslugi.ru` и др. |
| ФНС / Налоговая | — | `ebs.ru`, `goskey.ru`, `gov.ru`, `lkfl2.nalog.ru` и др. |
| СФР / Социальный фонд России | — | `pfr.gov.ru`, `sfr.gov.ru` |
| ЕИС Закупки | — | `zakupki.gov.ru` |
| Мос.ру | AS8901 | `mos.ru`, `mosreg.ru`, `my.mos.ru`, `uslugi.mos.ru` |
| ЦБ РФ | — | `cbr.ru`, `finmarket.ru` |
| Почта России | — | `mobileapp.russianpost.ru`, `pochta.ru`, `tracking.pochta.ru` |
| Честный знак | — | `xn--80ajghhoc2aj1c8b.xn--p1ai` |

### Транспорт, авто и каршеринг

| Сервис | ASN | Домены |
| ------ | ------ | ------ |
| РЖД | AS20702 | `cargo.rzd.ru`, `pass.rzd.ru`, `rzd-bonus.ru`, `rzd.ru` и др. |
| Аэрофлот | — | `aeroflot.ru`, `api.aeroflot.ru` |
| S7 Airlines | — | `s7.ru` |
| Победа | — | `pobeda.aero` |
| Уральские авиалинии | — | `uralairlines.ru` |
| Aviasales | — | `aviasales.com`, `aviasales.ru` |
| Tutu.ru | — | `tutu.ru` |
| Островок | — | `api.ostrovok.ru`, `ostrovok.ru` |
| Суточно.ру | — | `sutochno.ru` |
| Московский метрополитен | — | `mosmetro.ru`, `wi-fi.ru` |
| Тройка | — | `transport.mos.ru`, `troika.mos.ru` |
| Авто.ру | — | `auto.ru` |
| Drom.ru | — | `auto.drom.ru`, `drom.ru` |
| Автотека | — | `autoteka.ru` |
| Автодор | AS20698 | `avtodor-tr.ru` |
| Делимобиль | — | `api.delimobil.ru`, `delimobil.com`, `delimobil.ru` |
| Ситидрайв / Ситимобил | — | `city-mobil.ru`, `citydrive.ru` |
| Drivee | — | `drivee.ru` |
| Uber Russia | — | `uber.ru` |

### Недвижимость

| Сервис | Домены |
| ------ | ------ |
| ЦИАН | `api.cian.ru`, `cian.ru` |
| Домклик | `api.domclick.ru`, `domclick.ru` |
| ДомРФ | `domrf.ru` |

### Работа, HR и бизнес (ЭДО)

| Сервис | ASN | Домены |
| ------ | ------ | ------ |
| HeadHunter | AS47724, AS59601 | `api.hh.ru`, `headhunter.ru`, `hh.ru` |
| SuperJob | — | `superjob.ru` |
| Работа.ру | — | `rabota.ru` |
| Хабр | — | `career.habr.com`, `habr.com` |
| Профи.ру | AS60580 | `profi.ru` |
| ЭДО и Бизнес (Контур, СБИС, 1С) | — | `1c.ru`, `b2b-center.ru`, `cryptopro.ru`, `diadoc.ru` и др. |

### Карты и навигация

| Сервис | ASN | IP-диапазоны | Домены |
| ------ | ------ | ------ | ------ |
| 2ГИС | AS197482 | `91.236.48.0/22`, `91.221.198.0/23`, `91.236.49.0/24` и др. | `2gis.com`, `2gis.dev`, `2gis.ru`, `api.2gis.ru` и др. |

### Образование

| Сервис | Домены |
| ------ | ------ |
| Яндекс Практикум | `practicum.yandex.ru` |
| Skillbox | `skillbox.ru` |
| GeekBrains | `gb.ru`, `geekbrains.ru` |
| Нетология | `netology.ru` |
| Skyeng | `skyeng.ru`, `student.skyeng.ru` |

### Медицина и здоровье

| Сервис | ASN | Домены |
| ------ | ------ | ------ |
| СберЗдоровье | — | `doctoronline.ru`, `sberhealth.ru` |
| Аптека.ру | — | `apteka.ru` |
| Еаптека | — | `eapteka.ru` |
| Аптеки Столички | — | `api.stolichki.ru`, `stolichki.ru` |
| ЕМИАС | — | `emias.info`, `emias.ru`, `lk.emias.mos.ru`, `mgfoms.ru` и др. |
| Invitro | — | `invitro.ru`, `lk.invitro.ru` |
| Медси | — | `medsi-premium.ru`, `medsi.com`, `medsi.pro`, `medsi.ru` и др. |
| АГНИ | — | `beauty-forma.com`, `lk-dev.beauty-forma.com`, `lk.beauty-forma.com`, `shop.beauty-forma.com` |
| Аптека Вита | AS42996 | `autodiscover.vitaexpress.ru`, `blog.vitaexpress.ru`, `cloud.vitaexpress.ru`, `mailimage.vitaexpress.ru` и др. |

### Страхование

| Сервис | ASN | Домены |
| ------ | ------ | ------ |
| Ингосстрах | — | `ingos.ru` |
| РЕСО | AS39266 | `agent.reso.ru`, `j7h6i8.reso.ru`, `lms.reso.ru`, `reso.ru` и др. |

### Мессенджеры и игры

| Сервис | Домены |
| ------ | ------ |
| TenChat | `tenchat.ru` |
| MAX | `apptracer.ru`, `max.ru`, `mycdn.me` |
| VK Play | `api.vkplay.ru`, `vkplay.ru` |
| MY.GAMES | `api.my.games`, `my.games` |

### Облака и хостинги

| Сервис | ASN | Домены |
| ------ | ------ | ------ |
| Selectel | — | `selectel.ru` |
| REG.RU | — | `reg.ru` |
| Timeweb | AS51115 | `timeweb.cloud` |
| Ngenix.net | AS34879, AS204878 и др. | `ngenix.net` |

### Прочее

| Сервис | ASN | Домены |
| ------ | ------ | ------ |
| Литрес | — | `litres.ru` |
| Kaspersky | AS200187 | `kaspersky.com`, `kaspersky.ru` |
| Dreamehome | AS137280 | `dreametech.com`, `ru.dreametech.com`, `ru.iot.dreame.tech`, `smarthome.dreame.tech` |
| Мой умный дом (Уфанет) | — | `dom.ufanet.ru`, `secretapi.ufanet.ru`, `ufanet.ru`, `ufanetgroup.com` |
| kojima.ru | — | `kojima.ru` |
| yclients | — | `api.yclients.com`, `app.yclients.com`, `assets.yclients.com`, `b1.yclients.com` и др. |

## Автообновление

GitHub Actions workflow запускается **ежедневно в 04:00 UTC** и автоматически:
1. Прогоняет **35 тестов** (`pytest`), включая проверки конфигурации, атомарной записи файлов и unit-тесты ASN/DNS-резолверов с мокированием API.
2. Запрашивает актуальные данные из RIPE API (с автоматическим retry и exponential backoff) и многопоточно резолвит DNS.
3. Генерирует `ip-list.json` (для Amnezia) и `cidrs.txt` (простой список) с подробной статистикой.
4. Выводит список проблемных доменов, которые не удалось зарезолвить.
5. Создаёт/обновляет релиз и загружает в него сгенерированные файлы только при успешном сборе всех данных.

## Тесты

В проекте настроено автоматическое тестирование с помощью фреймворка `pytest`. Тесты защищают проект от публикации сломанных списков маршрутизации из-за опечаток в конфиге или сбоев логики.

**Что проверяется:**
1. **Агрегация IP-сетей**: алгоритм схлопывания подсетей (например, поглощение мелкой `10.1.0.0/16` более крупной `10.0.0.0/8`).
2. **Структура `config.yaml`**:
   - Конфиг является валидным словарем и содержит базовый ключ `services`.
   - У каждого добавленного сервиса есть обязательное поле `name`.
   - У сервиса обязательно присутствует хотя бы одно из полей `asn`, `domains` или `ip_ranges`.
   - В полях `asn` содержатся строго числовые значения.
3. **Валидность доменов**: в списке доменов нет частых опечаток:
   - Отсутствует префикс протокола (например, `http://` или `https://`).
   - Отсутствует закрывающий слеш (`/`) на конце.
   - Нет случайных пробелов внутри строки.
   - Не используются неподдерживаемые wildcard-записи (`*.domain.com`).
4. **Уникальность записей**: во всем `config.yaml` отсутствуют дубликаты:
   - Домены не повторяются в разных сервисах.
   - ASN уникальны (предотвращает лишние запросы к RIPE API).
   - Статически заданные `ip_ranges` не дублируются.

### Unit-тесты резолверов (22 теста в `test_resolvers.py`)
Тесты используют мокирование API (`unittest.mock`) для быстрого и надежного выполнения без зависимости от внешних сервисов:

1. **Резолвер ASN** (`resolvers/asn.py`):
   - Успешный парсинг ответов RIPE NCC API (включая фильтрацию IPv6).
   - Fallback на bgp.he.net при сбое или пустом ответе RIPE (включая проверку извлечения с помощью BeautifulSoup).
   - Обработка сетевых ошибок и пустых результатов.
   - Проверка retry логики с exponential backoff.
   - Нормализация входных форматов ASN (целые числа, строки вида "AS12345").
2. **Резолвер DNS** (`resolvers/dns.py`):
   - Успешный резолвинг доменов и создание `/32` сетей.
   - Поддержка множественных A-записей для одного домена.
   - Кастомные DNS-серверы и таймауты.
   - Параллельный резолвинг с ThreadPoolExecutor.
3. **Агрегация сетей**:
   - Создание и корректность IPv4Network объектов.
   - Правильность работы функции `collapse_addresses()`.

# Инструкция по применению

## Получение актуального списка

1. Перейдите на страницу **Releases**.
2. Скачайте нужный файл из последнего релиза:
   * `ip-list-<день-месяц-год_время>.json` — для импорта в приложение AmneziaVPN.
   * `cidrs-<день-месяц-год_время>.txt` — простой текстовый список сетей в формате CIDR (по одному префиксу на строку). Подходит для настройки маршрутизации в других VPN-клиентах (v2ray, sing-box, Xray), сторонних утилитах, брандмауэрах (например, iptables) или на домашних роутерах (OpenWrt, Keenetic и др.).

## Настройка приложения AmneziaVPN

В приложении AmneziaVPN для iOS, MacOS и Linux раздельное тунелирование возможно только по IP-адресам.

В приложении AmneziaVPN для Android и Windows доступно два механизма раздельного туннелирования - как по IP-адресам, так и по приложениям. **Рекомендуется настроить оба метода одновременно:** исключение по IP-адресам — для браузеров, а исключение приложений — для мобильных и десктопных клиентов и приложений.

### Способ А: По IP-адресам (для iOS и macOS)

Этот метод направляет трафик к нужным IP-адресам в обход VPN.

1. Откройте **AmneziaVPN** и перейдите в **Настройки** соединения.
2. Откройте **Раздельное туннелирование сайтов**.
3. Выберите режим: **«Адреса из списка НЕ должны открываться через VPN»**.
4. Нажмите на **«⋮»** (три точки в правом верхнем углу) ➔ **Импорт**.
5. Выберите скачанный файл `ip-list-<день-месяц-год_время>.json`.
6. Готово! Маршруты загружены в список исключений.

### Способ Б: По приложениям (для Android и Windows)

Этот метод направляет трафик приложений в обход VPN.
1. В **Настройках** перейдите в **Раздельное туннелирование приложений**.
2. Выберите режим: **«Выбранные приложения НЕ должны открываться через VPN»**.
3. Добавьте в список программы, которые конфликтуют с VPN:
   * **Банки:** Сбербанк, ВТБ, Т-Банк, Альфа-Банк и т.д.
   * **Маркетплейсы:** Wildberries, Ozon, Авито.
   * **Транспорт:** РЖД, Аэрофлот, Яндекс Go, 2ГИС.
   * **Прочее:** Госуслуги, Налоги ФНС.

> ⚠️ **Важно:** Многие российские приложения на Android (банки, маркетплейсы, Госуслуги) определяют VPN через системные API, просто проверяя наличие виртуального сетевого интерфейса. Маршрутизация по IP здесь не поможет — приложение увидит включенный VPN и заблокирует доступ. Для таких случаев нужно исключать приложение целиком. 
>
> ⚠️ **Уязвимость в Android 16:** В операционной системе Android 16 присутствует критическая уязвимость раздельного тунелирования. Даже если приложение добавлено в исключения и его трафик по умолчанию идет напрямую, оно может принудительно направить свой запрос через сетевой интерфейс VPN (обычно он называется tun0). Вся актуальная информация и статус исправления проблемы обсуждаются в официальном трекере: [AmneziaVPN issue #2457](https://github.com/amnezia-vpn/amnezia-client/issues/2457).

---

# FAQ (Частые вопросы)

**Q: Сервис есть в списке, но он всё равно не работает при включенном VPN. Что делать?**  
**A:** Сервис мог добавить новые серверы, перейти на другой CDN или использовать неявные API-домены. Списки автообновляются ежедневно, попробуйте скачать свежую версию из релизов. Если проблема сохраняется, создайте Issue с описанием или Pull Request с недостающими данными.

**Q: Почему на Android появляется предупреждающий знак ⚠️ рядом с ключом VPN?**  
**A:** Это ограничение ОС Android — таблица маршрутизации переполняется из-за слишком большого количества IP-подсетей. Рекомендуется использовать встроенный механизм раздельного туннелирования «по приложениям» (Способ Б в инструкции) для клиентов банков и маркетплейсов, а маршрутизацию по IP оставить только для браузеров.

**Q: Возможны ли утечки данных о VPN с использованием конфига?**  
**A:** На Android 16 да. Читайте выше информацию о критической уязвимости в системе.

**Q: Планируется ли поддержка IPv6?**  
**A:** В данный момент нет. Скрипт отфильтровывает IPv6-префиксы, так как многие VPN-клиенты и мобильные провайдеры работают с раздельной IPv6-маршрутизацией нестабильно.

**Q: Можно ли использовать эти списки на домашних роутерах (Keenetic, OpenWrt и др.)?**  
**A:** Да! Специально для этого генерируется файл `cidrs-<день-месяц-год_время>.txt` (по одному префиксу на строку). Его легко интегрировать в скрипты статической маршрутизации, `ipset` или настройки брандмауэра вашего роутера.

---

# Как помочь проекту

Нашли неработающий российский сервис или знаете, какие IP-диапазоны/домены можно добавить? Буду рад вашим Pull Request-ам!

1. Сделайте форк репозитория.
2. Добавьте сервис или внесите исправления в файл `config.yaml`.
3. Убедитесь, что тесты проходят (см. ниже).
4. Откройте Pull Request с описанием добавленного ресурса.

> [!TIP]
> **Хотите поддержать проект?**
> Если вам помогает этот список и вы хотите поддержать его развитие (оплату серверов обновлений и чашечку кофе для автора), вы можете сделать донат по кнопке ниже:
> 
> [![Поддержать проект](https://img.shields.io/badge/Поддержать_проект-ЮMoney-8B3FFD?style=for-the-badge&logo=yoomoney&logoColor=white)](https://yoomoney.ru/to/4100119554027650)

# Локальное развертывание

**Требования:** Python 3.11+

Клонируйте репозиторий и выполните следующие команды:

```bash
git clone https://github.com/pincetgore/amnezia-app-ru-list.git
cd amnezia-app-ru-list

# Установка зависимостей (версии зафиксированы для совместимости)
pip install -r requirements.txt

# Генерация списка IP-адресов
python main.py
```

Результат будет файл `ip-list.json`, который находится в текущей директории.

Все зависимости зафиксированы в `requirements.txt` для гарантии совместимости:
- `requests==2.34.2` — HTTP-клиент с поддержкой retry логики
- `dnspython==2.8.0` — DNS-резолвер
- `pyyaml==6.0.3` — парсер YAML-конфигов
- `tqdm==4.69.0` — прогресс-бар
- `pytest==9.1.1` — фреймворк для тестирования
- `beautifulsoup4==4.15.0` — HTML-парсер для извлечения данных с bgp.he.net

## Добавление нового сервиса

Добавьте запись в файл `config.yaml`:

```yaml
  - name: "Название сервиса"
    asn:
      - 12345          # ASN можно найти на https://bgp.he.net
    domains:
      - example.ru     # Домены для DNS-резолвинга
      - api.example.ru
    ip_ranges:         # (Опционально) Статические подсети или IP-адреса
      - 192.0.2.0/24
```

Если ASN неизвестен или сервис использует облачный хостинг, оставьте `asn: []` — будут использованы только DNS A-записи.

Затем выполните команду:

```bash
python main.py
```

## Ручной запуск тестов

Выполните команду для запуска всех 35 тестов:

```bash
pytest -v
```

Для запуска проверок конфигурации и форматирования (13 тестов):

```bash
pytest test_logic.py -v
```

Для запуска только unit-тестов резолверов (22 теста):

```bash
pytest test_resolvers.py -v
```

Для запуска конкретного теста (например, параметризованный тест проверки дубликатов):

```bash
pytest test_logic.py::test_no_duplicates_config -v
```

**Примечание:** Конфигурационные тесты используют `@pytest.mark.parametrize` для проверки дубликатов ASN и IP ranges, поэтому они расходятся на несколько вариантов в выводе.

## Структура проекта

```
.
├── main.py                 # Основной скрипт (загрузка, резолвинг, агрегация)
├── config.yaml             # Конфигурация сервисов и DNS параметры
├── requirements.txt        # Python зависимости (версии зафиксированы)
├── .gitignore              # Исключение артефактов (кэши, IDE, build)
├── test_logic.py           # 6 конфигурационных тестов
├── test_resolvers.py       # 18 unit-тестов для резолверов (с мокированием)
├── resolvers/
│   ├── asn.py              # RIPE API → IPv4 префиксы (bs4 fallback на bgp.he.net)
│   └── dns.py              # DNS A-записи → /32 сети (параллельно)
└── output/
    └── formatter.py        # JSON/plain форматирование + агрегация CIDR
```

### Описание ключевых файлов

- **main.py** — оркестратор: загружает конфиг, вызывает резолверы, пишет результат. Обрабатывает SIGINT для graceful shutdown.
- **resolvers/asn.py** — получает IPv4-префиксы от RIPE (до 3 повторных запросов, exponential backoff). Fallback на bgp.he.net с парсингом HTML через BeautifulSoup.
- **resolvers/dns.py** — многопоточный резолвинг доменов (до 20 параллельных работников). Использует настраиваемые DNS серверы и возвращает предупреждение для любого неразрешённого домена, включая NXDOMAIN.
- **output/formatter.py** — агрегирует сети через `collapse_addresses()`, форматирует в JSON (AmneziaVPN) или plain (текст) и атомарно заменяет выходной файл.
- **config.yaml** — определения сервисов (ASN, домены, IP) и глобальные параметры DNS.

## Параметры CLI

| Флаг | Описание | По умолчанию |
|------|----------|--------------|
| `-o`, `--output` | Путь к выходному файлу | `ip-list.json` |
| `-f`, `--format` | Формат: `amnezia` или `plain` | `amnezia` |
| `-c`, `--config` | Путь к `config.yaml` | `config.yaml` |
| `-v`, `--verbose` | Подробный лог (debug) | выключен |

```bash
# Сгенерировать в другой файл
python main.py -o my-list.json

# Простой текстовый формат (по одному CIDR на строку)
python main.py -f plain -o cidrs.txt

# Подробный лог для отладки
python main.py -v
```

## Обработка ошибок и graceful shutdown

Скрипт имеет встроенную обработку ошибок и может быть безопасно остановлен:

- **Graceful shutdown (Ctrl+C)**: Нажатие Ctrl+C вызывает обработчик `SIGINT`, который завершает программу с кодом `130`.
- **DNS ошибки**: Любой неразрешённый домен, включая `NXDOMAIN`, логируется и выводится в итоговом списке проблемных доменов.
- **ASN ошибки**: Если RIPE API недоступен или вернул пустые данные, используется fallback на bgp.he.net (через BeautifulSoup). Если оба источника недоступны, сбор считается неуспешным.
- **Проверка целостности**: При любой ошибке ASN/DNS/статического диапазона, а также при пустом результате, скрипт завершится с кодом `1` и **не создаст выходной файл**. Это предотвращает публикацию неполного списка.
- **Валидация конфига**: До сетевых запросов проверяются структура сервисов, ASN, IPv4-диапазоны и параметры DNS.

```bash
# При ошибке скрипт возвращает exit code для CI/CD
echo $?  # Код ошибки (0 = успех, 1 = ошибка)
```

amnezia-app-ru-list

amnezia-app-ru-list 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

amnezia-app-ru-list

amnezia-app-ru-list 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README