From 27a190cd042cbb03c00f47d20e501aae3003dd49 Mon Sep 17 00:00:00 2001 From: z3APA3A <3APA3A@3proxy.ru> Date: Wed, 13 Jan 2016 23:53:18 +0300 Subject: [PATCH] Russian plugin documentation added --- doc/html/plugins/PCREPlugin.ru.html | 90 +++++++++++++++++++ doc/html/plugins/SSLPlugin.ru.html | 32 +++++++ doc/html/plugins/StringsPlugin.ru.html | 18 ++++ doc/html/plugins/TrafficPlugin.ru.html | 69 ++++++++++++++ doc/html/plugins/WindowsAuthentication.html | 33 +++++++ .../plugins/WindowsAuthentication.ru.html | 35 ++++++++ 6 files changed, 277 insertions(+) create mode 100644 doc/html/plugins/PCREPlugin.ru.html create mode 100644 doc/html/plugins/SSLPlugin.ru.html create mode 100644 doc/html/plugins/StringsPlugin.ru.html create mode 100644 doc/html/plugins/TrafficPlugin.ru.html create mode 100644 doc/html/plugins/WindowsAuthentication.html create mode 100644 doc/html/plugins/WindowsAuthentication.ru.html diff --git a/doc/html/plugins/PCREPlugin.ru.html b/doc/html/plugins/PCREPlugin.ru.html new file mode 100644 index 0000000..047079c --- /dev/null +++ b/doc/html/plugins/PCREPlugin.ru.html @@ -0,0 +1,90 @@ +

Плагин регулярных выражений совместимых с Perl (PCRE) для 3proxy

+ +Фильтрующий плагин используется для создания правил поиска и замены +регулярных выражений в запросе, заголовков запроса и ответа и данных. +Добавляет поддержку 3х новых команд в файле конфигурации: + +
+pcre TYPE FILTER_ACTION REGEXP [ACE]
+pcre_rewrite TYPE FILTER_ACTION REGEXP REWRITE_EXPRESSION [ACE]
+pcre_extend FILTER_ACTION [ACE]
+pcre_options OPTION1 [...]
+
+pcre - позволяет искать совпадения +
pcre_rewrite - дополнительно позволяет производить замену подстрок +
pcre_extend - расширяет ACL последней команды pcre или pcre_rewrite путем +добавления еще одной ACE (аналогично списку правил allow/deny). +
pcre_options - позволяет устанавливать опции поиска, доступны следующие опции: +PCRE_CASELESS, +PCRE_MULTILINE, +PCRE_DOTALL, +PCRE_EXTENDED, +PCRE_ANCHORED, +PCRE_DOLLAR_ENDONLY, +PCRE_EXTRA, +PCRE_NOTBOL, +PCRE_NOTEOL, +PCRE_UNGREEDY, +PCRE_NOTEMPTY, +PCRE_UTF8, +PCRE_NO_AUTO_CAPTURE, +PCRE_NO_UTF8_CHECK, +PCRE_AUTO_CALLOUT, +PCRE_PARTIAL, +PCRE_DFA_SHORTEST, +PCRE_DFA_RESTART, +PCRE_FIRSTLINE, +PCRE_DUPNAMES, +PCRE_NEWLINE_CR, +PCRE_NEWLINE_LF, +PCRE_NEWLINE_CRLF, +PCRE_NEWLINE_ANY, +PCRE_NEWLINE_ANYCRLF, +PCRE_BSR_ANYCRLF, +PCRE_BSR_UNICODE + + + + + +

Пример:

+
+plugin PCREPlugin.dll pcre_plugin
+pcre request deny "porn|sex" user1,user2,user3 192.168.0.0/16
+pcre srvheader deny "Content-type: application"
+pcre_rewrite clidata,srvdata dunno "porn|sex|pussy" "***" baduser
+pcre_extend deny * 192.168.0.1/16
+
+ +

Загрузить:

+ diff --git a/doc/html/plugins/SSLPlugin.ru.html b/doc/html/plugins/SSLPlugin.ru.html new file mode 100644 index 0000000..51b9399 --- /dev/null +++ b/doc/html/plugins/SSLPlugin.ru.html @@ -0,0 +1,32 @@ +

Плагин SSL/TLS для 3proxy

