whitelist-download

README

Автоматический агрегатор VLESS-конфигов и локальный сервер подписок.

Ваш локальный сервер конфигов

---

📖 О проекте

Скрипт предназначен для автоматического сбора бесплатных VLESS-конфигов из проверенных GitHub-репозиториев. Он объединяет тысячи серверов в одну компактную ссылку-подписку (Subscription link), которую понимает любой современный VPN-клиент. Служит локальной базой данных конфигураций.

[!IMPORTANT] 3800+ актуальных конфигураций обновляются каждый час в автоматическом режиме.

---

✨ Основные возможности

• 🔄 Web-дашборд: Отслеживайте статистику конфигов и копируйте подписку.
• 🔄 Auto-Update: Свежие конфиги каждый час без вашего участия.
• 🌐 Local Server: Поднимает HTTP-сервер на порту 55000 для раздачи подписки.
• 🪟 Windows Stealth: Автоматическая пропись в реестр и тихий запуск при старте системы.
• 🧪 Smart Filtering: Умное управление лимитами (/sub/50 или /sub/10-30), чтобы не перегружать клиент.
• 🛡️ Bypass: Эффективный обход блокировок через актуальные "белые списки".
• ⚡ Test: Проверка на работоспособность по пингу или с помощью ядра sing-box".
• ✂ Clean: Отсеивает рекламу и мусор из источников, приводя все конфигурации к единому формату".

---

⚠️ Важные примечания

[!WARNING] Ссылка на подписку иногда может не работать в мобильной версии v2RayTun.

[!CAUTION] Иногда антивирус (Windows Defender) может выдавать предупреждение при первом запуске, так как программа работает с сетью и реестром (автозагрузка).

---

🚀 Быстрый старт

1. Установка (Windows)

1. Скачайте и запустите .exe файл. Программа сама создаст нужные файлы и запустит локальный HTTP-сервер.

1. Установка (Linux)

1. В терминале рядом с файлом выполните:

      chmod +x wl-download-linux
      ./wl-download-linux

1. Запустите файл

1. Установка (MacOS)

1. Скачайте файл под архитектуру вашей системы и запустите его. Программа сама создаст нужные файлы и запустит локальный HTTP-сервер.

2. Подключение в клиент

1. Откройте app.log.
2. Скопируйте ссылку вида: http://ВАШ_IP:55000/sub/15 или отсканируйте QR-код в web-дашборде.
3. Вставьте её в ваш клиент (v2rayN, Nekobox, Hiddify, v2rayNG).

[!TIP] Если ссылка не работает, проверьте ваш IPv4-адрес в настройках сети Windows и убедитесь, что телефон и ПК находятся в одной Wi-Fi сети, а так же на телефоне выключены все VPN/VLESS (после импорта подписки их можно снова включить).

---

🛠️ Build самому (пример для Windows)

1. Скопируйте репозиторий: git clone https://github.com/rom5n/whitelist-download.git
2. Установите Go версии 26.2 или выше с официального сайта
3. Установите yarn версии 1.22.22 или выше с официального репозитория
4. Выполните:

cd whitelist-download\frontend
yarn build
cd ..\backend
go build -tags with_utls -ldflags="-s -w -H=windowsgui" -o "wl-download.exe" .

1. Запустите wl-download.exe

🌐 Web-дашборд

• Легко подключайте подписки, настраивая их лимиты
• Просматривайте статистику серверов по странам
• Просматривайте логи
• Изменяйте настройки, добавляйте источники, изменяйте название и не только!

Находится по ссылке http://localhost:55000/

⚙️ Параметры ссылки

Вы можете гибко управлять списком серверов через URL:

Ссылка	Результат
/sub	Импорт всех доступных конфигов
/sub/50	Только первые 50 штук
/sub/10-30	Начиная с 10 (включительно) взять следующие 30
/sub/united-states/10-30	Начиная с 10 (включительно) взять следующие 30 только США

---

📂 Файлы

• 📄 configs.txt — Ваша локальная база конфигов. Перезаписывается каждый час (по умолчанию).
• 📝 app.log — Логи программы.
• 🛠️ config.json — Настройки проекта.
• ⚙️ wl-download.exe — Основной бинарный файл. Не перемещайте его после запуска!. Если все же нужно переместить, то найдите в диспетчере задач процесс 'wl-download.exe' и завершите его, после переместите файл в новое место и запустите его.

---

👀 Статистика репозитория

---

🔗 Источники конфигураций

Проект агрегирует данные из следующих открытых источников:

• zieng2/wl
• igareck/vpn-configs-for-russia
• whoahaow/rjsxrd

---