update docs

docs/readme.txt

@@ -1,4 +1,4 @@
-zapret v.66
+zapret v.67
 
 English
 -------
@@ -269,8 +269,14 @@ nfqws
  --dpi-desync-udplen-pattern=<filename>|0xHEX   ; чем добивать udp пакет в режиме udplen. по умолчанию - нули
  --dpi-desync-start=[n|d|s]N                    ; применять dpi desync только в исходящих пакетах (n), пакетах данных (d), относительных sequence (s) по номеру больше или равно N
  --dpi-desync-cutoff=[n|d|s]N                   ; применять dpi desync только в исходящих пакетах (n), пакетах данных (d), относительных sequence (s) по номеру меньше N
- --hostlist=<filename>			        ; применять дурение только к хостам из листа. может быть множество листов, они объединяются. пустой обший лист = его отсутствие
- --hostlist-exclude=<filename>		        ; не применять дурение к хостам из листа. может быть множество листов, они объединяются
+ --hostlist=<filename>				; действовать только над доменами, входящими в список из filename. поддомены автоматически учитываются.
+						; в файле должен быть хост на каждой строке.
+						; список читается при старте и хранится в памяти в виде иерархической структуры для быстрого поиска.
+						; при изменении времени модификации файла он перечитывается автоматически по необходимости
+						; список может быть запакован в gzip. формат автоматически распознается и разжимается
+						; списков может быть множество. пустой общий лист = его отсутствие
+						; хосты извлекаются из Host: хедера обычных http запросов и из SNI в TLS ClientHello.
+ --hostlist-exclude=<filename>			; не применять дурение к доменам из листа. может быть множество листов. схема аналогична include листам.
  --hostlist-auto=<filename>                     ; обнаруживать автоматически блокировки и заполнять автоматический hostlist (требует перенаправления входящего трафика)
  --hostlist-auto-fail-threshold=<int>           ; сколько раз нужно обнаружить ситуацию, похожую на блокировку, чтобы добавить хост в лист (по умолчанию: 3)
  --hostlist-auto-fail-time=<int>                ; все эти ситуации должны быть в пределах указанного количества секунд (по умолчанию: 60)
@@ -278,11 +284,11 @@ nfqws
  --hostlist-auto-debug=<logfile>        	; лог положительных решений по autohostlist. позволяет разобраться почему там появляются хосты.
  --new                                          ; начало новой стратегии
  --filter-l3=ipv4|ipv6                          ; фильтр версии ip для текущей стратегии
- --filter-tcp=[~]port1[-port2]                  ; фильтр портов tcp для текущей стратегии. ~ означает инверсию. установка фильтра tcp и неустановка фильтра udp запрещает udp.
- --filter-udp=[~]port1[-port2]                  ; фильтр портов udp для текущей стратегии. ~ означает инверсию. установка фильтра udp и неустановка фильтра tcp запрещает udp.
+ --filter-tcp=[~]port1[-port2]|*                ; фильтр портов tcp для текущей стратегии. ~ означает инверсию. установка фильтра tcp и неустановка фильтра udp запрещает udp. поддерживается список через запятую.
+ --filter-udp=[~]port1[-port2]|*                ; фильтр портов udp для текущей стратегии. ~ означает инверсию. установка фильтра udp и неустановка фильтра tcp запрещает udp. поддерживается список через запятую.
  --filter-l7=[http|tls|quic|wireguard|dht|unknown] ; фильтр протокола L6-L7. поддерживается несколько значений через запятую.
- --ipset=<filename>             	        ; включающий ip list. на каждой строчке ip или cidr ipv4 или ipv6. поддерживается множество листов и gzip.
- --ipset-exclude=<filename>                     ; исключающий ip list. на каждой строчке ip или cidr ipv4 или ipv6. поддерживается множество листов и gzip.
+ --ipset=<filename>             	        ; включающий ip list. на каждой строчке ip или cidr ipv4 или ipv6. поддерживается множество листов и gzip. перечитка автоматическая.
+ --ipset-exclude=<filename>                     ; исключающий ip list. на каждой строчке ip или cidr ipv4 или ipv6. поддерживается множество листов и gzip. перечитка автоматическая.
 
 Параметры манипуляции могут сочетаться в любых комбинациях.
 
