Update README.md

This commit is contained in:
Ground-Zerro
2024-09-18 23:26:06 +11:00
parent 0bf247a225
commit 9ce98ce052

View File

@@ -3,7 +3,10 @@
**Описание:** Инструмент на языке Python, предназначенный для разрешения DNS имен популярных веб-сервисов в IP-адреса.
Имеется поддержка следующих сервисов:
<details>
<summary>Поддерживаемые сервисы (нажать чтоб открыть)</summary>
- [Antifilter - community edition](https://community.antifilter.download/)
- Youtube
- Facebook
@@ -22,21 +25,23 @@
- Twitch
- Личный список
</details>
**Функции:**
- Скрипт использует списки доменных имен популярных сервисов и разрешает их в IP-адреса.
- Итоговый список содержит только уникальные IP-адреса исключая дубликаты, также фильтруются IP-адреса самих DNS-серверов, заглушки в виде редиректа на localhost и (по желанию) IP-адреса Cloudflare.
- Выбор между системным DNS сервером, популярными публичными, либо их комбинации.
- Разрешение DNS имени происходит используя каждый из указанных пользователем DNS серверов и не останавливается при первом же успешном получении его IP-адреса.
- Пользователь может создать свой список с DNS именами, необходимыми лично ему.
- Разрешение доменных имен популярных сервисов в IP-адреса.
- Агрегация маршрутов до /16 (255.255.0.0), /24 (255.255.255.0).
- Фильтрация IP-адресов Cloudflare (по желанию).
- Автоматическое исключение IP-адресов самих DNS-серверов, "заглушек" редиректа на localhost и дублирующихся IP.
**Особенности:**
- Можно выбрать системный DNS сервер, популярный публичный, либо их комбинацию.
- Разрешение каждого доменного имени происходит используя каждый из указанных пользователем DNS серверов и не останавливается при первом же успешном получении его IP-адреса.
**Автоматизация:**
Конфигурационный файл позволяет настроить работу скрипта в "молчаливом" режиме - без промтов к пользователю.
Так же в конфигурационном файле можно добавить выполнение кастомной команды в консоли для запуска другого скрипта или программы при завершении его работы.
**Зависимости:** Для работы Domain Mapper необходимо наличие следующих библиотек Python:
- configparser, ipaddress, dnspython, httpx, colorama.
@@ -45,10 +50,9 @@
pip3 install -r requirements.txt
```
**Использование:**
- Запустить с помощью Python. Для работы необходим только "main.py" и (по желанию) файл "config.ini".
- Запустить `main.py` с помощью Python.
Можно отредактировать настройки под свои задачи в "config.ini".
<details>
<summary>Дополнительный личный список с доменными именами (нажать чтоб открыть)</summary>
@@ -77,8 +81,8 @@ pip3 install -r requirements.txt
В этом режиме списки DNS серверов и сервисов будут загружены из локальных файлов в папке со скриптом, а не из сети.
Загружать список сервисов из файла `platformdb` - указать `localplatform = yes` в config.ini.
- Формат файла: Название сервиса двоеточие путь к локальному файлу.
Включить загрузку списка сервисов из локального файла `platformdb` - указать `localplatform = yes` в config.ini.
- Формат файла `platformdb`: Название сервиса двоеточие путь к локальному файлу.
Пример:
```
Torrent Truckers: platforms/dns-ttruckers.txt
@@ -86,8 +90,8 @@ Search engines: platforms/dns-search-engines.txt
Twitch: platforms/dns-twitch.txt
```
Загружать список DNS серверов из файла `dnsdb` в папке со скриптом - указать `localplatform = yes` в config.ini.
- Формат файла: Название DNS сервера двоеточие IP-адрес пробел IP-адрес.
Включить загрузку списка DNS серверов из локального файла `dnsdb` - указать `localplatform = yes` в config.ini.
- Формат файла `dnsdb`: Название DNS сервера двоеточие IP-адрес пробел IP-адрес.
Пример:
```
CleanBrowsing: 185.228.168.9 185.228.169.9