Merge pull request #1393 from amozebus/main

Обновление/улучшение README.md
This commit is contained in:
Flowseal 2025-02-17 10:53:43 +03:00 committed by GitHub
commit 5682cd1654
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

138
README.md
View File

@ -1,130 +1,120 @@
# Zapret для обхода блокировок [Discord](https://discord.com) и [Youtube](https://youtube.com)
<div align="center">
## Описание
# <img src="https://cdn-icons-png.flaticon.com/128/5968/5968756.png" height=28 /> <a href="https://github.com/Flowseal/">Flowseal</a><a href="https://github.com/Flowseal/zapret-discord-youtube">/zapret-discord-youtube</a> <img src="https://cdn-icons-png.flaticon.com/128/1384/1384060.png" height=28 />
Это *некоммерческая*, более *user-friendly* сборка [Zapret](https://github.com/bol-van/zapret). Сборка использует бинарники [оригинального репозитория](https://github.com/bol-van/zapret), проверить которые вы можете с помощью хэшей/контрольных сумм.
*"Plug & Play"* обход блокировок <img src="https://cdn-icons-png.flaticon.com/128/5968/5968756.png" height=15 /> Discord и <img src="https://cdn-icons-png.flaticon.com/128/1384/1384060.png" height=15 /> YouTube для Windows
> [!WARNING]
> Многие антивирусные программы в данный момент жалуются на **`HackTool/RiskTool`** и **`WinDivert`** - это нормальное поведение, так как программа изменяет сетевые пакеты.
Альтернатива [bol-van](https://github.com/bol-van)[/zapret-win-bundle](https://github.com/bol-van/zapret-win-bundle)[/zapret-winws](https://github.com/bol-van/zapret-win-bundle/tree/master/zapret-winws)
</div>
> [!CAUTION]
>
> Решения, если для вас это проблема:
> ### АНТИВИРУСЫ
> WinDivert может вызвать реакцию антивируса.
> WinDivert - это инструмент для перехвата и фильтрации трафика, необходимый для работы zapret.
> Замена iptables и NFQUEUE в Linux, которых нет под Windows.
> Он может использоваться как хорошими, так и плохими программами, но сам по себе не является вирусом.
> Драйвер WinDivert64.sys подписан для возможности загрузки в 64-битное ядро Windows.
> Но антивирусы склонны относить подобное к классам повышенного риска или хакерским инструментам.
> В случае проблем используйте исключения или выключайте антивирус совсем.
>
> - Самостоятельно собрать бинарники из открытых исходников из [оригинального репозитория](https://github.com/bol-van/zapret)
> - Довериться собранным
> - Не использовать эту сборку
## Использование
### Windows
> **Выдержка из [`readme.md`](https://github.com/bol-van/zapret-win-bundle/blob/master/readme.md#%D0%B0%D0%BD%D1%82%D0%B8%D0%B2%D0%B8%D1%80%D1%83%D1%81%D1%8B) репозитория [bol-van/zapret-win-bundle](https://github.com/bol-van/zapret-win-bundle)*
> [!IMPORTANT]
> Рекомендуется загружать [последний релиз](https://github.com/Flowseal/zapret-discord-youtube/releases/latest) (zip/rar)
> и распаковывать по пути, который не содержит кириллицы, пробелов и спец. символов.
> Все файлы в папке [`bin`](./bin) взяты из [zapret-win-bundle/zapret-winws](https://github.com/bol-van/zapret-win-bundle/tree/master/zapret-winws). Вы можете это проверить с помощью хэшей/контрольных сумм.
Запустите **от имени администратора** (ПКМ по выбранному файлу > "Запуск от имени администратора") выбранный bat-файл:
## ⚙️Использование
- [**`discord.bat`**](./discord.bat) - запуск обхода блокировки [Discord](https://discord.com/)
1. Загрузите архив (zip/rar) со [страницы последнего релиза](https://github.com/Flowseal/zapret-discord-youtube/releases/latest)
- [**`general.bat`**](./general.bat) - запуск обхода блокировок [Discord](https://discord.com/) и [YouTube](https://youtube.com/)
2. Распакуйте содержимое архива по пути, который не содержит кириллицу/спец. символы
* Если обход не работает, проверьте стратегии **`ALT`**
3. Запустите нужный файл
* Если обход не работает со всеми стратегиямм **`ALT`**, проверьте стратегии **`МГТС`**
## ℹ️Краткие описания файлов
- [**`service_install.bat`**](./service_install.bat) - установка обхода на автозапуск (как служба Windows), можно выбрать любую стратегию (стратегия **НЕ** должна начинаться со слова `service`)
- [**`discord.bat`**](./discord.bat) - запуск со стратегией для обхода блокировки <img src="https://cdn-icons-png.flaticon.com/128/5968/5968756.png" height=15 /> Discord
- [**`service_remove.bat`**](./service_remove.bat) - остановка и удаление службы обхода
- [**`general.bat`**](./general.bat) - запуск со стратегией для обхода блокировок <img src="https://cdn-icons-png.flaticon.com/128/5968/5968756.png" height=15 /> Discord и <img src="https://cdn-icons-png.flaticon.com/128/1384/1384060.png" height=12 /> YouTube
- [**`service_status.bat`**](./service_status.bat) - проверка состояния службы обхода
- [**`service_install.bat`**](./service_install.bat) - установка на автозапуск (как службы Windows: `zapret`, `WinDivert`), можно выбрать любую стратегию (название файла стратегии **НЕ** должно начинаться со слова `service`)
- [**`service_remove.bat`**](./service_remove.bat) - остановка и удаление служб `zapret` и `WinDivert`
- [**`service_status.bat`**](./service_status.bat) - проверка состояния служб `zapret` и `WinDivert`
- [**`check_updates.bat`**](./check_updates.bat) - проверка обновлений
> [!Important]
> Стратегии блокировок могут изменятся со временем. Следовательно, одна стратегия для Zapret не всегда может работать, даже если до этого она работала какое-то время. В репозитории представлены множество различных стратегий для обхода. Стратегия может работать какое-то время, но если меняется способ блокировки или обнаружения обхода блокировки, то она не сработает или перестанет работать та, которую вы использовали. Поэтому сидеть только на одной и пытаться запускать её каждый раз если она перестала работать - нет смысла. Если ни одна из них вам не помогает, то вам необходимо создать новую, взяв за основу одну из представленных здесь и изменить её параметры. Информация из оригинального репозитория про параметры стратегий - https://github.com/bol-van/zapret/blob/master/docs/readme.md#nfqws
## ☑️Распространенные проблемы
### Linux
### Не работает <img src="https://cdn-icons-png.flaticon.com/128/5968/5968756.png" height=18 /> Discord
Данная сборка является решением для **Windows**. Информацию для использования на ОС Linux вы можете найти в документации оригинального [Zapret](https://github.com/bol-van/zapret) - [Быстрая настройка Linux/OpenWrt](https://github.com/bol-van/zapret/blob/master/docs/quick_start.md).
- См. #252
Также вы можете найти "порт" от энтузиаста [Sergeydigl3](https://github.com/Sergeydigl3): [#697](https://github.com/Flowseal/zapret-discord-youtube/issues/697)
### Не работает <img src="https://cdn-icons-png.flaticon.com/128/1384/1384060.png" height=18 /> YouTube
> [!WARNING]
> Следовательно, не открывайте проблему (issue), связанную с использованием на ОС Linux, в этом репозитории!
- См. #251
## Возможные проблемы и их решения
### bat-файлы запускаются, но ресурс(-ы) не работает(-ют)
### Обход не работает
> [!IMPORTANT]
> **Zapret не имеет функционала VPN!**
> Следовательно, если ресурс блокирует доступ с вашего IP, Zapret с этим не поможет.
> **Стратегии блокировок со временем изменяются.**
> Определенная стратегия обхода zapret может работать какое-то время, но если меняется способ блокировки или обнаружения обхода блокировки, то она перестанет работать.
> В репозитории представлены множество различных стратегий для обхода. Если ни одна из них вам не помогает, то вам необходимо создать новую, взяв за основу одну из представленных здесь и изменив её параметры.
> Информацию из про параметры стратегий вы можете найти [тут](https://github.com/bol-van/zapret/blob/master/docs/readme.md#nfqws).
**Решения:**
- Проверьте другие стратегии (**`ALT`**/**`МГТС`**)
- Запуск от **имени администратора** (ПКМ по выбранному файлу > "Запуск от имени администратора")
- Обновите файлы в папке [`bin`](./bin), взяв новые из [zapret-win-bundle/zapret-winws](https://github.com/bol-van/zapret-win-bundle/tree/master/zapret-winws)
- При неработе [**YouTube**](https://youtube.com) ![YouTube logo](https://cdn-icons-png.flaticon.com/16/3670/3670147.png) - см. [Обход для YouTube](https://github.com/Flowseal/zapret-discord-youtube/discussions/251)
- См. #765
- При неработе [**Discord**](https://discord.com) ![Discord logo](https://cdn-icons-png.flaticon.com/16/906/906361.png) - см. [Обход для Discord](https://github.com/Flowseal/zapret-discord-youtube/discussions/252)
### Файлы не запускаются
- Обновите бинарники с [оригинального репозитория](https://github.com/bol-van/zapret)
- Обратитесь к документации по использованию из оригинального репозитория [**тут**](https://github.com/bol-van/zapret/blob/master/docs/quick_start_windows.md)
- См. [#765](https://github.com/Flowseal/zapret-discord-youtube/issues/765)
### bat-файлы не запускаются
**Решения:**
- См. [#522](https://github.com/Flowseal/zapret-discord-youtube/issues/522)
### Не работает вместе с VPN
**Решения:**
- Отключите функцию **TUN** (Tunneling) в настройках вашего VPN
- См. #522
### Требуется цифровая подпись драйвера WinDivert (Windows 7)
**Решения:**
- Замените файлы `WinDivert.dll` и `WinDivert64.sys` в папке [`bin`](./bin) на одноименные из [zapret-win-bundle/win7](https://github.com/bol-van/zapret-win-bundle/tree/master/win7)
- См. [#1319](https://github.com/Flowseal/zapret-discord-youtube/issues/1319#issuecomment-2613979041)
### Не работает вместе с VPN
- Отключите функцию **TUN** (Tunneling) в настройках вашего VPN
### При удалении с помощью [**`service_remove.bat`**](./service_remove.bat), WinDivert остается в службах
**Решение:**
1. Узнайте название службы с помощью команды, в командной строке Windows (Win+R, `cmd`):
```cmd
driverquery | find "Divert"
```
2. Удалите службу командами (вместо `WinDivert` введите название, которые вы узнали в предыдущем шаге):
2. Остановите и удалите службу командами:
```cmd
sc stop WinDivert
sc stop {название, которые вы узнали в шаге 1}
sc delete WinDivert
sc delete {название, которые вы узнали в шаге 1}
```
### Не нашли своей проблемы
* Создайте её [тут](https://github.com/Flowseal/zapret-discord-youtube/issues)
## Добавление адресов прочих заблокированных ресурсов
## 🗒️Добавление адресов прочих заблокированных ресурсов
Список блокирующихся адресов для обхода можно расширить, добавляя их в [`list-general.txt`](./list-general.txt) (для файлов `general... .bat`) или в [`list-discord.txt`](./list-discord.txt) (для файла [`discord.bat`](./discord.bat))
Список блокирующихся адресов для обхода можно расширить, добавляя их в:
- [`list-general.txt`](./list-general.txt) для файлов `general *.bat`
- [`list-discord.txt`](./list-discord.txt) для файла [`discord.bat`](./discord.bat)
> [!IMPORTANT]
> После обновления списка адресов сервис необходимо перезапустить.
> После обновления списка адресов zapret необходимо перезапустить.
## Поддержка проекта
## Поддержка проекта
Вы можете поддержать сборку, поставив :star: этому репозиторию (сверху справа этой страницы)!
Вы можете поддержать проект, поставив :star: этому репозиторию (сверху справа этой страницы)
Также, вы можете материально поддержать разработчика оригинала [тут](https://github.com/bol-van/zapret/issues/590#issuecomment-2408866758).
Также, вы можете материально поддержать разработчика zapret [тут](https://github.com/bol-van/zapret/issues/590#issuecomment-2408866758)
<a href="https://star-history.com/#Flowseal/zapret-discord-youtube&Date">
<picture>
@ -134,14 +124,12 @@ sc delete WinDivert
</picture>
</a>
## Лицензирование
## ⚖️Лицензирование
Этот проект распространяется на условиях лицензии [MIT](https://github.com/Flowseal/zapret-discord-youtube/blob/main/LICENSE.txt).
Проект распространяется на условиях лицензии [MIT](https://github.com/Flowseal/zapret-discord-youtube/blob/main/LICENSE.txt)
## Благодарность участникам проекта
## 🩷Благодарность участникам проекта
[![Contributors](https://contrib.rocks/image?repo=Flowseal/zapret-discord-youtube)](https://github.com/Flowseal/zapret-discord-youtube/graphs/contributors)
Отдельные благодарности:
- разработчику оригинального [Zapret](https://github.com/bol-van/zapret) - [bol-van](https://github.com/bol-van)
- разработчику [порта для Linux](https://github.com/Flowseal/zapret-discord-youtube/discussions/697) - [Sergeydigl3](https://github.com/Sergeydigl3).
💖 Отдельная благодарность разработчику [zapret](https://github.com/bol-van/zapret) - [bol-van](https://github.com/bol-van)