@@ -773,22 +779,22 @@ tpws - это transparent proxy.
  --tamper-cutoff=[n]<pos> ; закончить дурение на указанной байтовой позиции или номере блока исходящего потока (считается позиция начала принятого блока)
  --hostlist=<filename>  ; действовать только над доменами, входящими в список из filename. поддомены автоматически учитываются.
 			; в файле должен быть хост на каждой строке.
-			; список читается 1 раз при старте и хранится в памяти в виде иерархической структуры для быстрого поиска.
-			; по сигналу HUP список будет перечитан при следующем принятом соединении
+			; список читается при старте и хранится в памяти в виде иерархической структуры для быстрого поиска.
+			; при изменении времени модификации файла он перечитывается автоматически по необходимости
 			; список может быть запакован в gzip. формат автоматически распознается и разжимается
-			; списков может быть множество, они объединяются. пустой общий лист = его отсутствие
+			; списков может быть множество. пустой общий лист = его отсутствие
 			; хосты извлекаются из Host: хедера обычных http запросов и из SNI в TLS ClientHello.
- --hostlist-exclude=<filename>		; не применять дурение к доменам из листа. может быть множество листов, они объединяются
+ --hostlist-exclude=<filename>		; не применять дурение к доменам из листа. может быть множество листов. схема аналогична include листам.
  --hostlist-auto=<filename>             ; обнаруживать автоматически блокировки и заполнять автоматический hostlist (требует перенаправления входящего трафика)
  --hostlist-auto-fail-threshold=<int>   ; сколько раз нужно обнаружить ситуацию, похожую на блокировку, чтобы добавить хост в лист (по умолчанию: 3)
  --hostlist-auto-fail-time=<int>        ; все эти ситуации должны быть в пределах указанного количества секунд (по умолчанию: 60)
  --hostlist-auto-debug=<logfile>       	; лог положительных решений по autohostlist. позволяет разобраться почему там появляются хосты.
  --new                                  ; начало новой стратегии
  --filter-l3=ipv4|ipv6                  ; фильтр версии ip для текущей стратегии
- --filter-tcp=[~]port1[-port2]          ; фильтр портов tcp для текущей стратегии. ~ означает инверсию.
+ --filter-tcp=[~]port1[-port2]|*        ; фильтр портов tcp для текущей стратегии. ~ означает инверсию. поддерживается список через запятую.
  --filter-l7=[http|tls|quic|wireguard|dht|unknown] ; фильтр протокола L6-L7. поддерживается несколько значений через запятую.
- --ipset=<filename>             	        ; включающий ip list. на каждой строчке ip или cidr ipv4 или ipv6. поддерживается множество листов и gzip.
- --ipset-exclude=<filename>                     ; исключающий ip list. на каждой строчке ip или cidr ipv4 или ipv6. поддерживается множество листов и gzip.
+ --ipset=<filename>                     ; включающий ip list. на каждой строчке ip или cidr ipv4 или ipv6. поддерживается множество листов и gzip. перечитка автоматическая.
+ --ipset-exclude=<filename>             ; исключающий ip list. на каждой строчке ip или cidr ipv4 или ipv6. поддерживается множество листов и gzip. перечитка автоматическая.
 
 
 --debug позволяет выводить подробный лог действий на консоль, в syslog или в файл.
@@ -1154,9 +1160,7 @@ ipset/get_reestr_resolvable_domains.sh
 ipset/get_refilter_domains.sh
 - кладется в ipset/zapret-hosts.txt.gz.
 
-Чтобы обновить списки, перезапускать nfqws или tpws не нужно. Обновляете файлы, затем даете сигнал HUP.
-По HUP листы будут перечитаны. Если вдруг какого-то листа не окажется, процесс завершится с ошибкой.
-Скрипты получения листов из ipset сами выдают HUP в конце.
+При изменении времени модификации файлов списки перечитываются автоматически.
 
 При фильтрации по именам доменов демон должен запускаться без фильтрации по ipset.
 tpws и nfqws решают нужно ли применять дурение в зависимости от хоста, полученного из протокола прикладного уровня (http, tls, quic).
@@ -1230,7 +1234,7 @@ nfqws и tpws могут сечь варианты 1-3, 4 они не распо
 По логу можно понять как избежать ложных срабатываний и подходит ли вообще вам этот режим.
 
 Можно использовать один autohostlist с множеством процессов. Все процессы проверяют время модификации файла.
