代理服务器

开发平台：
Unix_Linux

socks5.1：源码内容
							.TH socks5 1 "7 Oct 1998"
.SH NAME
.HP 9
socks5 - A daemon that implements the SOCKS v5 protocol to execute proxy requests for a client
.SH SYNOPSIS
socks5 fI[options]fP
.SH DESCRIPTION
socks5 is a proxy server that implements the SOCKS v5 protocol. As a proxy server, socks5 authenticates, authorizes, and processes network requests for clients. It establishes connections to application hosts for client applications. When the client attempts to access the network, the client connects to the socks5 daemon instead of the application host. 
.PP
Following authentication, clients request that socks5 perform network activities for the client. The activities might include bind, connect, sendto, ping, or traceroute. The socks5 protocol is independent of application protocols, and can assist with different networking services, including telnet, ftp, finger, whois, gopher, and WWW access.
.PP
The socks5 daemon supports two authentication methods:
.RS 3 
.HP 21
Username/Password -  Refer to socks5.passwd(5) for additional information.
.HP 13
Kerberos 5 - Requires that you build socks5 with the Kerberos libraries. For additional information about using Kerberos 5 (GSS-API) authentication, please refer to the Kerberos man page. 
.RE
.PP
socks5 can run:
.RS 3
standalone -  the default
.TP
preforking -  include the -p option
.HP 14
threaded -    if your operating system supports POSIX threads and you configure socks5 with the --with-threads option. Include the -t option to run socks5 in threaded mode. All operating systems impose limits on the number of threads and open file descriptors per process.
.TP
through inetd - include the -i option
.RE
.PP
You can control some aspects of how the socks5 daemon works through the configuration file, environment variables, and options. Refer to the socks5.conf(5) documentation for additional information about the socks5 configuration file. The settings in the configuration file take precedence over the environment variable and option settings. The environment variable settings take precedence over the option settings. 
.SH OPTIONS
Separate multiple options with white space.
.TP
-b [fIhost:portfP]| --bindintfc [fIhost:portfP]
fIhost:portfP specifies the host and the port number on that host on which socks5 runs, instead of the default port. When you omit fIhostfP, socks5 uses 0.0.0.0 as the fIhostfP value.
.TP
-d fI[val]fP |--debug fI[val]fP
Turn on debug mode and optionally set the debug level to fIvalfP. If you omit fIvalfP, socks5 sends only warning messages. Valid values for fIvalfP are 1, 2, and 3. If you specify other values, socks5 assumes 3. Valid values and their meanings are:
.RS 8
.HP 14
1
LOG_NOTICE  Reports non-error conditions that may require special handling
.HP 14
2
LOG_INFO    Reports informational messages
.HP 14
3
LOG_DEBUG   Reports information useful for debugging
.RE
.TP
-f  |--foreground 
Run in the foreground, and prevent dissociation from the parent shell when running standalone. --foreground is most useful for debugging when you start and stop the daemon frequently.
.TP
-i |--inetd
Run socks5 through inetd.
.TP
-n  fIvalfP |--nchildren fIvalfP
Set the maximum number of child processes that can exist at one time to fIvalfP.
.PP
.RS 5
socks5 presets the maximum number of child processes to 64. Use this option to lower that preset value. You cannot set the maximum number of child processes to a value that exceeds the operating system limit.
.PP
socks5 ignores this value in threaded mode, and it is not useful in oneshot and inetd mode.
.RE
.TP
-o |--oneshot
Service one request in the foreground, turn on debugging, send output to stderr, and exit. The oneshot option is most useful during debugging.
.TP
-p |--prefork
Run socks5 as a preforking process. Also include the --nchildren option to control the number of forked processes.
.TP
-s |--stderr
Log all output to stderr only, instead of the syslog. Logging output to stderr is most useful in debug mode, which generates more output.
.TP
-t | --threaded
Run socks5 in threaded mode, if your operating system supports POSIX threads and you built socks5 with the --with-threads option. When threaded mode is not available, socks5 prints a warning and reverts to standalone mode.
.TP
-v |--version
Print a message containing the current socks5 version to stderr.
.PP
.SH ENVIRONMENT
Environment variables control how socks5 operates. Set them in the environment, or include them in the configuration file. When the environment and the configuration file contain conflicting settings, the configuration files has precedence over the environment. 
To set the variables in the configuration file, use the syntax:
.PP
.RS 5
set fIvariable [value]fP
.RE
.TP
SOCKS5_BINDINTFC fIhost:portfP
fIhost:portfP specifies the host and the port number on that host on which socks5 runs, instead of the default port. When you omit fIhostfP, socks5 uses 0.0.0.0 as the fIhostfP value.
.TP
SOCKS5_CONFFILE fIfilenamefP
fIfilenamefP specifies the configuration file. In most systems, the default is /etc/socks5.conf. Set the environment before running socks5. With multiple socks5 daemons, use a different configuration file for each daemon.
.TP
SOCKS5_DEMAND_IDENT
Cause No authentication to fail when the client fails to respond to an ident request. Use SOCKS5_DEMAND_IDENT to ensure that each connection has an associated username.
.TP 
SOCKS5_ENCRYPT
Request that the next socks5 process encrypt the data, if possible. SOCKS5_ENCRYPT is only useful when the socks5 build includes GSS-API authentication.
.TP
SOCKS5_FORCE_ENCRYPT
Force the client to encrypt the data when the authentication method supports encryption.
.TP 
SOCKS5_IDENTFILE fIfilenamefP
fIfilenamefP specifies the filename that stores the ident information. In most systems, the default is /tmp/socks5.ident. SOCKS5_IDENTFILE is most useful with multiple socks5 daemons.
.TP
SOCKS5_MAXCHILD fIvalfP
fIvalfP specifies the maximum number of child processes that can exist at one time.
.RS 5
.PP
socks5 presets the maximum number of child processes to 64. Use this environment variable to lower that preset value. You cannot set the maximum number of child processes to a value that exceeds the operating system limit.
.PP
socks5 ignores this value in threaded mode, and it is not useful in oneshot and inetd mode.
.RE
.TP
SOCKS5_NOIDENT
Omit ident requests. Use SOCKS5_NOIDENT to reduce timeouts when you are certain clients are not running identd's.
.TP
SOCKS5_NOINTCHK
Request that the next socks5 process perform the proxy request without integrity checking. SOCKS5_NOINTCHK is only useful when the socks5 build includes GSS-API authentication.
.TP
SOCKS5_NONETMASKCHECK
Instruct the daemon to disregard checking the server host's netmask. By default, the daemon checks the netmask and connects directly to hosts on the same subnet before consulting the configuration file.
.TP
SOCKS5_REVERSEMAP
Always attempt to map addresses to hostnames.  By default, socks5 only maps when hostnames or domains are used in the configuration file.  When set, the log file will contain hostnames, but degrades performance.
.TP 
SOCKS5_SERVICENAME
Always map port numbers to service names. By default, socks5 only maps when services are used in the configuration file.  When set, the log file will contain services, but degrades performance. 
.TP
SOCKS5_PASSWD [fIpasswordfP]
Specify the password for Username/Password authentication when the socks5 daemon connects to another socks server.
.TP
SOCKS5_PIDFILE fIfilenamefP
Specify the filename that stores the socks5 process ID. socks5 stores the PID in /tmp/socks5.pid. You can run socks5 on a port other than the default port by including the --bindintfc command line option or setting the SOCKS5_BINDINTFC environment variable. When you run socks5 on a port other than the default port, socks5 stores the PID in /tmp/socks5.pid-port. Use SOCKS5_PIDFILE to specify an alternate filename.
.TP
SOCKS5_PWDFILE fIfilenamefP
Specify the password file. In most systems, the default is /etc/socks5.passwd.
.TP
SOCKS5_TIMEOUT fIminutesfP
fIminutesfP specifies the maximum number of minutes the connection remains idle. After fIminutesfP number of minutes, socks5 disconnects. When you omit SOCKS5_TIMEOUT, socks5 disconnects after the connection is idle for 15 minutes.
.TP
SOCKS5_UDPPORTRANGE fIport1-port2fP
Specify a range of UDP ports. fIport1-port2fP specifies a range of UDP ports that socks5 uses to send UDP packets.
.TP
SOCKS5_USER [fIuser idfP]
Specify the username for Username/Password authentication when the socks5 daemon connects to another socks server.
.PP
.SH REQUEST FOR COMMENTS
.TP
RFC1928
SOCKS protocol Version 5
.TP
RFC1929
Username/Password Authentication for SOCKS V5
.TP
RFC1961
GSS-API Authentication Method for SOCKS Version 5
.PP
.SH SEE ALSO
socks5.conf(5)
.PP
.SH AUTHOR
NWSL SOCKS5 Development Team
.br
Send comments to socks5-comments@socks.nec.com

						