diff --git a/doc/html/plugins/PCREPlugin.html b/doc/html/plugins/PCREPlugin.html new file mode 100644 index 0000000..fb0892a --- /dev/null +++ b/doc/html/plugins/PCREPlugin.html @@ -0,0 +1,94 @@ + +

3proxy Perl Compatible Regular Expressions (PCRE) plugin

+ +This filtering plugin can be used to create matching and replace +rules with regular expressions for client's request, client and +servers header and client and server data. It adds 3 additional +configuration commands: + +
+pcre TYPE FILTER_ACTION REGEXP [ACE]
+pcre_rewrite TYPE FILTER_ACTION REGEXP REWRITE_EXPRESSION [ACE]
+pcre_extend FILTER_ACTION [ACE]
+pcre_options OPTION1 [...]
+
+pcre - allows to apply some rule for matching +
pcre_rewrite - in addition to 'pcre' allows to substitute substrings +
pcre_extend - extends ACL of the last pcre or pcre_rewrite comand by +adding additional ACE (like with allow/deny configuration commands). +
pcre_options - allows to set matching options. Awailable options are: +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 + + + + +

Example:

+
+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
+
+ +

Download:

+ + 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.html b/doc/html/plugins/SSLPlugin.html new file mode 100644 index 0000000..008baa7 --- /dev/null +++ b/doc/html/plugins/SSLPlugin.html @@ -0,0 +1,34 @@ +

3proxy SSL/TLS plugin

+ +Plugin can be used to transparently decypher SSL/TLS data. Plugin should never be used in production environment due to +potential securiy reasons. + +
+ssl_certcache PATH_TO_CACHE
+ssl_mitm
+ssl_nomitm
+
+ssl_certcache - path to certificates cache. For transparent spoofing cache must contain 3 files: 3proxy.pem - public +self-signed certificates, 3proxy.key - key for public certificates, server.key - this key will be used to generates +spoofed certificates. +Generated certificates will be placed to the same path. +
ssl_mitm - spoof certificates for services started below +
ssl_nomitm - do not spoof certificates for services started below + + +

Example:

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

Download:

+ + +© Vladimir Dubrovin, License: BSD style 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.html b/doc/html/plugins/StringsPlugin.html new file mode 100644 index 0000000..de00c92 --- /dev/null +++ b/doc/html/plugins/StringsPlugin.html @@ -0,0 +1,16 @@ + +

3proxy strings substitution plugin

+May be used to make interface more pretty or to translate proxy server +messages to different language. All messages are taken from proxy.c and +moved to external text file (e.g. rus-win1251.3ps). On the moment of +writing there are 15 sections. Sections are delimited with "[end]". +

Example:

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

Download:

+ + +©Kirill Lopuchov \ No newline at end of file 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.html b/doc/html/plugins/TrafficPlugin.html new file mode 100644 index 0000000..dc4cb4b --- /dev/null +++ b/doc/html/plugins/TrafficPlugin.html @@ -0,0 +1,52 @@ +

3proxy traffic correction plugin

+3proxy logs and counts traffic on application level, while provider usually does +it on network or link level. It's significant if you use 3proxy for billing, +especially in case where network packets are small, e.g. network games. +

+This plugin attempts to correct 3proxy computations to approximate network or +link level traffic by using either fixed coefficients by port number or +attempting to predict number and sizes of network packets. +

Usage:

+
    +
  1. Extract TrafficPlugin.dll to the same folder with 3proxy executable. +
  2. Start plugin in 3proxy.cfg with +
    plugin TrafficPlugin.dll start
+
    +
  3. Add correction rules: +
    +FOR FIXED COEFFICIENTS MODE: +
    trafcorrect m <service> <target port> <coefficient>
+
    +where <service> - one of proxy, socks4, socks45, socks5, tcppm, udppm, pop3p, * matches "any". +
    <target port> - target port, * matches any +
    <coefficient> - coefficient to multiply traffic for this port. +
    +FOR PACKET HEADER PREDICTION MODE +
    trafcorrect p <service> <tcp/udp> <target port> [empty packet size]
+
    +tcp ot udp - transport level protocol to apply rule +
    +empty packet size - average size of "empty" packet, that is sum of average network/transport headers. +You can use network sniffer, such is Ethereal to discover it. Usually packet size +is 42 for UDP and +
    Modes can be mixed. +
    Plugin creates a list of rules, first matching rule will be applied. +
+For any mode plugin approximates traffic, logged or counted amount is not exact. +

Example:

+
plugin "TrafficPlugin.dll" start
+trafcorrect m socks5 6112 4.5
+trafcorrect m socks5 * 1.1
+
+wrong usage: +
trafcorrect m socks5 * 1.1
+trafcorrect m socks5 6112 4.5
+
+second rule will never be applied. +

Download:

+ + +©Maslov Michael aka Flexx(rus) + \ No newline at end of file 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. +
+

Загрузить:

