117 lines
3.2 KiB
Plaintext
117 lines
3.2 KiB
Plaintext
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.
|