MAN page from PLD 3proxy-0.8.13-1.i686.rpm

3proxy

Section: Universal proxy server (8)
Updated: January 2016
Index

NAME

3proxy- 3[APA3A] tiny proxy server, or trivial proxy server, or free proxyserver

SYNOPSIS

3proxy[config_file]
3proxy[--install]
3proxy[--remove]

DESCRIPTION

3proxyis universal proxy server. It can be used to provide internal users wuthfully controllable access to external resources or to provide externalusers with access to internal resources. 3proxy is not developed to replacesquid(8),but it can extend functionality of existing cashing proxy.It can be used to route requests between different types of clients and proxyservers. Think about it as application levelgateway with configuration like hardware router has for network layer.It can establish multiplegateways with HTTP and HTTPS proxy with FTP over HTTP support, SOCKS v4,v4.5 and v5, POP3 proxy, UDP and TCP portmappers. Each gateway is startedfrom configuration file like independant service proxy(8)socks(8)pop3p(8)tcppm(8)udppm(8)ftppr(8)dnsprbut3proxyis not a kind of wrapper or superserver for this daemons. It just has samecode compiled in, but provides much more functionality. SOCKSv5implementatation allows to use 3proxy with any UDP or TCP based clientapplications designed withoutproxy support (withSocksCAP,FreeCAPor another client-side redirector under Windows of with socksification libraryunder Unix). So you can play your favourite games, listen music, exchangefiles and messages and even accept incoming connections behind proxy server.

dnsprdoes not exist as independant service. It' DNS caching proxy (it requiresnscacheandnserverto be set in configuration. Only A-records are cached. Please note, thethis caching is mostly a 'hack' and has nothing to do with realDNS server, but it works perfectly for SOHO networks.

3proxy supports access control lists (ACL) like network router. Sourceand destination networks and destination port can be specified. In addition,usernames and gateway action (for example GET or POST) can be used in ACLs.In order to filter request on username basis user must be authenticated somehow. There are fewauthentication types including password authentication and authentication byNetBIOS name for Windows clients (it's very like ident authentication).Depending on ACL action request can be allowed, denied or redirected to anotherhost or to another proxy server or even to a chain of proxy servers.

It supports different types of logging: to logfiles, syslog(3)(only under Unix) or to ODBC database. Logging format is turnable to providecompatibility with existing log file parsers. It makes it possible to use3proxy with IIS, ISA, Apache or Squid log parsers.

OPTIONS

config_file: Name of config file. See3proxy.cfg(3)for configuration file format. Under Windows, if config_file is not specified,3proxylooks for file named3proxy.cfgin the default location (in same directory with executable file and in currentdirectory). Under Unix, if no config file is specified, 3proxy readsconfiguration from stdin. It makes it possible to use 3proxy.cfg file asexecutable script just by setting +x mode and adding
#!/usr/local/3proxy/3proxy
as a first line in 3proxy.cfg
--install: (Windows NT family only) install 3proxyas a system service
--remove: (Windows NT family only) remove3proxyfrom system services

SIGNALS

Under Unix there are few signals3proxycatches. Seekill(1).

SIGTERM: cleanup connections and exit
SIGPAUSE: stop to accept new connections, on second signal - start and re-readconfiguration
SIGCONT: start to accept new conenctions
SIGUSR1: reload configuration

Under Windows, if3proxyis installed as service you can standard service management to start, stop,pause and continue 3proxy service, for example:
net start 3proxy
net stop 3proxy
net pause 3proxy
net continue 3proxy

Web admin service can also be used to reload configuration. Usewget to automate this task.

FILES

/usr/local/3proxy/3proxy.cfg (3proxy.cfg): 3proxyconfiguration file

BUGS

Report all bugs to3proxyAATT3proxy.ru

TRIVIA

3APA3A is pronounced as ``zaraza''.

AUTHORS

3proxy is designed by Vladimir 3APA3A Dubrovin(3proxyAATT3proxy.ru)

This document was created byman2html,using the manual pages.