+ + diff --git a/man/3proxy.8 b/man/3proxy.8 index 041ee3d..a6313a7 100644 --- a/man/3proxy.8 +++ b/man/3proxy.8 @@ -138,7 +138,7 @@ wget to automate this task. configuration file .SH BUGS Report all bugs to -.BR 3proxy@security.nnov.ru +.BR 3proxy@3proxy.ru .SH SEE ALSO 3proxy.cfg(3), proxy(8), ftppr(8), socks(8), pop3p(8), tcppm(8), udppm(8), kill(1), syslogd(8), diff --git a/man/3proxy.cfg.3 b/man/3proxy.cfg.3 index 763bbff..4977740 100644 --- a/man/3proxy.cfg.3 +++ b/man/3proxy.cfg.3 @@ -905,7 +905,9 @@ If Content-length (or another data length) is greater than given value, no data filtering will be performed thorugh filtering plugins to avoid data corruption and/or Content-Length chaging. Default is 1MB (1048576). - +.SH BUGS +Report all bugs to +.BR 3proxy@3proxy.ru .SH SEE ALSO 3proxy(8), proxy(8), ftppr(8), socks(8), pop3p(8), tcppm(8), udppm(8), syslogd(8), .br diff --git a/man/ftppr.8 b/man/ftppr.8 index fd25e46..f54c805 100644 --- a/man/ftppr.8 +++ b/man/ftppr.8 @@ -73,7 +73,7 @@ is user\'s login on this FTP server. Login itself may contain \'@\' sign. Only cleartext authentication is currently supported. .SH BUGS Report all bugs to -.BR 3proxy@security.nnov.ru +.BR 3proxy@3proxy.ru .SH SEE ALSO 3proxy(8), proxy(8), pop3p(8), socks(8), tcppm(8), udppm(8), syslogd(8), .br diff --git a/man/icqpr.8 b/man/icqpr.8 index 2de20f2..8ae0fd5 100644 --- a/man/icqpr.8 +++ b/man/icqpr.8 @@ -66,7 +66,7 @@ as a destination in client application. Connection is forwarded to .IR remote_host : remote_port .SH BUGS Report all bugs to -.BR 3proxy@security.nnov.ru +.BR 3proxy@3proxy.ru .SH SEE ALSO 3proxy(8), proxy(8), ftppr(8), socks(8), pop3p(8), udppm(8), syslogd(8), .br diff --git a/man/pop3p.8 b/man/pop3p.8 index bd6484b..78855fd 100644 --- a/man/pop3p.8 +++ b/man/pop3p.8 @@ -69,7 +69,7 @@ authentication (APOP, CRAM-MD5, etc) requires challenge from server before we know which server to connect. .SH BUGS Report all bugs to -.BR 3proxy@security.nnov.ru +.BR 3proxy@3proxy.ru .SH SEE ALSO 3proxy(8), ftppr(8), proxy(8), socks(8), tcppm(8), udppm(8), syslogd(8), .br diff --git a/man/proxy.8 b/man/proxy.8 index 5be0dd5..b9800c5 100644 --- a/man/proxy.8 +++ b/man/proxy.8 @@ -64,7 +64,7 @@ limit clients, use instead. .SH BUGS Report all bugs to -.BR 3proxy@security.nnov.ru +.BR 3proxy@3proxy.ru .SH SEE ALSO 3proxy(8), ftppr(8), socks(8), pop3p(8), tcppm(8), udppm(8), syslogd(8), .br diff --git a/man/smtpp.8 b/man/smtpp.8 index f63f27f..357f94c 100644 --- a/man/smtpp.8 +++ b/man/smtpp.8 @@ -70,7 +70,7 @@ authentication (CRAM-MD5, SPA, etc) requires challenge from server before we know which server to connect. .SH BUGS Report all bugs to -.BR 3proxy@security.nnov.ru +.BR 3proxy@3proxy.ru .SH SEE ALSO 3proxy(8), ftppr(8), proxy(8), socks(8), tcppm(8), udppm(8), syslogd(8), .br diff --git a/man/socks.8 b/man/socks.8 index 4e6f95a..11ce9b9 100644 --- a/man/socks.8 +++ b/man/socks.8 @@ -65,7 +65,7 @@ sufficient privileges). If you need to control access use instead. .SH BUGS Report all bugs to -.BR 3proxy@security.nnov.ru +.BR 3proxy@3proxy.ru .SH SEE ALSO 3proxy(8), proxy(8), ftppr(8), pop3p(8), tcppm(8), udppm(8), syslogd(8), .br diff --git a/man/tcppm.8 b/man/tcppm.8 index 2cd13f6..f412d91 100644 --- a/man/tcppm.8 +++ b/man/tcppm.8 @@ -59,7 +59,7 @@ as a destination in client application. Connection is forwarded to .IR remote_host : remote_port .SH BUGS Report all bugs to -.BR 3proxy@security.nnov.ru +.BR 3proxy@3proxy.ru .SH SEE ALSO 3proxy(8), proxy(8), ftppr(8), socks(8), pop3p(8), udppm(8), syslogd(8), .br diff --git a/man/udppm.8 b/man/udppm.8 index 819b836..6c4d444 100644 --- a/man/udppm.8 +++ b/man/udppm.8 @@ -65,7 +65,7 @@ as a destination in client application. All datagrams are forwarded to .IR remote_host : remote_port .SH BUGS Report all bugs to -.BR 3proxy@security.nnov.ru +.BR 3proxy@3proxy.ru .SH SEE ALSO 3proxy(8), proxy(8), ftppr(8), socks(8), pop3p(8), udppm(8), syslogd(8), .br diff --git a/src/version.h b/src/version.h index c83653e..a22a3c7 100644 --- a/src/version.h +++ b/src/version.h @@ -1,2 +1,2 @@ #define VERSION "3proxy-0.8-pre" -#define BUILDDATE "160113020317" +#define BUILDDATE "160113233318"