Merge pull request #1234 from amozebus/main

Обновление/улучшение README.md

README.md

@@ -1,79 +1,121 @@
-# Zapret (обход блокировки Discord'а и Youtube'а)
+# Zapret для обхода блокировок [Discord](https://discord.com) и [Youtube](https://youtube.com)
 
-> [!NOTE]  
+## Описание
-> Данный репозиторий - **некоммерческая** *User-Friendly* сборка [оригинального репозитория](https://github.com/bol-van/zapret). Здесь используются оригинальные бинарники, сравнить которые вы можете с помощью хэша.
-> Так как zapret open-source, вы всегда можете сами собрать эти бинарники и не бояться вирусов.
-> 
->**Буду рад [⭐ поставленной репозиторию звезде](https://github.com/Flowseal/zapret-discord-youtube/stargazers) (в правом верхнем углу) 🙂**
 
-##
+Это *некоммерческая*, более *user-friendly* сборка [Zapret](https://github.com/bol-van/zapret). Сборка использует бинарники [оригинального репозитория](https://github.com/bol-van/zapret), проверить которые вы можете с помощью хэшей/контрольных сумм.
 
-> [!CAUTION]  
+> [!WARNING]
-> **Многие антивирусники** в данный момент жалуются на ***HackTool/RiskTool*** и ***WinDivert*** - это нормальное поведение, так как программа изменяет сетевые пакеты. Что с этим делать? Собрать бинарники самому из исходников, довериться уже собранным, либо не использовать вовсе.
+> Многие антивирусные программы в данный момент жалуются на **`HackTool/RiskTool`** и **`WinDivert`** - это нормальное поведение, так как программа изменяет сетевые пакеты.
+>
+> Решения, если для вас это проблема:
+>
+> - Самостоятельно собрать бинарники из открытых исходников из [оригинального репозитория](https://github.com/bol-van/zapret)
+> - Довериться собранным
+> - Не использовать эту сборку
 
-## License
+## Использование
 
-Этот проект распространяется на условиях лицензии MIT.  
-Полный текст лицензии можно найти в файле [LICENSE.txt](./LICENSE.txt)
-
-## Guides
 ### Windows
-> [!IMPORTANT]  
-> Если ещё не сделали этого, то скачайте последний [релиз](https://github.com/Flowseal/zapret-discord-youtube/releases), разархивируйте в отдельную папку.
 
-Запустите **от имени администратора** то, что вам нужно:
+> [!IMPORTANT]
-- **`discord.bat`** - запустить обход дискорда.
+> Рекомендуется загружать [последний релиз](https://github.com/Flowseal/zapret-discord-youtube/releases/latest) (zip/rar)
-- **`general.bat`** - запустить обход дискорда и ютуба.
+> и распаковывать по пути, который не содержит кириллицы, пробелов и спец. символов.
-  * Если обход не работает, пробуйте по порядку **`general (ALT ..).bat`** (также можете проверить стратегию на **МГТС**)
-###
-- **`service_install.bat`** - установить на автозапуск (в сервисы) любую стратегию из этого репозитория (стратегия **НЕ** должна начинаться со слова `service`)
-###
-- **`service_remove.bat`** - остановить и удалить сервисы выше
 
-## Решение проблем
+Запустите **от имени администратора** (ПКМ по выбранному файлу > "Запуск от имени администратора") выбранный bat-файл:
 
-- Проверьте, запускаете ли вы файлы от **ИМЕНИ АДМИНИСТРАТОРА**
+- [**`discord.bat`**](./discord.bat) - запуск обхода блокировки [Discord](https://discord.com/)
-- Не запускаются bat файлы? Попробуйте найти ответ здесь: https://github.com/Flowseal/zapret-discord-youtube/issues/522
-- <p style="text-align: left;">
-    <img src="https://cdn-icons-png.flaticon.com/16/3670/3670147.png" alt="discord" style="vertical-align: middle;"/>
-    Не работает <strong>YouTube</strong>? Попробуйте найти ответ здесь - 
-    <a href="https://github.com/Flowseal/zapret-discord-youtube/discussions/251">Обсуждение YouTube</a>
-  </p>
-- <p style="text-align: left;">
-    <img src="https://cdn-icons-png.flaticon.com/16/906/906361.png" alt="discord" style="vertical-align: middle;"/>
-    Не работает <strong>Discord</strong>? Попробуйте найти ответ здесь - 
-    <a href="https://github.com/Flowseal/zapret-discord-youtube/discussions/252">Обсуждение Discord</a>
-  </p>
-##
-- Не работает вместе с **VPN**? Отключите функцию **TUN** (Tunneling) в настройках VPN.
-- Попробуйте обновить бинарники с оригинального репозитория.
 
-### Остановка и удаление обхода
+- [**`general.bat`**](./general.bat) - запуск обхода блокировок [Discord](https://discord.com/) и [YouTube](https://youtube.com/)
-Для этого запустите **`service_remove.bat`**.
+
-- Если WinDivert так и не удалился, узнайте его название с помощью команды `driverquery | find "Divert"` в cmd, а затем удалите данными командами (заместо WinDivert введите название, которые вы узнали):
+  * Если обход не работает, проверьте стратегии **`ALT`**
+
+  * Если обход не работает со всеми стратегиямм **`ALT`**, проверьте стратегии **`МГТС`**
+
+- [**`service_install.bat`**](./service_install.bat) - установка обхода на автозапуск (как служба Windows), можно выбрать любую стратегию (стратегия **НЕ** должна начинаться со слова `service`)
+
+- [**`service_remove.bat`**](./service_remove.bat) - остановка и удаление службы обхода
+
+- [**`service_status.bat`**](./service_status.bat) - проверка состояния службы обхода
+
+- [**`check_updates.bat`**](./check_updates.bat) - проверка обновлений
+
+### Linux
+
+Данная сборка является решением для **Windows**. Информацию для использования на ОС Linux вы можете найти в документации оригинального [Zapret](https://github.com/bol-van/zapret) - [Быстрая настройка Linux/OpenWrt](https://github.com/bol-van/zapret/blob/master/docs/quick_start.md).
+
+Также вы можете найти "порт" от энтузиаста [Sergeydigl3](https://github.com/Sergeydigl3): [#697](https://github.com/Flowseal/zapret-discord-youtube/issues/697)
+
+> [!WARNING]
+> Следовательно, не открывайте проблему (issue), связанную с использованием на ОС Linux, в этом репозитории!
+
+## Возможные проблемы и их решения
+
+### bat-файлы запускаются, но ресурс(-ы) не работает(-ют)
+
+> [!IMPORTANT]
+> **Zapret не имеет функционала VPN!**
+> Следовательно, если ресурс блокирует доступ с вашего IP, Zapret с этим не поможет.
+
+**Решения:**
+
+- Запуск от **имени администратора** (ПКМ по выбранному файлу > "Запуск от имени администратора")
+
+- При неработе [**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)
+
+- При неработе [**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
+
+### При удалении с помощью [**`service_remove.bat`**](./service_remove.bat), WinDivert остается в службах
+
+**Решение:**
+
+1. Узнайте название службы с помощью команды, в командной строке Windows (Win+R, `cmd`):
+
+```cmd
+driverquery | find "Divert"
 ```
+
+2. Удалите службу командами (вместо `WinDivert` введите название, которые вы узнали в предыдущем шаге):
+
+```cmd
 sc stop WinDivert
+
 sc delete WinDivert
 ```
 
-### Добавление дополнительных адресов заблокированных сайтов 
+### Не нашли своей проблемы
-- Список можно дополнить используя `list-general.txt` (для файлов `general`) и в список `list-discord` (для файлов `discord`).
+
+* Создайте её [тут](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))
+
 > [!IMPORTANT]  
-> После добавления сервис нужно перезапустить.
+> После обновления списка адресов сервис необходимо перезапустить.
 
-## Linux
+## Поддержка проекта
-В оригинальном репозитории [zapret](https://github.com/bol-van/zapret/) имеется достаточно информации для того, чтобы начать пользоваться обходом блокировок, но и стоит понимать, что нажатием одной кнопки ничего не заработает. \
-Достаточно следовать следующим инструкциям и всё внимательно читать:
-- [zapret/blob/master/docs/quick_start.md](https://github.com/bol-van/zapret/blob/master/docs/quick_start.md)
-- [zapret/blob/master/docs/readme.md](https://github.com/bol-van/zapret/blob/master/docs/readme.md)
-  * https://github.com/Flowseal/zapret-discord-youtube/issues/7
-> [!WARNING]
-> Если вы открываете Issue *(в этом репозитории)* с проблемой в использовании на **Linux**, то, как бы это не звучало, это ошибка. Все вопросы по работе на Linux нужно открывать в **[ОРИГИНАЛЬНОМ](https://github.com/bol-van/zapret/)** репозитории. Следовательно, задавайте вопросы [тут](https://github.com/bol-van/zapret/issues/).
 
-## Support
+Вы можете поддержать сборку, поставив :star: этому репозиторию (сверху справа этой страницы)!
 
-Вы можете поддержать проект, поставив :star: (сверху справа этой страницы)!  
+Также, вы можете материально поддержать разработчика оригинала [тут](https://github.com/bol-van/zapret/issues/590#issuecomment-2408866758).
-Также, вы можете поддержать разработчика [оригинального репозитория zapret](https://github.com/bol-van/zapret/issues/590) тут - https://github.com/bol-van/zapret/issues/590
 
 <a href="https://star-history.com/#Flowseal/zapret-discord-youtube&Date">
  <picture>
@@ -83,11 +125,14 @@ sc delete WinDivert
  </picture>
 </a>
 
-## Credits & Contributors
+## Лицензирование
-<p align="left">
-  <a href="https://github.com/Flowseal/zapret-discord-youtube/graphs/contributors">
-    <img src="https://contrib.rocks/image?repo=Flowseal/zapret-discord-youtube" />
-  </a>
-</p>
 
-* Many thanks to [bol-van](https://github.com/bol-van/), creator of original [zapret](https://github.com/bol-van/zapret/) repository.
+Этот проект распространяется на условиях лицензии [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).