3proxy(8)

13proxy(8)                   Universal proxy server                   3proxy(8)
2
3
4

NAME

6       3proxy  -  3[APA3A] tiny proxy server, or trivial proxy server, or free
7       proxy server
8

SYNOPSIS

10       3proxy [config_file]
11       3proxy [--install]
12       3proxy [--remove]
13

DESCRIPTION

15       3proxy is universal proxy server. It can be used  to  provide  internal
16       users  wuth  fully controllable access to external resources or to pro‐
17       vide external users with access to internal resources.  3proxy  is  not
18       developed  to  replace  squid(8),  but  it  can extend functionality of
19       existing cashing proxy.  It can be used to route requests between  dif‐
20       ferent  types  of clients and proxy servers. Think about it as applica‐
21       tion level gateway with configuration like hardware router has for net‐
22       work  layer.   It  can  establish multiple gateways with HTTP and HTTPS
23       proxy with FTP over HTTP support, SOCKS v4, v4.5 and  v5,  POP3  proxy,
24       UDP  and  TCP  portmappers.  Each gateway is started from configuration
25       file like  independant  service  proxy(8)  socks(8)  pop3p(8)  tcppm(8)
26       udppm(8)  ftppr(8)  dnspr but 3proxy is not a kind of wrapper or super‐
27       server for this daemons. It just has same code compiled  in,  but  pro‐
28       vides  much  more functionality. SOCKSv5 implementatation allows to use
29       3proxy with any UDP or TCP based client applications  designed  without
30       proxy support (with SocksCAP, FreeCAP or another client-side redirector
31       under Windows of with socksification library under Unix).  So  you  can
32       play  your  favourite  games, listen music, exchange files and messages
33       and even accept incoming connections behind proxy server.
34
35       dnspr does not exist as independant service. It´ DNS caching proxy  (it
36       requires nscache and nserver to be set in configuration. Only A-records
37       are cached. Please note, the this caching is mostly a  'hack'  and  has
38       nothing  to  do  with  real DNS server, but it works perfectly for SOHO
39       networks.
40
41
42       3proxy supports access control lists (ACL) like network router.  Source
43       and  destination  networks  and  destination  port can be specified. In
44       addition, usernames and gateway action (for example GET or POST) can be
45       used  in  ACLs.  In order to filter request on username basis user must
46       be authenticated somehow. There are few authentication types  including
47       password  authentication and authentication by NetBIOS name for Windows
48       clients (it´s very like ident authentication).  Depending on ACL action
49       request  can  be  allowed,  denied  or redirected to another host or to
50       another proxy server or even to a chain of proxy servers.
51
52       It supports different types of logging: to  logfiles,  syslog(3)  (only
53       under  Unix) or to ODBC database. Logging format is turnable to provide
54       compatibility with existing log file parsers. It makes it  possible  to
55       use 3proxy with IIS, ISA, Apache or Squid log parsers.
56

OPTIONS

58       config_file
59              Name  of  config  file. See 3proxy.cfg(3) for configuration file
60              format. Under Windows, if config_file is not  specified,  3proxy
61              looks for file named 3proxy.cfg in the default location (in same
62              directory with executable file and in current directory).  Under
63              Unix, if no config file is specified, 3proxy reads configuration
64              from stdin. It makes it possible to use 3proxy.cfg file as  exe‐
65              cutable script just by setting +x mode and adding
66              #!/etc/3proxy
67              as a first line in 3proxy.cfg
68
69       --install
70              (Windows NT family only) install 3proxy as a system service
71
72       --remove
73              (Windows NT family only) remove 3proxy from system services
74

SIGNALS

76       Under Unix there are few signals 3proxy catches. See kill(1).
77
78       SIGTERM
79              cleanup connections and exit
80
81       SIGPAUSE
82              stop to accept new connections, on second signal - start and re-
83              read configuration
84
85       SIGCONT
86              start to accept new conenctions
87
88       SIGUSR1
89              reload configuration
90
91       Under Windows, if 3proxy is installed as service you can standard  ser‐
92       vice  management to start, stop, pause and continue 3proxy service, for
93       example:
94       net start 3proxy
95       net stop 3proxy
96       net pause 3proxy
97       net continue 3proxy
98
99       Web admin service can also be used to reload configuration. Use wget to
100       automate this task.
101

FILES

103       /etc/3proxy.cfg (3proxy.cfg)
104              3proxy configuration file
105

BUGS

107       Report all bugs to 3proxy@security.nnov.ru
108

TRIVIA

115       3APA3A is pronounced as ``zaraza´´.
116

AUTHORS

118       3proxy  is  designed  by  3APA3A  (3APA3A@security.nnov.ru),   Vladimir
119       Dubrovin (vlad@sandy.ru)
120
121
122
1233proxy 0.6                         July 2009                         3proxy(8)