-Если файл был изменен в другом процессе, то происходит перечитывание всех include листов, включая autohostlist.
+Если файл был изменен в другом процессе, происходит его перечитывание.
 Все процессы должны работать под одним uid, чтобы были права доступа на файл.
 
 Скрипты zapret ведут autohostlist в ipset/zapret-hosts-auto.txt.
@@ -1252,6 +1256,7 @@ install_easy.sh при апгрейде zapret сохраняет этот фа
 Если DNS подменяется и провайдер перехватывает обращения к сторонним DNS, настройте dnscrypt.
 Еще один эффективный вариант - использовать ресолвер от yandex 77.88.8.88 на нестандартном порту 1253.
 Многие провайдеры не анализируют обращения к DNS на нестандартных портах.
+blockcheck если видит подмену DNS автоматически переключается на DoH сервера.
 
 Следует прогнать blockcheck по нескольким заблокированным сайтам и выявить общий характер блокировок.
 Разные сайты могут быть заблокированы по-разному, нужно искать такую технику, которая работает на большинстве.
@@ -1276,6 +1281,24 @@ Blockcheck имеет 3 уровня сканирования.
 standard дает возможность провести исследование как и на что реагирует DPI в плане методов обхода.
 force дает максимум проверок даже в случаях, когда ресурс работает без обхода или с более простыми стратегиями.
 
+Есть ряд других параметров, которые не будут спрашиваться в диалоге, но которые можно переопределить через
+переменные. Переопределение работает только из рутового шелла. При повышении привилегий через su/sudo переменные теряются.
+
+DOMAINS - список тестируемых доменов через пробел
+CURL_MAX_TIME - время таймаута curl в секундах
+CURL_MAX_TIME_QUIC - время таймаута curl для quic. если не задано, используется значение CURL_MAX_TIME
+HTTP_PORT, HTTPS_PORT, QUIC_PORT - номера портов для соответствующих протоколов
+SKIP_DNSCHECK=1 - отказ от проверки DNS
+SKIP_TPWS=1 - отказ от тестов tpws
+SKIP_PKTWS=1 - отказ от тестов nfqws/dvtws/winws
+PKTWS_EXTRA, TPWS_EXTRA - дополнительные параметры nfqws/dvtws/winws и tpws
+PKTWS_EXTRA_1 .. PKTWS_EXTRA_9, TPWS_EXTRA_1 .. TPWS_EXTRA_9 - отдельно дополнительные параметры, содержащие пробелы
+SECURE_DNS=0|1 - принудительно выключить или включить DoH
+DOH_SERVERS - список URL DoH через пробел для автоматического выбора работающего сервера
+DOH_SERVER - конкретный DoH URL, отказ от поиска
+
+Пример запуска с переменными : SECURE_DNS=1 SKIP_TPWS=1 CURL_MAX_TIME=1 ./blockcheck.sh
+
 СКАН ПОРТОВ
 Если в системе присутствует совместимый netcat (ncat от nmap или openbsd ncat. в openwrt по умолчанию нет.),
 то выполняется сканирование портов http или https всех IP адресов домена.
@@ -1417,6 +1440,9 @@ tpws-socks требует настройки параметров tpws, но н
 группе параметров фильтра. Таких мест может быть несколько.
 Не нужно использовать <HOSTLIST> в узких специализациях и в тех профилях, по которым точно не будет проходить
 трафик с известными протоколами, откуда поддерживается извлечение имени хоста (http, tls, quic).
+<HOSTLIST_NOAUTO> - это вариация, при которой стандартный автолист используется как обычный.
+То есть на этом профиле не происходит автоматическое добавление заблокированных доменов.
+Но если на другом профиле что-то будет добавлено, то этот профиль примет изменения автоматически.
 
 # включение стандартной опции tpws в режиме socks
 TPWS_SOCKS_ENABLE=0
@@ -1462,7 +1488,7 @@ NFQWS_UDP_PKT_IN=0
 NFQWS_OPT="
 --filter-tcp=80 --dpi-desync=fake,split2 --dpi-desync-fooling=md5sig <HOSTLIST> --new
 --filter-tcp=443 --dpi-desync=fake,disorder2 --dpi-desync-fooling=md5sig <HOSTLIST> --new
---filter-udp=443 --dpi-desync=fake --dpi-desync-repeats=6 <HOSTLIST>
+--filter-udp=443 --dpi-desync=fake --dpi-desync-repeats=6 <HOSTLIST_NOAUTO>
 "