SOCKS/HTTP/HTTPS proxy implementation in node.js
===============================
A simple SOCKS/HTTP/HTTPS proxy implementation and demo proxy in `node.js
It supports both socks5/socks4/socks4a/http/https proxy
You can run it easily as::
./test/socksproxy5.js
./test/socksproxy4.js
./test/httpproxy.js
under windows you can run run.vbs
This will create a proxy socks5 at “127.0.0.1“ on port “8888“.
This will create a proxy socks4 socks4a at “127.0.0.1“ on port “9999“.
This will create a proxy http https at “127.0.0.1“ on port “8080“.
You can use this as a good starting point for writing a proxy or a tunnel!
Features
* Supports SOCKS v4, v4a, and v5 proxy.
* Supports HTTP/HTTPS proxy.
* Supports the CONNECT, BIND, and ASSOCIATE for SOCKS v5.
* Supports user/pass authentication.
* Supports Banned IPs.
Installation
`npm install @sansamour/node-socks`
Usage
// TypeScript
import { http, socks4, socks5 } from '@sansamour/node-socks';
// ES6 JavaScript
import { http, socks4, socks5 } from '@sansamour/node-socks';
// Legacy JavaScript
const socks5 = require('@sansamour/node-socks').socks5;
Quick Start Example
Create SOCKS v5 server: socks5://user:pass@127.0.0.1:9999 with file banned IPs `ip.txt` (semicolon separated)
const { socks5 } = require('@sansamour/node-socks')
socks5.createServer({
authorization: function(u,p){
return u == 'user' && p == 'pass'
},
port: 9999,
fileBannedIPs: './ip.txt'
});
With SOCKS v4/v4a proxy server support only Username Authentication (no Password).
Create SOCKS v4/v4a server: socks4://user:anypass@127.0.0.1:8888 with file banned IPs `ip.txt` (semicolon separated)
const { socks4 } = require('@sansamour/node-socks')
socks4.createServer({
authorization:function(u){
return u == 'user'
},
port: 8888,
fileBannedIPs: './ip.txt'
});
Further Reading:
Please read the SOCKS 5 specifications for more information on how to use Associate.
http://www.ietf.org/rfc/rfc1928.txt
License
This work is licensed under the [MIT license](http://en.wikipedia.org/wiki/MIT_License).
