diff --git a/docs/quick_start.txt b/docs/quick_start.txt new file mode 100644 index 0000000..09a8b0a --- /dev/null +++ b/docs/quick_start.txt @@ -0,0 +1,44 @@ +Специально для тех, кто хочет побыстрее начать, но не хочет слишком углубляться в простыню readme.txt. + +Предупреждение : не пишите в issue вопросы типа "как скопировать файл", "как скачать", "как запустить", ... +То есть все , что касается базовых навыков обращения с ОС linux. Эти вопросы буду закрывать сразу. +Если у вас подобные вопросы возникают, рекомендую не использовать данный софт или искать помощь где-то в другом месте. + +Будем считать, что у вас есть система на базе традиционного linux или openwrt. +Если у вас традиционный linux - задача обойти блокировки только на этой системе, если openwrt - обойти блокировки +для подключенных устройств. Это наиболее распространенный случай. + +1) Скачайте zip архив проекта с github в /tmp, распакуйте его там, +либо клонируйте проект через : git clone --depth 1 https://github.com/bol-van/zapret + +2) Убедитесь, что у вас отключены все средства обхода блокировок, в том числе и сам zapret. +Гарантированно уберет zapret скрипт uninstall_easy.sh. + +3) Если вы работаете в виртуальной машине, необходимо использовать соединение с сетью в режиме bridge. nat не подходит + +4) Запустите install_bin.sh (1 раз для настройки бинариков правильной архитектуры) + +5) Запустите blockcheck.sh. blockcheck позволяет выявить рабочую стратегию обхода блокировок +По результатам blockcheck нужно понять какой вариант будете использовать : nfqws или tpws +И запомнить найденные стратегии. + +6) blockcheck.sh в начале проверяет DNS. Если выводятся сообщения о подмене адресов, то +первым делом нужно решить эту проблему, иначе ничего не будет работать. +Решение проблемы DNS выходит за рамки проекта. Обычно она решается либо заменой DNS серверов +от провайдера на публичные (1.1.1.1, 8.8.8.8), либо в случае перехвата провайдером обращений +к сторонним серверам - через специальные средства шифрования DNS запросов, такие как dnscrypt, DoT, DoH. + +7) Запустите install_easy.sh. +Выберите nfqws или tpws, затем согласитесь на редактирование параметров. +Откроется редактор, куда впишите найденные стратегии. +Для nfqws отдельно настраиваются стратегии на http и https для ipv4 и ipv6. +То есть по максимуму 4 разных варианта. +NFQWS_OPT_DESYNC - это общая установка, которая применяется, если какой-либо уточняющий параметр не задан +NFQWS_OPT_DESYNC_HTTP и NFQWS_OPT_DESYNC_HTTPS заменяют стратегию для http и https. +Если у вас включен ipv6, то они так же будут применены и к ipv6. Если для ipv6 нужная другая стратегия, +то можно задать уточняющие параметры NFQWS_OPT_DESYNC_HTTP6 и NFQWS_OPT_DESYNC_HTTPS6. + +8) На все остальные вопросы install_easy.sh отвечайте согласно выводимой аннонтации. + +Это минимальная инструкция, чтобы соориентироваться с чего начать. +Подробности и полное техническое описание расписаны в readme.txt diff --git a/docs/readme.txt b/docs/readme.txt index f9aa601..f66abf6 100644 --- a/docs/readme.txt +++ b/docs/readme.txt @@ -16,6 +16,11 @@ For english version refer to docs/readme.eng.txt Поддерживаются традиционные Linux системы, FreeBSD, OpenBSD, частично MacOS. В некоторых случаях возможна самостоятельная прикрутка решения к различным прошивкам. +Как побыстрее начать +-------------------- + +Читайте docs/quick_start.txt + Как это работает ----------------