http-proxy-to-socks

简介

hpts(http-proxy-to-socks) is a nodejs tool to convert SOCKS proxy into http proxy.

Many clients support setting up http proxy to speed up network requests and for sometimes only SOCKS proxy is available to you. SOCKS proxy supports TCP so that it's possible to convert those requests from http proxy into SOCKS protocol. In this way, you can still keep the goodness provided by your SOCKS proxy(e.g. encryption).

Setup

npm install -g http-proxy-to-socks

Make sure your nodejs version is greater than 4.

Usage

hpts -s 127.0.0.1:1080 -p 8080

This will start a process listening on 8080 as a http proxy. It will convert http requests into socks requests and send them to port 1080. Please make sure your socks service is available at the corresponding port.

Other options:

Options:
  -V, --version          output the version number
  -s, --socks [socks]    specify your socks proxy host, default: 127.0.0.1:1080
  -p, --port [port]      specify the listening port of http proxy server, default: 8080
  -l, --host [host]      specify the listening host of http proxy server, default: 127.0.0.1
  -c, --config [config]  read configs from file in json format
  --level [level]        log level, vals: info, error
  -h, --help             output usage information

You can specify a json config file with -c:

{
  "socks": "127.0.0.1:1080",
  "port": 8080
}

CONTRIBUTE

Please add more tests for corresponding features when you send a PR:

npm run test

License

MIT

CHANGELOG

1.1.3, 1.1.4

• chore: keep header cases

1.1.1

• src: Use parsed url hostname instead of host which may contain also port

1.1.0

• src: Support setting local address of the http-service.
• src: Format timestamp of logs.

1.0.4

• src: Support setting the --level option in createServer().

1.0.3

• src: Bind error event on sockets to prevent servers from exiting in some node runtimes.

1.0.2

• Exports "main" fields in package.json.