+ +Плагин используется для транспарентной дешифровки SSL-трафика с подменой сертификата. +Плагин не должен использоваться в рабочем окружении, т.к. его использование дает возможность обхода проверок SSL. + + +
+ssl_certcache PATH_TO_CACHE
+ssl_mitm
+ssl_nomitm
+
+ssl_certcache - путь к кэшу сертификатов. Для транспорентной подмены сертификатов в кэше должно находиться 3 файла: 3proxy.pem - публичный +самоподписанный сертификат, 3proxy.key - ключ от этого сертификата, server.key - ключ с которым будут генерироваться подменные сертификаты. +Сгенерированные сертификаты будут помещаться в этот же каталог. +
ssl_mitm - подменять сертитфикаты для запущенных ниже сервисов +
ssl_nomitm - не подменять сертитфикаты для запущенных ниже сервисов + + +

Пример:

+
+plugin /path/to/SslPlugin.dll ssl_plugin
+ssl_certcache /path/to/cache/
+ssl_mitm
+proxy -p3128
+ssl_nomitm
+proxy -p3129
+
+ +

Загрузить:

+ diff --git a/doc/html/plugins/StringsPlugin.ru.html b/doc/html/plugins/StringsPlugin.ru.html new file mode 100644 index 0000000..8f03e40 --- /dev/null +++ b/doc/html/plugins/StringsPlugin.ru.html @@ -0,0 +1,18 @@ +

Плагин подмены строк 3proxy

+ +Используется, в частности, для руссификации сообщений выдаваемых 3proxy. +Для корректной работы требуется 0.6 версия 3proxy. +Все сообщения были взяты из proxy.c +и вынесенны в отдельный файл. Пример файла rus-win1251.3ps. +Всего 15 секций на момент написания плагина в файле rus-win1251.3ps каждая секция отделяется строкой "[end]" +новая строка определяется строкой "\n" + +

Пример:

+
+plugin "StringsPlugin.dll" start c:\3proxy\bin\rus-win1251.3ps
+
+ +

Загрузить:

+ diff --git a/doc/html/plugins/TrafficPlugin.ru.html b/doc/html/plugins/TrafficPlugin.ru.html new file mode 100644 index 0000000..00469c2 --- /dev/null +++ b/doc/html/plugins/TrafficPlugin.ru.html @@ -0,0 +1,69 @@ +

Плагин коррекции траффика 3proxy

+Как известно, 3proxy считает траффик не сетевой, а прикладной. +Обычно прикладной траффик немного меньше (примерно на 10%) чем сетевой, +однако в некоторых случаях, например когда пользователи сети играют в +игры, сетевой траффик может превысить прикладной в 4-5 раз. Это довольно неприятно, +так как получается, что они за это не платят. +

+Происходит это потому, что в каждом посланом пакете есть заголовок+данные. Заголовок +весит порядка 50-60 байт а количество данных может меняться от 15-20 байт (что характерно для игр) +до 800-900 байт (у IE). Также количество данных в пакете зависит от загрузки сети, +удалённости сервера и прочих причин. +

+Данный плагин может исправить такую ситуацию. Он может умножать счётчик траффика +при окончании соединения на некоторый коэффициент либо добавлять к данным размеры заголовков пакетов, +которые прошли по сети. +

Использование

+
    +
  1. Извлечь TrafficPlugin.dll в каталог с 3proxy.exe +
  2. Стартовать плагин в 3proxy.cfg +
    +plugin TrafficPlugin.dll start
+
    +
  3. Добавить правила: +
    +ДЛЯ РЕЖИМА ДОМНОЖЕНИЯ ТРАФФИКА НА ЧИСЛО: +
    +trafcorrect m <сервис> <исходящий порт> <коэффициент>
+
    +где: <сервис> может быть proxy, socks4, socks45, socks5, tcppm, udppm, pop3p + если сервис указан неверно то считается, что это может быть любой сервис. + можно использовать *, тогда правило будет считаться для любого сервиса. +
    <исходящий порт> - порт, к которому подключается прокси сервер. * - любой + <коэффициент> - число на каоторое домнажается траффик. Обязательный параметр. + Должен быть от больше 0 и меньше 100 +
    +ДЛЯ РЕЖИМА С УЧЁТОМ РАЗМЕРА ЗАГОЛОВКОВ ПАКЕТОВ: +
    +trafcorrect p <сервис> <tcp/udp> <исходящий порт> [размер пустого пакета]
