HTTP-Proxy2Socksv5 User Manual
------------------------------


The software is a module for Apache HTTP server that allows redirecting of 
outgoing HTTP and HTTPS requests through SOCKS5 proxy server. It is based on 
mod_proxy and mod_proxy_connect.


1. Installation

	1.	Install Apache HTTP server 
	2.	Copy (and overwrite if needed) mod_proxy.so and mod_proxy_connect.so 
		files into the modules folder of the Apache installation path. 
	3.	Edit httpd.conf to allow HTTP proxy functionality and SOCKS5 redirection.

2. Configuration

	1. Available options

	All the configuration of the new functionality is accessible via Apache 
	configuration file – conf/httpd.conf. 
	If an option is missing in the conf-file – the default value is set. 
	Available options are:

	ProxySocks 
	Available values: 	On, Off
	Default value: 		Off
	Description: 		Turns on or off SOCKS5 functionality.

	ProxySocksIp 	
	Available values: 	IPv4 address
	Default value: 		127.0.0.1
	Description:		IP address of the SOCKS5 proxy server.

	ProxySocksPort 
	Available values: 	1- 65535
	Default value: 		1080
	Description:		Port number of the SOCKS5 proxy server.

	ProxySocksDnsMode
	Available values: 	Remote, Local
	Default value: 		Remote
	Description:		Sets the mode of hostname resolution. To pass DNS 
						queries through SOCKS5 proxy use Remote mode.

	ProxySocksAuth
	Available values: 	On, Off
	Default value: 		Off
	Description:		Enables Username/Password authentication (RFC1929) on 
						the SOCKS5 proxy.

	ProxySocksUsername 
	Available values: 	String
	Default value: 		Empty string
	Description:		Username to login on SOCKS5 proxy.

	ProxySocksPassword 
	Available values: 	String
	Default value: 		Empty string
	Description:		Password to login on SOCKS5 proxy.




	2. Sample configuration
	
	In the following sample outgoing HTTP and HTTPS connections will be 
	redirected through SOCKS5 proxy server running on 127.0.0.1:1080. DNS 
	queries go through the proxy unchanged. testusername and testpassword are 
	used for the authorization on the proxy.

	ProxySocks On
	ProxySocksIp 		127.0.0.1
	ProxySocksPort 	1080

	ProxySocksDnsMode Remote

	ProxySocksAuth On
	ProxySocksUsername testusername
	ProxySocksPassword testpassword


	3. Original mod_proxy configuration options

	All configuration options of mod_proxy and mod_proxy_connect stay unchanged 
	and effective. For more information please see: 
	http://httpd.apache.org/docs/current/mod/mod_proxy.html

	The following sample configuration enables Apache HTTP server to act as 
	HTTP/HTTPS proxy server and accepts connections from 127.0.0.1 and 
	192.168.1.1

	LoadModule proxy_module modules/mod_proxy.so
	LoadModule proxy_connect_module modules/mod_proxy_connect.so
	LoadModule proxy_http_module modules/mod_proxy_http.so

	ProxyRequests On
	ProxyVia On

	<Proxy *>
	Order deny,allow
	Deny from all
	Allow from 127.0.0.1, 192.168.1.1
	</Proxy>


3. Troubleshooting

	All SOCKS5 related diagnose and error messages are outputted using the 
	standard Apache approach. For error messages please see logs/error.log
	It may be useful to add “LogLevel debug” to the end of httpd.conf file for 
	more verbose output.

4. Please remember that by default only port 443 is enabled for HTTPS 
	connections. Please use AllowCONNECT directive to enable other ports.