VPN Configurator

🇬🇧 English version — README_EN.md

[!IMPORTANT] Данный материал подготовлен в научно-технических целях. Использование предоставленных материалов в целях отличных от ознакомления может являться нарушением действующего законодательства. Автор не несет ответственности за неправомерное использование данного материала!

VPN Configurator — интерактивная консольная программа для создания конфигурационных файлов VPN-клиентов с раздельным туннелированием трафика, а также для конвертации и объединения файлов с IP-адресами.

Раздельное туннелирование — это режим работы VPN, при котором через VPN проходит только трафик к указанным сайтам или сервисам, а весь остальной интернет работает как обычно, без потери скорости.

Готовые наборы IP-адресов в папке ips/

В репозитории уже есть файлы с IP-адресами для следующих сервисов:

Вы можете использовать эти файлы как есть или найти дополнительные наборы по ссылкам в разделе Где взять IP-адреса.

Возможности программы

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

1. Создание конфига для Amnezia / WireSock / WireGuard На основе существующего .conf-файла VPN создаёт новый файл конфигурации с прописанными IP-адресами для раздельного туннелирования по протоколу WireGuard.

• Вариант А: через VPN идут только указанные IP-адреса
• Вариант Б: через VPN идёт весь трафик (в файл добавляется только обфускация)
• Поддерживаемые клиенты: Amnezia, WireSock, WireGuard и другие совместимые WG клиенты.

2. Создание конфига для Nekobox (Android) Создаёт конфигурационный файл .json для приложения Nekobox на Android по протоколу VLESS.

• Вариант А: через VPN идут только указанные IP-адреса, остальной трафик — напрямую
• Вариант Б: через VPN идёт весь трафик, кроме указанных IP-адресов

3. Конвертация: Amnezia → plaintext Преобразует файл с IP-адресами из формата Amnezia (.json) в обычный текстовый формат (.txt), где каждый IP — на отдельной строке.

4. Конвертация: plaintext → Amnezia Обратная конвертация — из текстового формата в формат Amnezia (.json).

5. Объединение файлов с IP-адресами Объединяет несколько файлов с IP-адресами (в формате plaintext или Amnezia) в один единый файл, автоматически убирая дубликаты.

Как запустить программу

Вариант 1 — .exe файл (Windows)

1. Скачайте файл .exe со страницы релизов: ⬇ GitHub Releases
2. Запустите скачанный файл двойным кликом — откроется консольное окно с меню программы
3. Выберите нужный пункт меню, введя его номер

Вариант 2 — файл для macOS

В отличие от Windows, на macOS двойной клик по бинарному файлу не открывает его в терминале — нужно запускать вручную через приложение Терминал (не «Консоль»).

1. Скачайте файл для вашей архитектуры со страницы релизов: ⬇ GitHub Releases

   Процессор	Файл для скачивания
   Apple M1/M2/M3/M4	vpn_configurator_vX.X.X.macos-arm64
   Intel	vpn_configurator_vX.X.X.macos-x86_64

   Не знаете какой процессор? Нажмите → «Об этом Mac» — в строке «Чип» или «Процессор» будет указано.

2. Откройте приложение Терминал (не «Консоль»)

3. Перейдите в папку со скачанным файлом:

   cd ~/Downloads

4. Дайте файлу разрешение на запуск (подставьте имя скачанного файла):

   chmod +x vpn_configurator_vX.X.X.macos-arm64

5. Запустите программу:

   ./vpn_configurator_vX.X.X.macos-arm64

Вариант 3 — Python-скрипт

Если у вас установлен Python 3.10 или выше, можно запустить исходный скрипт напрямую.

1. Клонируйте или скачайте этот репозиторий

2. Откройте терминал в папке с проектом и выполните команды по очереди:

   Windows:

   python -m venv venv
   venv\Scripts\activate
   pip install -r requirements.txt
   python vpn_configurator.py

   macOS / Linux:

   python3 -m venv venv
   . venv/bin/activate
   pip3 install -r requirements.txt
   python3 vpn_configurator.py

Как устроена программа

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

Импорт конфигурации в приложение

Amnezia (Windows / Android)

1. Нажмите на иконку + на главном экране приложения
2. Выберите пункт «Файл с настройками подключения»
3. Укажите путь к сгенерированному .conf файлу
4. Если приложение предложит включить обфускацию — обязательно согласитесь
5. Нажмите «Подключиться»

Готово — профиль создан и готов к использованию!

WireGuard / WireSock (Windows)

Откройте приложение WireGuard (или WireSock) и импортируйте сгенерированный .conf файл через меню «Добавить туннель из файла».

Nekobox (Android)

1. Перейдите на страницу «Конфигурации» в приложении Nekobox
2. Нажмите на иконку файл+
3. Выберите «Импорт из файла»
4. Укажите путь к сгенерированному .json файлу

Готово — профиль создан и готов к использованию!

Где взять IP-адреса

Готовые наборы уже есть в папке ips/. Если нужны дополнительные сервисы, воспользуйтесь этими ресурсами:

• Разные коллекции IP-адресов (gist)
• IP-адреса в формате Amnezia (gist)
• Сайт с диапазонами IP-адресов 1
• Сайт с диапазонами IP-адресов 2
• iplist.opencck.org
• antifilter.download
• IP-адреса Discord
• Глобальные IP-адреса (RockBlack-VPN)

Полезные ссылки

• Amnezia VPN — VPN-клиент с поддержкой обфускации для Windows, macOS, Android, iOS
• WireSock VPN Client — WireGuard-клиент для Windows с поддержкой раздельного туннелирования
• WireGuard — официальный клиент WireGuard для Windows
• Nekobox для Android — прокси-клиент для Android с поддержкой VLESS
• Nekobox для Windows / Linux / macOS — десктопная версия прокси-клиента с поддержкой VLESS