+
    + <tcp/udp> - протокол, по которому осуществляется соединение. + [размер пакета] - средний размер пустого пакета. Можно определить захватив +данные при помощи такой утилиты как Ethereal. Параметр необязателен. Если отсутствует, +то размер пакета будет считаться равным 66 байт. +
    Режимы можно смешивать. +Следует учитывать, что плугин создаёт список всех правил изменения траффика. +Когда происходит окончание соединения выполняется первое подходящее правило. +
+Подсчет трафика в любом режиме не является точным, это некоторая аппроксимация +позволяющаяподсчитать трафик с точностью до нескольких процентов. + +

Пример:

+
+plugin "TrafficPlugin.dll" start
+trafcorrect m socks5 6112 4.5
+trafcorrect m socks5 * 1.1
+
+следующее неверно: +
+plugin "TrafficPlugin.dll" start
+trafcorrect m socks5 * 1.1
+trafcorrect m socks5 6112 4.5
+
+Вторая строчка выполнена никогда не будет, т.к. правило 1 содержит *. + + +

Загрузить:

+ diff --git a/doc/html/plugins/WindowsAuthentication.html b/doc/html/plugins/WindowsAuthentication.html new file mode 100644 index 0000000..d22d8e2 --- /dev/null +++ b/doc/html/plugins/WindowsAuthentication.html @@ -0,0 +1,33 @@ + +

3proxy Windows Authentication plugin

+Support for cleartext authentication against Windows domain or local Windows account. +

Usage:

+
    +
  1. Extract WindowsAuthentication.dll to the same folder with 3proxy executable. +
  2. Create 3ProxyAllowedGroup - Windows system group allowed to use proxy. + You can choose different group name. Group can be either local or + Active Directory. Every account allowed to use 3proxy must be included in this + group either directly or through group nesting. +
  3. Configure plugin with 'plugin' command in 3proxy.cfg, e.g.: +
    
+plugin "WindowsAuthentication.dll" WindowsAuthentication "3ProxyAllowedGroup"
+
    +
    WindowsAuthentication.dll - location of DLL, if DLL is located in different folder +from 3proxy.exe you must specify complete path to DLL here. 3ProxyAllowedGroup - Windows +system group allowed to use 3proxy. +After plugin is loaded, 'windows' authentication type is supported. + +
  4. Configure 'auth windows' for services that require Windows authentication. +
  5. It's recommended you also configure authentication caching (see 'authcache'), + to prevent excessive workload for domain controller. Example: +
    + authcache user,pass 900
+ auth cache windows
+
    + +
  6. NTLM authentication is not currently supported for plugins, you should use proxy -n key to disable it. +
+

Download:

+ \ No newline at end of file diff --git a/doc/html/plugins/WindowsAuthentication.ru.html b/doc/html/plugins/WindowsAuthentication.ru.html new file mode 100644 index 0000000..7c857c7 --- /dev/null +++ b/doc/html/plugins/WindowsAuthentication.ru.html @@ -0,0 +1,35 @@ +

Плагин аутентификации Windows для 3proxy

+Поддерживается только аутентификация открытым текстом в домене или на локальной машине Windows. +

Использование

+
    +
  1. Извлечь WindowsAuthentication.dll в каталог с 3proxy.exe +
  2. Создать 3ProxyAllowedGroup - системная группа Windows, которой разрешено использование прокси. Ее необходимо создать (можно +использовать группу с другим именем, см. ниже). Учетные записи пользователей, которым разрешен доступ к прокси +должны быть включены в группу непосредственно или посредством включения их групп. Группа может быть как локальной, так и в +ActiveDirectory. +
  3. В файле конфигурации загрузить dll с помощью команды plugin: +
    plugin "WindowsAuthentication.dll" WindowsAuthentication "3ProxyAllowedGroup" +
    Если DLL находится в другом каталоге, то вместо "WindowsAuthentication.dll" +необходимо указать полный путь к DLL. 3ProxyAllowedGroup - название системной группы, +которой разрешен доступ к прокси. +
  4. Плагин добавляет новый тип аутентификации - windows. Т.е. для использования + Windows-аутентификации надо дать команду +
    +auth windows
+
    +
  5. Не рекомендуется использовать данный плагин без кэширования + аутентификации (authcache), т.к. это приведет к увеличению нагрузки на + сервер/контроллер домена. Пример: +
    + authcache user,pass 900
+ auth cache windows
+
    + +
  6. В настоящее время не поддерживается NTLM-аутентификация для плагинов, +поэтому необходимо запускать proxy с ключиком -n. +
+

Загрузить:

+ +