mirror of
https://github.com/abrendan/l00kup.git
synced 2025-08-25 05:52:07 +02:00
Initial commit
This commit is contained in:
Brendan
11
node_modules/socks/.eslintrc.cjs
generated
vendored
Normal file
11
node_modules/socks/.eslintrc.cjs
generated
vendored
Normal file
@@ -0,0 +1,11 @@
|
||||
module.exports = {
|
||||
root: true,
|
||||
parser: '@typescript-eslint/parser',
|
||||
plugins: [
|
||||
'@typescript-eslint',
|
||||
],
|
||||
extends: [
|
||||
'eslint:recommended',
|
||||
'plugin:@typescript-eslint/recommended',
|
||||
],
|
||||
};
|
||||
7
node_modules/socks/.prettierrc.yaml
generated
vendored
Normal file
7
node_modules/socks/.prettierrc.yaml
generated
vendored
Normal file
@@ -0,0 +1,7 @@
|
||||
parser: typescript
|
||||
printWidth: 80
|
||||
tabWidth: 2
|
||||
singleQuote: true
|
||||
trailingComma: all
|
||||
arrowParens: always
|
||||
bracketSpacing: false
|
||||
20
node_modules/socks/LICENSE
generated
vendored
Normal file
20
node_modules/socks/LICENSE
generated
vendored
Normal file
@@ -0,0 +1,20 @@
|
||||
The MIT License (MIT)
|
||||
|
||||
Copyright (c) 2013 Josh Glazebrook
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
this software and associated documentation files (the "Software"), to deal in
|
||||
the Software without restriction, including without limitation the rights to
|
||||
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
686
node_modules/socks/README.md
generated
vendored
Normal file
686
node_modules/socks/README.md
generated
vendored
Normal file
@@ -0,0 +1,686 @@
|
||||
# socks [](https://travis-ci.org/JoshGlazebrook/socks) [](https://coveralls.io/github/JoshGlazebrook/socks?branch=v2)
|
||||
|
||||
Fully featured SOCKS proxy client supporting SOCKSv4, SOCKSv4a, and SOCKSv5. Includes Bind and Associate functionality.
|
||||
|
||||
> Looking for Node.js agent? Check [node-socks-proxy-agent](https://github.com/TooTallNate/node-socks-proxy-agent).
|
||||
|
||||
### Features
|
||||
|
||||
* Supports SOCKS v4, v4a, v5, and v5h protocols.
|
||||
* Supports the CONNECT, BIND, and ASSOCIATE commands.
|
||||
* Supports callbacks, promises, and events for proxy connection creation async flow control.
|
||||
* Supports proxy chaining (CONNECT only).
|
||||
* Supports user/password authentication.
|
||||
* Supports custom authentication.
|
||||
* Built in UDP frame creation & parse functions.
|
||||
* Created with TypeScript, type definitions are provided.
|
||||
|
||||
### Requirements
|
||||
|
||||
* Node.js v10.0+ (Please use [v1](https://github.com/JoshGlazebrook/socks/tree/82d83923ad960693d8b774cafe17443ded7ed584) for older versions of Node.js)
|
||||
|
||||
### Looking for v1?
|
||||
* Docs for v1 are available [here](https://github.com/JoshGlazebrook/socks/tree/82d83923ad960693d8b774cafe17443ded7ed584)
|
||||
|
||||
## Installation
|
||||
|
||||
`yarn add socks`
|
||||
|
||||
or
|
||||
|
||||
`npm install --save socks`
|
||||
|
||||
## Usage
|
||||
|
||||
```typescript
|
||||
// TypeScript
|
||||
import { SocksClient, SocksClientOptions, SocksClientChainOptions } from 'socks';
|
||||
|
||||
// ES6 JavaScript
|
||||
import { SocksClient } from 'socks';
|
||||
|
||||
// Legacy JavaScript
|
||||
const SocksClient = require('socks').SocksClient;
|
||||
```
|
||||
|
||||
## Quick Start Example
|
||||
|
||||
Connect to github.com (192.30.253.113) on port 80, using a SOCKS proxy.
|
||||
|
||||
```javascript
|
||||
const options = {
|
||||
proxy: {
|
||||
host: '159.203.75.200', // ipv4 or ipv6 or hostname
|
||||
port: 1080,
|
||||
type: 5 // Proxy version (4 or 5)
|
||||
},
|
||||
|
||||
command: 'connect', // SOCKS command (createConnection factory function only supports the connect command)
|
||||
|
||||
destination: {
|
||||
host: '192.30.253.113', // github.com (hostname lookups are supported with SOCKS v4a and 5)
|
||||
port: 80
|
||||
}
|
||||
};
|
||||
|
||||
// Async/Await
|
||||
try {
|
||||
const info = await SocksClient.createConnection(options);
|
||||
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy server)
|
||||
} catch (err) {
|
||||
// Handle errors
|
||||
}
|
||||
|
||||
// Promises
|
||||
SocksClient.createConnection(options)
|
||||
.then(info => {
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy server)
|
||||
})
|
||||
.catch(err => {
|
||||
// Handle errors
|
||||
});
|
||||
|
||||
// Callbacks
|
||||
SocksClient.createConnection(options, (err, info) => {
|
||||
if (!err) {
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy server)
|
||||
} else {
|
||||
// Handle errors
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
## Chaining Proxies
|
||||
|
||||
**Note:** Chaining is only supported when using the SOCKS connect command, and chaining can only be done through the special factory chaining function.
|
||||
|
||||
This example makes a proxy chain through two SOCKS proxies to ip-api.com. Once the connection to the destination is established it sends an HTTP request to get a JSON response that returns ip info for the requesting ip.
|
||||
|
||||
```javascript
|
||||
const options = {
|
||||
destination: {
|
||||
host: 'ip-api.com', // host names are supported with SOCKS v4a and SOCKS v5.
|
||||
port: 80
|
||||
},
|
||||
command: 'connect', // Only the connect command is supported when chaining proxies.
|
||||
proxies: [ // The chain order is the order in the proxies array, meaning the last proxy will establish a connection to the destination.
|
||||
{
|
||||
host: '159.203.75.235', // ipv4, ipv6, or hostname
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
{
|
||||
host: '104.131.124.203', // ipv4, ipv6, or hostname
|
||||
port: 1081,
|
||||
type: 5
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
// Async/Await
|
||||
try {
|
||||
const info = await SocksClient.createConnectionChain(options);
|
||||
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy servers)
|
||||
|
||||
console.log(info.socket.remoteAddress) // The remote address of the returned socket is the first proxy in the chain.
|
||||
// 159.203.75.235
|
||||
|
||||
info.socket.write('GET /json HTTP/1.1\nHost: ip-api.com\n\n');
|
||||
info.socket.on('data', (data) => {
|
||||
console.log(data.toString()); // ip-api.com sees that the last proxy in the chain (104.131.124.203) is connected to it.
|
||||
/*
|
||||
HTTP/1.1 200 OK
|
||||
Access-Control-Allow-Origin: *
|
||||
Content-Type: application/json; charset=utf-8
|
||||
Date: Sun, 24 Dec 2017 03:47:51 GMT
|
||||
Content-Length: 300
|
||||
|
||||
{
|
||||
"as":"AS14061 Digital Ocean, Inc.",
|
||||
"city":"Clifton",
|
||||
"country":"United States",
|
||||
"countryCode":"US",
|
||||
"isp":"Digital Ocean",
|
||||
"lat":40.8326,
|
||||
"lon":-74.1307,
|
||||
"org":"Digital Ocean",
|
||||
"query":"104.131.124.203",
|
||||
"region":"NJ",
|
||||
"regionName":"New Jersey",
|
||||
"status":"success",
|
||||
"timezone":"America/New_York",
|
||||
"zip":"07014"
|
||||
}
|
||||
*/
|
||||
});
|
||||
} catch (err) {
|
||||
// Handle errors
|
||||
}
|
||||
|
||||
// Promises
|
||||
SocksClient.createConnectionChain(options)
|
||||
.then(info => {
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy server)
|
||||
|
||||
console.log(info.socket.remoteAddress) // The remote address of the returned socket is the first proxy in the chain.
|
||||
// 159.203.75.235
|
||||
|
||||
info.socket.write('GET /json HTTP/1.1\nHost: ip-api.com\n\n');
|
||||
info.socket.on('data', (data) => {
|
||||
console.log(data.toString()); // ip-api.com sees that the last proxy in the chain (104.131.124.203) is connected to it.
|
||||
/*
|
||||
HTTP/1.1 200 OK
|
||||
Access-Control-Allow-Origin: *
|
||||
Content-Type: application/json; charset=utf-8
|
||||
Date: Sun, 24 Dec 2017 03:47:51 GMT
|
||||
Content-Length: 300
|
||||
|
||||
{
|
||||
"as":"AS14061 Digital Ocean, Inc.",
|
||||
"city":"Clifton",
|
||||
"country":"United States",
|
||||
"countryCode":"US",
|
||||
"isp":"Digital Ocean",
|
||||
"lat":40.8326,
|
||||
"lon":-74.1307,
|
||||
"org":"Digital Ocean",
|
||||
"query":"104.131.124.203",
|
||||
"region":"NJ",
|
||||
"regionName":"New Jersey",
|
||||
"status":"success",
|
||||
"timezone":"America/New_York",
|
||||
"zip":"07014"
|
||||
}
|
||||
*/
|
||||
});
|
||||
})
|
||||
.catch(err => {
|
||||
// Handle errors
|
||||
});
|
||||
|
||||
// Callbacks
|
||||
SocksClient.createConnectionChain(options, (err, info) => {
|
||||
if (!err) {
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy server)
|
||||
|
||||
console.log(info.socket.remoteAddress) // The remote address of the returned socket is the first proxy in the chain.
|
||||
// 159.203.75.235
|
||||
|
||||
info.socket.write('GET /json HTTP/1.1\nHost: ip-api.com\n\n');
|
||||
info.socket.on('data', (data) => {
|
||||
console.log(data.toString()); // ip-api.com sees that the last proxy in the chain (104.131.124.203) is connected to it.
|
||||
/*
|
||||
HTTP/1.1 200 OK
|
||||
Access-Control-Allow-Origin: *
|
||||
Content-Type: application/json; charset=utf-8
|
||||
Date: Sun, 24 Dec 2017 03:47:51 GMT
|
||||
Content-Length: 300
|
||||
|
||||
{
|
||||
"as":"AS14061 Digital Ocean, Inc.",
|
||||
"city":"Clifton",
|
||||
"country":"United States",
|
||||
"countryCode":"US",
|
||||
"isp":"Digital Ocean",
|
||||
"lat":40.8326,
|
||||
"lon":-74.1307,
|
||||
"org":"Digital Ocean",
|
||||
"query":"104.131.124.203",
|
||||
"region":"NJ",
|
||||
"regionName":"New Jersey",
|
||||
"status":"success",
|
||||
"timezone":"America/New_York",
|
||||
"zip":"07014"
|
||||
}
|
||||
*/
|
||||
});
|
||||
} else {
|
||||
// Handle errors
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
## Bind Example (TCP Relay)
|
||||
|
||||
When the bind command is sent to a SOCKS v4/v5 proxy server, the proxy server starts listening on a new TCP port and the proxy relays then remote host information back to the client. When another remote client connects to the proxy server on this port the SOCKS proxy sends a notification that an incoming connection has been accepted to the initial client and a full duplex stream is now established to the initial client and the client that connected to that special port.
|
||||
|
||||
```javascript
|
||||
const options = {
|
||||
proxy: {
|
||||
host: '159.203.75.235', // ipv4, ipv6, or hostname
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
|
||||
command: 'bind',
|
||||
|
||||
// When using BIND, the destination should be the remote client that is expected to connect to the SOCKS proxy. Using 0.0.0.0 makes the Proxy accept any incoming connection on that port.
|
||||
destination: {
|
||||
host: '0.0.0.0',
|
||||
port: 0
|
||||
}
|
||||
};
|
||||
|
||||
// Creates a new SocksClient instance.
|
||||
const client = new SocksClient(options);
|
||||
|
||||
// When the SOCKS proxy has bound a new port and started listening, this event is fired.
|
||||
client.on('bound', info => {
|
||||
console.log(info.remoteHost);
|
||||
/*
|
||||
{
|
||||
host: "159.203.75.235",
|
||||
port: 57362
|
||||
}
|
||||
*/
|
||||
});
|
||||
|
||||
// When a client connects to the newly bound port on the SOCKS proxy, this event is fired.
|
||||
client.on('established', info => {
|
||||
// info.remoteHost is the remote address of the client that connected to the SOCKS proxy.
|
||||
console.log(info.remoteHost);
|
||||
/*
|
||||
host: 67.171.34.23,
|
||||
port: 49823
|
||||
*/
|
||||
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (This is a raw net.Socket that is a connection between the initial client and the remote client that connected to the proxy)
|
||||
|
||||
// Handle received data...
|
||||
info.socket.on('data', data => {
|
||||
console.log('recv', data);
|
||||
});
|
||||
});
|
||||
|
||||
// An error occurred trying to establish this SOCKS connection.
|
||||
client.on('error', err => {
|
||||
console.error(err);
|
||||
});
|
||||
|
||||
// Start connection to proxy
|
||||
client.connect();
|
||||
```
|
||||
|
||||
## Associate Example (UDP Relay)
|
||||
|
||||
When the associate command is sent to a SOCKS v5 proxy server, it sets up a UDP relay that allows the client to send UDP packets to a remote host through the proxy server, and also receive UDP packet responses back through the proxy server.
|
||||
|
||||
```javascript
|
||||
const options = {
|
||||
proxy: {
|
||||
host: '159.203.75.235', // ipv4, ipv6, or hostname
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
|
||||
command: 'associate',
|
||||
|
||||
// When using associate, the destination should be the remote client that is expected to send UDP packets to the proxy server to be forwarded. This should be your local ip, or optionally the wildcard address (0.0.0.0) UDP Client <-> Proxy <-> UDP Client
|
||||
destination: {
|
||||
host: '0.0.0.0',
|
||||
port: 0
|
||||
}
|
||||
};
|
||||
|
||||
// Create a local UDP socket for sending packets to the proxy.
|
||||
const udpSocket = dgram.createSocket('udp4');
|
||||
udpSocket.bind();
|
||||
|
||||
// Listen for incoming UDP packets from the proxy server.
|
||||
udpSocket.on('message', (message, rinfo) => {
|
||||
console.log(SocksClient.parseUDPFrame(message));
|
||||
/*
|
||||
{ frameNumber: 0,
|
||||
remoteHost: { host: '165.227.108.231', port: 4444 }, // The remote host that replied with a UDP packet
|
||||
data: <Buffer 74 65 73 74 0a> // The data
|
||||
}
|
||||
*/
|
||||
});
|
||||
|
||||
let client = new SocksClient(associateOptions);
|
||||
|
||||
// When the UDP relay is established, this event is fired and includes the UDP relay port to send data to on the proxy server.
|
||||
client.on('established', info => {
|
||||
console.log(info.remoteHost);
|
||||
/*
|
||||
{
|
||||
host: '159.203.75.235',
|
||||
port: 44711
|
||||
}
|
||||
*/
|
||||
|
||||
// Send 'hello' to 165.227.108.231:4444
|
||||
const packet = SocksClient.createUDPFrame({
|
||||
remoteHost: { host: '165.227.108.231', port: 4444 },
|
||||
data: Buffer.from(line)
|
||||
});
|
||||
udpSocket.send(packet, info.remoteHost.port, info.remoteHost.host);
|
||||
});
|
||||
|
||||
// Start connection
|
||||
client.connect();
|
||||
```
|
||||
|
||||
**Note:** The associate TCP connection to the proxy must remain open for the UDP relay to work.
|
||||
|
||||
## Additional Examples
|
||||
|
||||
[Documentation](docs/index.md)
|
||||
|
||||
|
||||
## Migrating from v1
|
||||
|
||||
Looking for a guide to migrate from v1? Look [here](docs/migratingFromV1.md)
|
||||
|
||||
## Api Reference:
|
||||
|
||||
**Note:** socks includes full TypeScript definitions. These can even be used without using TypeScript as most IDEs (such as VS Code) will use these type definition files for auto completion intellisense even in JavaScript files.
|
||||
|
||||
* Class: SocksClient
|
||||
* [new SocksClient(options[, callback])](#new-socksclientoptions)
|
||||
* [Class Method: SocksClient.createConnection(options[, callback])](#class-method-socksclientcreateconnectionoptions-callback)
|
||||
* [Class Method: SocksClient.createConnectionChain(options[, callback])](#class-method-socksclientcreateconnectionchainoptions-callback)
|
||||
* [Class Method: SocksClient.createUDPFrame(options)](#class-method-socksclientcreateudpframedetails)
|
||||
* [Class Method: SocksClient.parseUDPFrame(data)](#class-method-socksclientparseudpframedata)
|
||||
* [Event: 'error'](#event-error)
|
||||
* [Event: 'bound'](#event-bound)
|
||||
* [Event: 'established'](#event-established)
|
||||
* [client.connect()](#clientconnect)
|
||||
* [client.socksClientOptions](#clientconnect)
|
||||
|
||||
### SocksClient
|
||||
|
||||
SocksClient establishes SOCKS proxy connections to remote destination hosts. These proxy connections are fully transparent to the server and once established act as full duplex streams. SOCKS v4, v4a, v5, and v5h are supported, as well as the connect, bind, and associate commands.
|
||||
|
||||
SocksClient supports creating connections using callbacks, promises, and async/await flow control using two static factory functions createConnection and createConnectionChain. It also internally extends EventEmitter which results in allowing event handling based async flow control.
|
||||
|
||||
**SOCKS Compatibility Table**
|
||||
|
||||
Note: When using 4a please specify type: 4, and when using 5h please specify type 5.
|
||||
|
||||
| Socks Version | TCP | UDP | IPv4 | IPv6 | Hostname |
|
||||
| --- | :---: | :---: | :---: | :---: | :---: |
|
||||
| SOCKS v4 | ✅ | ❌ | ✅ | ❌ | ❌ |
|
||||
| SOCKS v4a | ✅ | ❌ | ✅ | ❌ | ✅ |
|
||||
| SOCKS v5 (includes v5h) | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
|
||||
### new SocksClient(options)
|
||||
|
||||
* ```options``` {SocksClientOptions} - An object describing the SOCKS proxy to use, the command to send and establish, and the destination host to connect to.
|
||||
|
||||
### SocksClientOptions
|
||||
|
||||
```typescript
|
||||
{
|
||||
proxy: {
|
||||
host: '159.203.75.200', // ipv4, ipv6, or hostname
|
||||
port: 1080,
|
||||
type: 5, // Proxy version (4 or 5). For v4a use 4, for v5h use 5.
|
||||
|
||||
// Optional fields
|
||||
userId: 'some username', // Used for SOCKS4 userId auth, and SOCKS5 user/pass auth in conjunction with password.
|
||||
password: 'some password', // Used in conjunction with userId for user/pass auth for SOCKS5 proxies.
|
||||
custom_auth_method: 0x80, // If using a custom auth method, specify the type here. If this is set, ALL other custom_auth_*** options must be set as well.
|
||||
custom_auth_request_handler: async () =>. {
|
||||
// This will be called when it's time to send the custom auth handshake. You must return a Buffer containing the data to send as your authentication.
|
||||
return Buffer.from([0x01,0x02,0x03]);
|
||||
},
|
||||
// This is the expected size (bytes) of the custom auth response from the proxy server.
|
||||
custom_auth_response_size: 2,
|
||||
// This is called when the auth response is received. The received packet is passed in as a Buffer, and you must return a boolean indicating the response from the server said your custom auth was successful or failed.
|
||||
custom_auth_response_handler: async (data) => {
|
||||
return data[1] === 0x00;
|
||||
}
|
||||
},
|
||||
|
||||
command: 'connect', // connect, bind, associate
|
||||
|
||||
destination: {
|
||||
host: '192.30.253.113', // ipv4, ipv6, hostname. Hostnames work with v4a and v5.
|
||||
port: 80
|
||||
},
|
||||
|
||||
// Optional fields
|
||||
timeout: 30000, // How long to wait to establish a proxy connection. (defaults to 30 seconds)
|
||||
|
||||
set_tcp_nodelay: true // If true, will turn on the underlying sockets TCP_NODELAY option.
|
||||
}
|
||||
```
|
||||
|
||||
### Class Method: SocksClient.createConnection(options[, callback])
|
||||
* ```options``` { SocksClientOptions } - An object describing the SOCKS proxy to use, the command to send and establish, and the destination host to connect to.
|
||||
* ```callback``` { Function } - Optional callback function that is called when the proxy connection is established, or an error occurs.
|
||||
* ```returns``` { Promise } - A Promise is returned that is resolved when the proxy connection is established, or rejected when an error occurs.
|
||||
|
||||
Creates a new proxy connection through the given proxy to the given destination host. This factory function supports callbacks and promises for async flow control.
|
||||
|
||||
**Note:** If a callback function is provided, the promise will always resolve regardless of an error occurring. Please be sure to exclusively use either promises or callbacks when using this factory function.
|
||||
|
||||
```typescript
|
||||
const options = {
|
||||
proxy: {
|
||||
host: '159.203.75.200', // ipv4, ipv6, or hostname
|
||||
port: 1080,
|
||||
type: 5 // Proxy version (4 or 5)
|
||||
},
|
||||
|
||||
command: 'connect', // connect, bind, associate
|
||||
|
||||
destination: {
|
||||
host: '192.30.253.113', // ipv4, ipv6, or hostname
|
||||
port: 80
|
||||
}
|
||||
}
|
||||
|
||||
// Await/Async (uses a Promise)
|
||||
try {
|
||||
const info = await SocksClient.createConnection(options);
|
||||
console.log(info);
|
||||
/*
|
||||
{
|
||||
socket: <Socket ...>, // Raw net.Socket
|
||||
}
|
||||
*/
|
||||
/ <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy server)
|
||||
|
||||
} catch (err) {
|
||||
// Handle error...
|
||||
}
|
||||
|
||||
// Promise
|
||||
SocksClient.createConnection(options)
|
||||
.then(info => {
|
||||
console.log(info);
|
||||
/*
|
||||
{
|
||||
socket: <Socket ...>, // Raw net.Socket
|
||||
}
|
||||
*/
|
||||
})
|
||||
.catch(err => {
|
||||
// Handle error...
|
||||
});
|
||||
|
||||
// Callback
|
||||
SocksClient.createConnection(options, (err, info) => {
|
||||
if (!err) {
|
||||
console.log(info);
|
||||
/*
|
||||
{
|
||||
socket: <Socket ...>, // Raw net.Socket
|
||||
}
|
||||
*/
|
||||
} else {
|
||||
// Handle error...
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
### Class Method: SocksClient.createConnectionChain(options[, callback])
|
||||
* ```options``` { SocksClientChainOptions } - An object describing a list of SOCKS proxies to use, the command to send and establish, and the destination host to connect to.
|
||||
* ```callback``` { Function } - Optional callback function that is called when the proxy connection chain is established, or an error occurs.
|
||||
* ```returns``` { Promise } - A Promise is returned that is resolved when the proxy connection chain is established, or rejected when an error occurs.
|
||||
|
||||
Creates a new proxy connection chain through a list of at least two SOCKS proxies to the given destination host. This factory method supports callbacks and promises for async flow control.
|
||||
|
||||
**Note:** If a callback function is provided, the promise will always resolve regardless of an error occurring. Please be sure to exclusively use either promises or callbacks when using this factory function.
|
||||
|
||||
**Note:** At least two proxies must be provided for the chain to be established.
|
||||
|
||||
```typescript
|
||||
const options = {
|
||||
proxies: [ // The chain order is the order in the proxies array, meaning the last proxy will establish a connection to the destination.
|
||||
{
|
||||
host: '159.203.75.235', // ipv4, ipv6, or hostname
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
{
|
||||
host: '104.131.124.203', // ipv4, ipv6, or hostname
|
||||
port: 1081,
|
||||
type: 5
|
||||
}
|
||||
]
|
||||
|
||||
command: 'connect', // Only connect is supported in chaining mode.
|
||||
|
||||
destination: {
|
||||
host: '192.30.253.113', // ipv4, ipv6, hostname
|
||||
port: 80
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Class Method: SocksClient.createUDPFrame(details)
|
||||
* ```details``` { SocksUDPFrameDetails } - An object containing the remote host, frame number, and frame data to use when creating a SOCKS UDP frame packet.
|
||||
* ```returns``` { Buffer } - A Buffer containing all of the UDP frame data.
|
||||
|
||||
Creates a SOCKS UDP frame relay packet that is sent and received via a SOCKS proxy when using the associate command for UDP packet forwarding.
|
||||
|
||||
**SocksUDPFrameDetails**
|
||||
|
||||
```typescript
|
||||
{
|
||||
frameNumber: 0, // The frame number (used for breaking up larger packets)
|
||||
|
||||
remoteHost: { // The remote host to have the proxy send data to, or the remote host that send this data.
|
||||
host: '1.2.3.4',
|
||||
port: 1234
|
||||
},
|
||||
|
||||
data: <Buffer 01 02 03 04...> // A Buffer instance of data to include in the packet (actual data sent to the remote host)
|
||||
}
|
||||
interface SocksUDPFrameDetails {
|
||||
// The frame number of the packet.
|
||||
frameNumber?: number;
|
||||
|
||||
// The remote host.
|
||||
remoteHost: SocksRemoteHost;
|
||||
|
||||
// The packet data.
|
||||
data: Buffer;
|
||||
}
|
||||
```
|
||||
|
||||
### Class Method: SocksClient.parseUDPFrame(data)
|
||||
* ```data``` { Buffer } - A Buffer instance containing SOCKS UDP frame data to parse.
|
||||
* ```returns``` { SocksUDPFrameDetails } - An object containing the remote host, frame number, and frame data of the SOCKS UDP frame.
|
||||
|
||||
```typescript
|
||||
const frame = SocksClient.parseUDPFrame(data);
|
||||
console.log(frame);
|
||||
/*
|
||||
{
|
||||
frameNumber: 0,
|
||||
remoteHost: {
|
||||
host: '1.2.3.4',
|
||||
port: 1234
|
||||
},
|
||||
data: <Buffer 01 02 03 04 ...>
|
||||
}
|
||||
*/
|
||||
```
|
||||
|
||||
Parses a Buffer instance and returns the parsed SocksUDPFrameDetails object.
|
||||
|
||||
## Event: 'error'
|
||||
* ```err``` { SocksClientError } - An Error object containing an error message and the original SocksClientOptions.
|
||||
|
||||
This event is emitted if an error occurs when trying to establish the proxy connection.
|
||||
|
||||
## Event: 'bound'
|
||||
* ```info``` { SocksClientBoundEvent } An object containing a Socket and SocksRemoteHost info.
|
||||
|
||||
This event is emitted when using the BIND command on a remote SOCKS proxy server. This event indicates the proxy server is now listening for incoming connections on a specified port.
|
||||
|
||||
**SocksClientBoundEvent**
|
||||
```typescript
|
||||
{
|
||||
socket: net.Socket, // The underlying raw Socket
|
||||
remoteHost: {
|
||||
host: '1.2.3.4', // The remote host that is listening (usually the proxy itself)
|
||||
port: 4444 // The remote port the proxy is listening on for incoming connections (when using BIND).
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Event: 'established'
|
||||
* ```info``` { SocksClientEstablishedEvent } An object containing a Socket and SocksRemoteHost info.
|
||||
|
||||
This event is emitted when the following conditions are met:
|
||||
1. When using the CONNECT command, and a proxy connection has been established to the remote host.
|
||||
2. When using the BIND command, and an incoming connection has been accepted by the proxy and a TCP relay has been established.
|
||||
3. When using the ASSOCIATE command, and a UDP relay has been established.
|
||||
|
||||
When using BIND, 'bound' is first emitted to indicate the SOCKS server is waiting for an incoming connection, and provides the remote port the SOCKS server is listening on.
|
||||
|
||||
When using ASSOCIATE, 'established' is emitted with the remote UDP port the SOCKS server is accepting UDP frame packets on.
|
||||
|
||||
**SocksClientEstablishedEvent**
|
||||
```typescript
|
||||
{
|
||||
socket: net.Socket, // The underlying raw Socket
|
||||
remoteHost: {
|
||||
host: '1.2.3.4', // The remote host that is listening (usually the proxy itself)
|
||||
port: 52738 // The remote port the proxy is listening on for incoming connections (when using BIND).
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## client.connect()
|
||||
|
||||
Starts connecting to the remote SOCKS proxy server to establish a proxy connection to the destination host.
|
||||
|
||||
## client.socksClientOptions
|
||||
* ```returns``` { SocksClientOptions } The options that were passed to the SocksClient.
|
||||
|
||||
Gets the options that were passed to the SocksClient when it was created.
|
||||
|
||||
|
||||
**SocksClientError**
|
||||
```typescript
|
||||
{ // Subclassed from Error.
|
||||
message: 'An error has occurred',
|
||||
options: {
|
||||
// SocksClientOptions
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
# Further Reading:
|
||||
|
||||
Please read the SOCKS 5 specifications for more information on how to use BIND and Associate.
|
||||
http://www.ietf.org/rfc/rfc1928.txt
|
||||
|
||||
# License
|
||||
|
||||
This work is licensed under the [MIT license](http://en.wikipedia.org/wiki/MIT_License).
|
||||
793
node_modules/socks/build/client/socksclient.js
generated
vendored
Normal file
793
node_modules/socks/build/client/socksclient.js
generated
vendored
Normal file
@@ -0,0 +1,793 @@
|
||||
"use strict";
|
||||
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
|
||||
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
|
||||
return new (P || (P = Promise))(function (resolve, reject) {
|
||||
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
|
||||
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
|
||||
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
|
||||
step((generator = generator.apply(thisArg, _arguments || [])).next());
|
||||
});
|
||||
};
|
||||
Object.defineProperty(exports, "__esModule", { value: true });
|
||||
exports.SocksClientError = exports.SocksClient = void 0;
|
||||
const events_1 = require("events");
|
||||
const net = require("net");
|
||||
const smart_buffer_1 = require("smart-buffer");
|
||||
const constants_1 = require("../common/constants");
|
||||
const helpers_1 = require("../common/helpers");
|
||||
const receivebuffer_1 = require("../common/receivebuffer");
|
||||
const util_1 = require("../common/util");
|
||||
Object.defineProperty(exports, "SocksClientError", { enumerable: true, get: function () { return util_1.SocksClientError; } });
|
||||
const ip_address_1 = require("ip-address");
|
||||
class SocksClient extends events_1.EventEmitter {
|
||||
constructor(options) {
|
||||
super();
|
||||
this.options = Object.assign({}, options);
|
||||
// Validate SocksClientOptions
|
||||
(0, helpers_1.validateSocksClientOptions)(options);
|
||||
// Default state
|
||||
this.setState(constants_1.SocksClientState.Created);
|
||||
}
|
||||
/**
|
||||
* Creates a new SOCKS connection.
|
||||
*
|
||||
* Note: Supports callbacks and promises. Only supports the connect command.
|
||||
* @param options { SocksClientOptions } Options.
|
||||
* @param callback { Function } An optional callback function.
|
||||
* @returns { Promise }
|
||||
*/
|
||||
static createConnection(options, callback) {
|
||||
return new Promise((resolve, reject) => {
|
||||
// Validate SocksClientOptions
|
||||
try {
|
||||
(0, helpers_1.validateSocksClientOptions)(options, ['connect']);
|
||||
}
|
||||
catch (err) {
|
||||
if (typeof callback === 'function') {
|
||||
callback(err);
|
||||
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
||||
return resolve(err); // Resolves pending promise (prevents memory leaks).
|
||||
}
|
||||
else {
|
||||
return reject(err);
|
||||
}
|
||||
}
|
||||
const client = new SocksClient(options);
|
||||
client.connect(options.existing_socket);
|
||||
client.once('established', (info) => {
|
||||
client.removeAllListeners();
|
||||
if (typeof callback === 'function') {
|
||||
callback(null, info);
|
||||
resolve(info); // Resolves pending promise (prevents memory leaks).
|
||||
}
|
||||
else {
|
||||
resolve(info);
|
||||
}
|
||||
});
|
||||
// Error occurred, failed to establish connection.
|
||||
client.once('error', (err) => {
|
||||
client.removeAllListeners();
|
||||
if (typeof callback === 'function') {
|
||||
callback(err);
|
||||
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
||||
resolve(err); // Resolves pending promise (prevents memory leaks).
|
||||
}
|
||||
else {
|
||||
reject(err);
|
||||
}
|
||||
});
|
||||
});
|
||||
}
|
||||
/**
|
||||
* Creates a new SOCKS connection chain to a destination host through 2 or more SOCKS proxies.
|
||||
*
|
||||
* Note: Supports callbacks and promises. Only supports the connect method.
|
||||
* Note: Implemented via createConnection() factory function.
|
||||
* @param options { SocksClientChainOptions } Options
|
||||
* @param callback { Function } An optional callback function.
|
||||
* @returns { Promise }
|
||||
*/
|
||||
static createConnectionChain(options, callback) {
|
||||
// eslint-disable-next-line no-async-promise-executor
|
||||
return new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
|
||||
// Validate SocksClientChainOptions
|
||||
try {
|
||||
(0, helpers_1.validateSocksClientChainOptions)(options);
|
||||
}
|
||||
catch (err) {
|
||||
if (typeof callback === 'function') {
|
||||
callback(err);
|
||||
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
||||
return resolve(err); // Resolves pending promise (prevents memory leaks).
|
||||
}
|
||||
else {
|
||||
return reject(err);
|
||||
}
|
||||
}
|
||||
// Shuffle proxies
|
||||
if (options.randomizeChain) {
|
||||
(0, util_1.shuffleArray)(options.proxies);
|
||||
}
|
||||
try {
|
||||
let sock;
|
||||
for (let i = 0; i < options.proxies.length; i++) {
|
||||
const nextProxy = options.proxies[i];
|
||||
// If we've reached the last proxy in the chain, the destination is the actual destination, otherwise it's the next proxy.
|
||||
const nextDestination = i === options.proxies.length - 1
|
||||
? options.destination
|
||||
: {
|
||||
host: options.proxies[i + 1].host ||
|
||||
options.proxies[i + 1].ipaddress,
|
||||
port: options.proxies[i + 1].port,
|
||||
};
|
||||
// Creates the next connection in the chain.
|
||||
const result = yield SocksClient.createConnection({
|
||||
command: 'connect',
|
||||
proxy: nextProxy,
|
||||
destination: nextDestination,
|
||||
existing_socket: sock,
|
||||
});
|
||||
// If sock is undefined, assign it here.
|
||||
sock = sock || result.socket;
|
||||
}
|
||||
if (typeof callback === 'function') {
|
||||
callback(null, { socket: sock });
|
||||
resolve({ socket: sock }); // Resolves pending promise (prevents memory leaks).
|
||||
}
|
||||
else {
|
||||
resolve({ socket: sock });
|
||||
}
|
||||
}
|
||||
catch (err) {
|
||||
if (typeof callback === 'function') {
|
||||
callback(err);
|
||||
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
||||
resolve(err); // Resolves pending promise (prevents memory leaks).
|
||||
}
|
||||
else {
|
||||
reject(err);
|
||||
}
|
||||
}
|
||||
}));
|
||||
}
|
||||
/**
|
||||
* Creates a SOCKS UDP Frame.
|
||||
* @param options
|
||||
*/
|
||||
static createUDPFrame(options) {
|
||||
const buff = new smart_buffer_1.SmartBuffer();
|
||||
buff.writeUInt16BE(0);
|
||||
buff.writeUInt8(options.frameNumber || 0);
|
||||
// IPv4/IPv6/Hostname
|
||||
if (net.isIPv4(options.remoteHost.host)) {
|
||||
buff.writeUInt8(constants_1.Socks5HostType.IPv4);
|
||||
buff.writeUInt32BE((0, helpers_1.ipv4ToInt32)(options.remoteHost.host));
|
||||
}
|
||||
else if (net.isIPv6(options.remoteHost.host)) {
|
||||
buff.writeUInt8(constants_1.Socks5HostType.IPv6);
|
||||
buff.writeBuffer((0, helpers_1.ipToBuffer)(options.remoteHost.host));
|
||||
}
|
||||
else {
|
||||
buff.writeUInt8(constants_1.Socks5HostType.Hostname);
|
||||
buff.writeUInt8(Buffer.byteLength(options.remoteHost.host));
|
||||
buff.writeString(options.remoteHost.host);
|
||||
}
|
||||
// Port
|
||||
buff.writeUInt16BE(options.remoteHost.port);
|
||||
// Data
|
||||
buff.writeBuffer(options.data);
|
||||
return buff.toBuffer();
|
||||
}
|
||||
/**
|
||||
* Parses a SOCKS UDP frame.
|
||||
* @param data
|
||||
*/
|
||||
static parseUDPFrame(data) {
|
||||
const buff = smart_buffer_1.SmartBuffer.fromBuffer(data);
|
||||
buff.readOffset = 2;
|
||||
const frameNumber = buff.readUInt8();
|
||||
const hostType = buff.readUInt8();
|
||||
let remoteHost;
|
||||
if (hostType === constants_1.Socks5HostType.IPv4) {
|
||||
remoteHost = (0, helpers_1.int32ToIpv4)(buff.readUInt32BE());
|
||||
}
|
||||
else if (hostType === constants_1.Socks5HostType.IPv6) {
|
||||
remoteHost = ip_address_1.Address6.fromByteArray(Array.from(buff.readBuffer(16))).canonicalForm();
|
||||
}
|
||||
else {
|
||||
remoteHost = buff.readString(buff.readUInt8());
|
||||
}
|
||||
const remotePort = buff.readUInt16BE();
|
||||
return {
|
||||
frameNumber,
|
||||
remoteHost: {
|
||||
host: remoteHost,
|
||||
port: remotePort,
|
||||
},
|
||||
data: buff.readBuffer(),
|
||||
};
|
||||
}
|
||||
/**
|
||||
* Internal state setter. If the SocksClient is in an error state, it cannot be changed to a non error state.
|
||||
*/
|
||||
setState(newState) {
|
||||
if (this.state !== constants_1.SocksClientState.Error) {
|
||||
this.state = newState;
|
||||
}
|
||||
}
|
||||
/**
|
||||
* Starts the connection establishment to the proxy and destination.
|
||||
* @param existingSocket Connected socket to use instead of creating a new one (internal use).
|
||||
*/
|
||||
connect(existingSocket) {
|
||||
this.onDataReceived = (data) => this.onDataReceivedHandler(data);
|
||||
this.onClose = () => this.onCloseHandler();
|
||||
this.onError = (err) => this.onErrorHandler(err);
|
||||
this.onConnect = () => this.onConnectHandler();
|
||||
// Start timeout timer (defaults to 30 seconds)
|
||||
const timer = setTimeout(() => this.onEstablishedTimeout(), this.options.timeout || constants_1.DEFAULT_TIMEOUT);
|
||||
// check whether unref is available as it differs from browser to NodeJS (#33)
|
||||
if (timer.unref && typeof timer.unref === 'function') {
|
||||
timer.unref();
|
||||
}
|
||||
// If an existing socket is provided, use it to negotiate SOCKS handshake. Otherwise create a new Socket.
|
||||
if (existingSocket) {
|
||||
this.socket = existingSocket;
|
||||
}
|
||||
else {
|
||||
this.socket = new net.Socket();
|
||||
}
|
||||
// Attach Socket error handlers.
|
||||
this.socket.once('close', this.onClose);
|
||||
this.socket.once('error', this.onError);
|
||||
this.socket.once('connect', this.onConnect);
|
||||
this.socket.on('data', this.onDataReceived);
|
||||
this.setState(constants_1.SocksClientState.Connecting);
|
||||
this.receiveBuffer = new receivebuffer_1.ReceiveBuffer();
|
||||
if (existingSocket) {
|
||||
this.socket.emit('connect');
|
||||
}
|
||||
else {
|
||||
this.socket.connect(this.getSocketOptions());
|
||||
if (this.options.set_tcp_nodelay !== undefined &&
|
||||
this.options.set_tcp_nodelay !== null) {
|
||||
this.socket.setNoDelay(!!this.options.set_tcp_nodelay);
|
||||
}
|
||||
}
|
||||
// Listen for established event so we can re-emit any excess data received during handshakes.
|
||||
this.prependOnceListener('established', (info) => {
|
||||
setImmediate(() => {
|
||||
if (this.receiveBuffer.length > 0) {
|
||||
const excessData = this.receiveBuffer.get(this.receiveBuffer.length);
|
||||
info.socket.emit('data', excessData);
|
||||
}
|
||||
info.socket.resume();
|
||||
});
|
||||
});
|
||||
}
|
||||
// Socket options (defaults host/port to options.proxy.host/options.proxy.port)
|
||||
getSocketOptions() {
|
||||
return Object.assign(Object.assign({}, this.options.socket_options), { host: this.options.proxy.host || this.options.proxy.ipaddress, port: this.options.proxy.port });
|
||||
}
|
||||
/**
|
||||
* Handles internal Socks timeout callback.
|
||||
* Note: If the Socks client is not BoundWaitingForConnection or Established, the connection will be closed.
|
||||
*/
|
||||
onEstablishedTimeout() {
|
||||
if (this.state !== constants_1.SocksClientState.Established &&
|
||||
this.state !== constants_1.SocksClientState.BoundWaitingForConnection) {
|
||||
this.closeSocket(constants_1.ERRORS.ProxyConnectionTimedOut);
|
||||
}
|
||||
}
|
||||
/**
|
||||
* Handles Socket connect event.
|
||||
*/
|
||||
onConnectHandler() {
|
||||
this.setState(constants_1.SocksClientState.Connected);
|
||||
// Send initial handshake.
|
||||
if (this.options.proxy.type === 4) {
|
||||
this.sendSocks4InitialHandshake();
|
||||
}
|
||||
else {
|
||||
this.sendSocks5InitialHandshake();
|
||||
}
|
||||
this.setState(constants_1.SocksClientState.SentInitialHandshake);
|
||||
}
|
||||
/**
|
||||
* Handles Socket data event.
|
||||
* @param data
|
||||
*/
|
||||
onDataReceivedHandler(data) {
|
||||
/*
|
||||
All received data is appended to a ReceiveBuffer.
|
||||
This makes sure that all the data we need is received before we attempt to process it.
|
||||
*/
|
||||
this.receiveBuffer.append(data);
|
||||
// Process data that we have.
|
||||
this.processData();
|
||||
}
|
||||
/**
|
||||
* Handles processing of the data we have received.
|
||||
*/
|
||||
processData() {
|
||||
// If we have enough data to process the next step in the SOCKS handshake, proceed.
|
||||
while (this.state !== constants_1.SocksClientState.Established &&
|
||||
this.state !== constants_1.SocksClientState.Error &&
|
||||
this.receiveBuffer.length >= this.nextRequiredPacketBufferSize) {
|
||||
// Sent initial handshake, waiting for response.
|
||||
if (this.state === constants_1.SocksClientState.SentInitialHandshake) {
|
||||
if (this.options.proxy.type === 4) {
|
||||
// Socks v4 only has one handshake response.
|
||||
this.handleSocks4FinalHandshakeResponse();
|
||||
}
|
||||
else {
|
||||
// Socks v5 has two handshakes, handle initial one here.
|
||||
this.handleInitialSocks5HandshakeResponse();
|
||||
}
|
||||
// Sent auth request for Socks v5, waiting for response.
|
||||
}
|
||||
else if (this.state === constants_1.SocksClientState.SentAuthentication) {
|
||||
this.handleInitialSocks5AuthenticationHandshakeResponse();
|
||||
// Sent final Socks v5 handshake, waiting for final response.
|
||||
}
|
||||
else if (this.state === constants_1.SocksClientState.SentFinalHandshake) {
|
||||
this.handleSocks5FinalHandshakeResponse();
|
||||
// Socks BIND established. Waiting for remote connection via proxy.
|
||||
}
|
||||
else if (this.state === constants_1.SocksClientState.BoundWaitingForConnection) {
|
||||
if (this.options.proxy.type === 4) {
|
||||
this.handleSocks4IncomingConnectionResponse();
|
||||
}
|
||||
else {
|
||||
this.handleSocks5IncomingConnectionResponse();
|
||||
}
|
||||
}
|
||||
else {
|
||||
this.closeSocket(constants_1.ERRORS.InternalError);
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
/**
|
||||
* Handles Socket close event.
|
||||
* @param had_error
|
||||
*/
|
||||
onCloseHandler() {
|
||||
this.closeSocket(constants_1.ERRORS.SocketClosed);
|
||||
}
|
||||
/**
|
||||
* Handles Socket error event.
|
||||
* @param err
|
||||
*/
|
||||
onErrorHandler(err) {
|
||||
this.closeSocket(err.message);
|
||||
}
|
||||
/**
|
||||
* Removes internal event listeners on the underlying Socket.
|
||||
*/
|
||||
removeInternalSocketHandlers() {
|
||||
// Pauses data flow of the socket (this is internally resumed after 'established' is emitted)
|
||||
this.socket.pause();
|
||||
this.socket.removeListener('data', this.onDataReceived);
|
||||
this.socket.removeListener('close', this.onClose);
|
||||
this.socket.removeListener('error', this.onError);
|
||||
this.socket.removeListener('connect', this.onConnect);
|
||||
}
|
||||
/**
|
||||
* Closes and destroys the underlying Socket. Emits an error event.
|
||||
* @param err { String } An error string to include in error event.
|
||||
*/
|
||||
closeSocket(err) {
|
||||
// Make sure only one 'error' event is fired for the lifetime of this SocksClient instance.
|
||||
if (this.state !== constants_1.SocksClientState.Error) {
|
||||
// Set internal state to Error.
|
||||
this.setState(constants_1.SocksClientState.Error);
|
||||
// Destroy Socket
|
||||
this.socket.destroy();
|
||||
// Remove internal listeners
|
||||
this.removeInternalSocketHandlers();
|
||||
// Fire 'error' event.
|
||||
this.emit('error', new util_1.SocksClientError(err, this.options));
|
||||
}
|
||||
}
|
||||
/**
|
||||
* Sends initial Socks v4 handshake request.
|
||||
*/
|
||||
sendSocks4InitialHandshake() {
|
||||
const userId = this.options.proxy.userId || '';
|
||||
const buff = new smart_buffer_1.SmartBuffer();
|
||||
buff.writeUInt8(0x04);
|
||||
buff.writeUInt8(constants_1.SocksCommand[this.options.command]);
|
||||
buff.writeUInt16BE(this.options.destination.port);
|
||||
// Socks 4 (IPv4)
|
||||
if (net.isIPv4(this.options.destination.host)) {
|
||||
buff.writeBuffer((0, helpers_1.ipToBuffer)(this.options.destination.host));
|
||||
buff.writeStringNT(userId);
|
||||
// Socks 4a (hostname)
|
||||
}
|
||||
else {
|
||||
buff.writeUInt8(0x00);
|
||||
buff.writeUInt8(0x00);
|
||||
buff.writeUInt8(0x00);
|
||||
buff.writeUInt8(0x01);
|
||||
buff.writeStringNT(userId);
|
||||
buff.writeStringNT(this.options.destination.host);
|
||||
}
|
||||
this.nextRequiredPacketBufferSize =
|
||||
constants_1.SOCKS_INCOMING_PACKET_SIZES.Socks4Response;
|
||||
this.socket.write(buff.toBuffer());
|
||||
}
|
||||
/**
|
||||
* Handles Socks v4 handshake response.
|
||||
* @param data
|
||||
*/
|
||||
handleSocks4FinalHandshakeResponse() {
|
||||
const data = this.receiveBuffer.get(8);
|
||||
if (data[1] !== constants_1.Socks4Response.Granted) {
|
||||
this.closeSocket(`${constants_1.ERRORS.Socks4ProxyRejectedConnection} - (${constants_1.Socks4Response[data[1]]})`);
|
||||
}
|
||||
else {
|
||||
// Bind response
|
||||
if (constants_1.SocksCommand[this.options.command] === constants_1.SocksCommand.bind) {
|
||||
const buff = smart_buffer_1.SmartBuffer.fromBuffer(data);
|
||||
buff.readOffset = 2;
|
||||
const remoteHost = {
|
||||
port: buff.readUInt16BE(),
|
||||
host: (0, helpers_1.int32ToIpv4)(buff.readUInt32BE()),
|
||||
};
|
||||
// If host is 0.0.0.0, set to proxy host.
|
||||
if (remoteHost.host === '0.0.0.0') {
|
||||
remoteHost.host = this.options.proxy.ipaddress;
|
||||
}
|
||||
this.setState(constants_1.SocksClientState.BoundWaitingForConnection);
|
||||
this.emit('bound', { remoteHost, socket: this.socket });
|
||||
// Connect response
|
||||
}
|
||||
else {
|
||||
this.setState(constants_1.SocksClientState.Established);
|
||||
this.removeInternalSocketHandlers();
|
||||
this.emit('established', { socket: this.socket });
|
||||
}
|
||||
}
|
||||
}
|
||||
/**
|
||||
* Handles Socks v4 incoming connection request (BIND)
|
||||
* @param data
|
||||
*/
|
||||
handleSocks4IncomingConnectionResponse() {
|
||||
const data = this.receiveBuffer.get(8);
|
||||
if (data[1] !== constants_1.Socks4Response.Granted) {
|
||||
this.closeSocket(`${constants_1.ERRORS.Socks4ProxyRejectedIncomingBoundConnection} - (${constants_1.Socks4Response[data[1]]})`);
|
||||
}
|
||||
else {
|
||||
const buff = smart_buffer_1.SmartBuffer.fromBuffer(data);
|
||||
buff.readOffset = 2;
|
||||
const remoteHost = {
|
||||
port: buff.readUInt16BE(),
|
||||
host: (0, helpers_1.int32ToIpv4)(buff.readUInt32BE()),
|
||||
};
|
||||
this.setState(constants_1.SocksClientState.Established);
|
||||
this.removeInternalSocketHandlers();
|
||||
this.emit('established', { remoteHost, socket: this.socket });
|
||||
}
|
||||
}
|
||||
/**
|
||||
* Sends initial Socks v5 handshake request.
|
||||
*/
|
||||
sendSocks5InitialHandshake() {
|
||||
const buff = new smart_buffer_1.SmartBuffer();
|
||||
// By default we always support no auth.
|
||||
const supportedAuthMethods = [constants_1.Socks5Auth.NoAuth];
|
||||
// We should only tell the proxy we support user/pass auth if auth info is actually provided.
|
||||
// Note: As of Tor v0.3.5.7+, if user/pass auth is an option from the client, by default it will always take priority.
|
||||
if (this.options.proxy.userId || this.options.proxy.password) {
|
||||
supportedAuthMethods.push(constants_1.Socks5Auth.UserPass);
|
||||
}
|
||||
// Custom auth method?
|
||||
if (this.options.proxy.custom_auth_method !== undefined) {
|
||||
supportedAuthMethods.push(this.options.proxy.custom_auth_method);
|
||||
}
|
||||
// Build handshake packet
|
||||
buff.writeUInt8(0x05);
|
||||
buff.writeUInt8(supportedAuthMethods.length);
|
||||
for (const authMethod of supportedAuthMethods) {
|
||||
buff.writeUInt8(authMethod);
|
||||
}
|
||||
this.nextRequiredPacketBufferSize =
|
||||
constants_1.SOCKS_INCOMING_PACKET_SIZES.Socks5InitialHandshakeResponse;
|
||||
this.socket.write(buff.toBuffer());
|
||||
this.setState(constants_1.SocksClientState.SentInitialHandshake);
|
||||
}
|
||||
/**
|
||||
* Handles initial Socks v5 handshake response.
|
||||
* @param data
|
||||
*/
|
||||
handleInitialSocks5HandshakeResponse() {
|
||||
const data = this.receiveBuffer.get(2);
|
||||
if (data[0] !== 0x05) {
|
||||
this.closeSocket(constants_1.ERRORS.InvalidSocks5IntiailHandshakeSocksVersion);
|
||||
}
|
||||
else if (data[1] === constants_1.SOCKS5_NO_ACCEPTABLE_AUTH) {
|
||||
this.closeSocket(constants_1.ERRORS.InvalidSocks5InitialHandshakeNoAcceptedAuthType);
|
||||
}
|
||||
else {
|
||||
// If selected Socks v5 auth method is no auth, send final handshake request.
|
||||
if (data[1] === constants_1.Socks5Auth.NoAuth) {
|
||||
this.socks5ChosenAuthType = constants_1.Socks5Auth.NoAuth;
|
||||
this.sendSocks5CommandRequest();
|
||||
// If selected Socks v5 auth method is user/password, send auth handshake.
|
||||
}
|
||||
else if (data[1] === constants_1.Socks5Auth.UserPass) {
|
||||
this.socks5ChosenAuthType = constants_1.Socks5Auth.UserPass;
|
||||
this.sendSocks5UserPassAuthentication();
|
||||
// If selected Socks v5 auth method is the custom_auth_method, send custom handshake.
|
||||
}
|
||||
else if (data[1] === this.options.proxy.custom_auth_method) {
|
||||
this.socks5ChosenAuthType = this.options.proxy.custom_auth_method;
|
||||
this.sendSocks5CustomAuthentication();
|
||||
}
|
||||
else {
|
||||
this.closeSocket(constants_1.ERRORS.InvalidSocks5InitialHandshakeUnknownAuthType);
|
||||
}
|
||||
}
|
||||
}
|
||||
/**
|
||||
* Sends Socks v5 user & password auth handshake.
|
||||
*
|
||||
* Note: No auth and user/pass are currently supported.
|
||||
*/
|
||||
sendSocks5UserPassAuthentication() {
|
||||
const userId = this.options.proxy.userId || '';
|
||||
const password = this.options.proxy.password || '';
|
||||
const buff = new smart_buffer_1.SmartBuffer();
|
||||
buff.writeUInt8(0x01);
|
||||
buff.writeUInt8(Buffer.byteLength(userId));
|
||||
buff.writeString(userId);
|
||||
buff.writeUInt8(Buffer.byteLength(password));
|
||||
buff.writeString(password);
|
||||
this.nextRequiredPacketBufferSize =
|
||||
constants_1.SOCKS_INCOMING_PACKET_SIZES.Socks5UserPassAuthenticationResponse;
|
||||
this.socket.write(buff.toBuffer());
|
||||
this.setState(constants_1.SocksClientState.SentAuthentication);
|
||||
}
|
||||
sendSocks5CustomAuthentication() {
|
||||
return __awaiter(this, void 0, void 0, function* () {
|
||||
this.nextRequiredPacketBufferSize =
|
||||
this.options.proxy.custom_auth_response_size;
|
||||
this.socket.write(yield this.options.proxy.custom_auth_request_handler());
|
||||
this.setState(constants_1.SocksClientState.SentAuthentication);
|
||||
});
|
||||
}
|
||||
handleSocks5CustomAuthHandshakeResponse(data) {
|
||||
return __awaiter(this, void 0, void 0, function* () {
|
||||
return yield this.options.proxy.custom_auth_response_handler(data);
|
||||
});
|
||||
}
|
||||
handleSocks5AuthenticationNoAuthHandshakeResponse(data) {
|
||||
return __awaiter(this, void 0, void 0, function* () {
|
||||
return data[1] === 0x00;
|
||||
});
|
||||
}
|
||||
handleSocks5AuthenticationUserPassHandshakeResponse(data) {
|
||||
return __awaiter(this, void 0, void 0, function* () {
|
||||
return data[1] === 0x00;
|
||||
});
|
||||
}
|
||||
/**
|
||||
* Handles Socks v5 auth handshake response.
|
||||
* @param data
|
||||
*/
|
||||
handleInitialSocks5AuthenticationHandshakeResponse() {
|
||||
return __awaiter(this, void 0, void 0, function* () {
|
||||
this.setState(constants_1.SocksClientState.ReceivedAuthenticationResponse);
|
||||
let authResult = false;
|
||||
if (this.socks5ChosenAuthType === constants_1.Socks5Auth.NoAuth) {
|
||||
authResult = yield this.handleSocks5AuthenticationNoAuthHandshakeResponse(this.receiveBuffer.get(2));
|
||||
}
|
||||
else if (this.socks5ChosenAuthType === constants_1.Socks5Auth.UserPass) {
|
||||
authResult =
|
||||
yield this.handleSocks5AuthenticationUserPassHandshakeResponse(this.receiveBuffer.get(2));
|
||||
}
|
||||
else if (this.socks5ChosenAuthType === this.options.proxy.custom_auth_method) {
|
||||
authResult = yield this.handleSocks5CustomAuthHandshakeResponse(this.receiveBuffer.get(this.options.proxy.custom_auth_response_size));
|
||||
}
|
||||
if (!authResult) {
|
||||
this.closeSocket(constants_1.ERRORS.Socks5AuthenticationFailed);
|
||||
}
|
||||
else {
|
||||
this.sendSocks5CommandRequest();
|
||||
}
|
||||
});
|
||||
}
|
||||
/**
|
||||
* Sends Socks v5 final handshake request.
|
||||
*/
|
||||
sendSocks5CommandRequest() {
|
||||
const buff = new smart_buffer_1.SmartBuffer();
|
||||
buff.writeUInt8(0x05);
|
||||
buff.writeUInt8(constants_1.SocksCommand[this.options.command]);
|
||||
buff.writeUInt8(0x00);
|
||||
// ipv4, ipv6, domain?
|
||||
if (net.isIPv4(this.options.destination.host)) {
|
||||
buff.writeUInt8(constants_1.Socks5HostType.IPv4);
|
||||
buff.writeBuffer((0, helpers_1.ipToBuffer)(this.options.destination.host));
|
||||
}
|
||||
else if (net.isIPv6(this.options.destination.host)) {
|
||||
buff.writeUInt8(constants_1.Socks5HostType.IPv6);
|
||||
buff.writeBuffer((0, helpers_1.ipToBuffer)(this.options.destination.host));
|
||||
}
|
||||
else {
|
||||
buff.writeUInt8(constants_1.Socks5HostType.Hostname);
|
||||
buff.writeUInt8(this.options.destination.host.length);
|
||||
buff.writeString(this.options.destination.host);
|
||||
}
|
||||
buff.writeUInt16BE(this.options.destination.port);
|
||||
this.nextRequiredPacketBufferSize =
|
||||
constants_1.SOCKS_INCOMING_PACKET_SIZES.Socks5ResponseHeader;
|
||||
this.socket.write(buff.toBuffer());
|
||||
this.setState(constants_1.SocksClientState.SentFinalHandshake);
|
||||
}
|
||||
/**
|
||||
* Handles Socks v5 final handshake response.
|
||||
* @param data
|
||||
*/
|
||||
handleSocks5FinalHandshakeResponse() {
|
||||
// Peek at available data (we need at least 5 bytes to get the hostname length)
|
||||
const header = this.receiveBuffer.peek(5);
|
||||
if (header[0] !== 0x05 || header[1] !== constants_1.Socks5Response.Granted) {
|
||||
this.closeSocket(`${constants_1.ERRORS.InvalidSocks5FinalHandshakeRejected} - ${constants_1.Socks5Response[header[1]]}`);
|
||||
}
|
||||
else {
|
||||
// Read address type
|
||||
const addressType = header[3];
|
||||
let remoteHost;
|
||||
let buff;
|
||||
// IPv4
|
||||
if (addressType === constants_1.Socks5HostType.IPv4) {
|
||||
// Check if data is available.
|
||||
const dataNeeded = constants_1.SOCKS_INCOMING_PACKET_SIZES.Socks5ResponseIPv4;
|
||||
if (this.receiveBuffer.length < dataNeeded) {
|
||||
this.nextRequiredPacketBufferSize = dataNeeded;
|
||||
return;
|
||||
}
|
||||
buff = smart_buffer_1.SmartBuffer.fromBuffer(this.receiveBuffer.get(dataNeeded).slice(4));
|
||||
remoteHost = {
|
||||
host: (0, helpers_1.int32ToIpv4)(buff.readUInt32BE()),
|
||||
port: buff.readUInt16BE(),
|
||||
};
|
||||
// If given host is 0.0.0.0, assume remote proxy ip instead.
|
||||
if (remoteHost.host === '0.0.0.0') {
|
||||
remoteHost.host = this.options.proxy.ipaddress;
|
||||
}
|
||||
// Hostname
|
||||
}
|
||||
else if (addressType === constants_1.Socks5HostType.Hostname) {
|
||||
const hostLength = header[4];
|
||||
const dataNeeded = constants_1.SOCKS_INCOMING_PACKET_SIZES.Socks5ResponseHostname(hostLength); // header + host length + host + port
|
||||
// Check if data is available.
|
||||
if (this.receiveBuffer.length < dataNeeded) {
|
||||
this.nextRequiredPacketBufferSize = dataNeeded;
|
||||
return;
|
||||
}
|
||||
buff = smart_buffer_1.SmartBuffer.fromBuffer(this.receiveBuffer.get(dataNeeded).slice(5));
|
||||
remoteHost = {
|
||||
host: buff.readString(hostLength),
|
||||
port: buff.readUInt16BE(),
|
||||
};
|
||||
// IPv6
|
||||
}
|
||||
else if (addressType === constants_1.Socks5HostType.IPv6) {
|
||||
// Check if data is available.
|
||||
const dataNeeded = constants_1.SOCKS_INCOMING_PACKET_SIZES.Socks5ResponseIPv6;
|
||||
if (this.receiveBuffer.length < dataNeeded) {
|
||||
this.nextRequiredPacketBufferSize = dataNeeded;
|
||||
return;
|
||||
}
|
||||
buff = smart_buffer_1.SmartBuffer.fromBuffer(this.receiveBuffer.get(dataNeeded).slice(4));
|
||||
remoteHost = {
|
||||
host: ip_address_1.Address6.fromByteArray(Array.from(buff.readBuffer(16))).canonicalForm(),
|
||||
port: buff.readUInt16BE(),
|
||||
};
|
||||
}
|
||||
// We have everything we need
|
||||
this.setState(constants_1.SocksClientState.ReceivedFinalResponse);
|
||||
// If using CONNECT, the client is now in the established state.
|
||||
if (constants_1.SocksCommand[this.options.command] === constants_1.SocksCommand.connect) {
|
||||
this.setState(constants_1.SocksClientState.Established);
|
||||
this.removeInternalSocketHandlers();
|
||||
this.emit('established', { remoteHost, socket: this.socket });
|
||||
}
|
||||
else if (constants_1.SocksCommand[this.options.command] === constants_1.SocksCommand.bind) {
|
||||
/* If using BIND, the Socks client is now in BoundWaitingForConnection state.
|
||||
This means that the remote proxy server is waiting for a remote connection to the bound port. */
|
||||
this.setState(constants_1.SocksClientState.BoundWaitingForConnection);
|
||||
this.nextRequiredPacketBufferSize =
|
||||
constants_1.SOCKS_INCOMING_PACKET_SIZES.Socks5ResponseHeader;
|
||||
this.emit('bound', { remoteHost, socket: this.socket });
|
||||
/*
|
||||
If using Associate, the Socks client is now Established. And the proxy server is now accepting UDP packets at the
|
||||
given bound port. This initial Socks TCP connection must remain open for the UDP relay to continue to work.
|
||||
*/
|
||||
}
|
||||
else if (constants_1.SocksCommand[this.options.command] === constants_1.SocksCommand.associate) {
|
||||
this.setState(constants_1.SocksClientState.Established);
|
||||
this.removeInternalSocketHandlers();
|
||||
this.emit('established', {
|
||||
remoteHost,
|
||||
socket: this.socket,
|
||||
});
|
||||
}
|
||||
}
|
||||
}
|
||||
/**
|
||||
* Handles Socks v5 incoming connection request (BIND).
|
||||
*/
|
||||
handleSocks5IncomingConnectionResponse() {
|
||||
// Peek at available data (we need at least 5 bytes to get the hostname length)
|
||||
const header = this.receiveBuffer.peek(5);
|
||||
if (header[0] !== 0x05 || header[1] !== constants_1.Socks5Response.Granted) {
|
||||
this.closeSocket(`${constants_1.ERRORS.Socks5ProxyRejectedIncomingBoundConnection} - ${constants_1.Socks5Response[header[1]]}`);
|
||||
}
|
||||
else {
|
||||
// Read address type
|
||||
const addressType = header[3];
|
||||
let remoteHost;
|
||||
let buff;
|
||||
// IPv4
|
||||
if (addressType === constants_1.Socks5HostType.IPv4) {
|
||||
// Check if data is available.
|
||||
const dataNeeded = constants_1.SOCKS_INCOMING_PACKET_SIZES.Socks5ResponseIPv4;
|
||||
if (this.receiveBuffer.length < dataNeeded) {
|
||||
this.nextRequiredPacketBufferSize = dataNeeded;
|
||||
return;
|
||||
}
|
||||
buff = smart_buffer_1.SmartBuffer.fromBuffer(this.receiveBuffer.get(dataNeeded).slice(4));
|
||||
remoteHost = {
|
||||
host: (0, helpers_1.int32ToIpv4)(buff.readUInt32BE()),
|
||||
port: buff.readUInt16BE(),
|
||||
};
|
||||
// If given host is 0.0.0.0, assume remote proxy ip instead.
|
||||
if (remoteHost.host === '0.0.0.0') {
|
||||
remoteHost.host = this.options.proxy.ipaddress;
|
||||
}
|
||||
// Hostname
|
||||
}
|
||||
else if (addressType === constants_1.Socks5HostType.Hostname) {
|
||||
const hostLength = header[4];
|
||||
const dataNeeded = constants_1.SOCKS_INCOMING_PACKET_SIZES.Socks5ResponseHostname(hostLength); // header + host length + port
|
||||
// Check if data is available.
|
||||
if (this.receiveBuffer.length < dataNeeded) {
|
||||
this.nextRequiredPacketBufferSize = dataNeeded;
|
||||
return;
|
||||
}
|
||||
buff = smart_buffer_1.SmartBuffer.fromBuffer(this.receiveBuffer.get(dataNeeded).slice(5));
|
||||
remoteHost = {
|
||||
host: buff.readString(hostLength),
|
||||
port: buff.readUInt16BE(),
|
||||
};
|
||||
// IPv6
|
||||
}
|
||||
else if (addressType === constants_1.Socks5HostType.IPv6) {
|
||||
// Check if data is available.
|
||||
const dataNeeded = constants_1.SOCKS_INCOMING_PACKET_SIZES.Socks5ResponseIPv6;
|
||||
if (this.receiveBuffer.length < dataNeeded) {
|
||||
this.nextRequiredPacketBufferSize = dataNeeded;
|
||||
return;
|
||||
}
|
||||
buff = smart_buffer_1.SmartBuffer.fromBuffer(this.receiveBuffer.get(dataNeeded).slice(4));
|
||||
remoteHost = {
|
||||
host: ip_address_1.Address6.fromByteArray(Array.from(buff.readBuffer(16))).canonicalForm(),
|
||||
port: buff.readUInt16BE(),
|
||||
};
|
||||
}
|
||||
this.setState(constants_1.SocksClientState.Established);
|
||||
this.removeInternalSocketHandlers();
|
||||
this.emit('established', { remoteHost, socket: this.socket });
|
||||
}
|
||||
}
|
||||
get socksClientOptions() {
|
||||
return Object.assign({}, this.options);
|
||||
}
|
||||
}
|
||||
exports.SocksClient = SocksClient;
|
||||
//# sourceMappingURL=socksclient.js.map
|
||||
1
node_modules/socks/build/client/socksclient.js.map
generated
vendored
Normal file
1
node_modules/socks/build/client/socksclient.js.map
generated
vendored
Normal file
File diff suppressed because one or more lines are too long
108
node_modules/socks/build/common/constants.js
generated
vendored
Normal file
108
node_modules/socks/build/common/constants.js
generated
vendored
Normal file
@@ -0,0 +1,108 @@
|
||||
"use strict";
|
||||
Object.defineProperty(exports, "__esModule", { value: true });
|
||||
exports.SOCKS5_NO_ACCEPTABLE_AUTH = exports.SOCKS5_CUSTOM_AUTH_END = exports.SOCKS5_CUSTOM_AUTH_START = exports.SOCKS_INCOMING_PACKET_SIZES = exports.SocksClientState = exports.Socks5Response = exports.Socks5HostType = exports.Socks5Auth = exports.Socks4Response = exports.SocksCommand = exports.ERRORS = exports.DEFAULT_TIMEOUT = void 0;
|
||||
const DEFAULT_TIMEOUT = 30000;
|
||||
exports.DEFAULT_TIMEOUT = DEFAULT_TIMEOUT;
|
||||
// prettier-ignore
|
||||
const ERRORS = {
|
||||
InvalidSocksCommand: 'An invalid SOCKS command was provided. Valid options are connect, bind, and associate.',
|
||||
InvalidSocksCommandForOperation: 'An invalid SOCKS command was provided. Only a subset of commands are supported for this operation.',
|
||||
InvalidSocksCommandChain: 'An invalid SOCKS command was provided. Chaining currently only supports the connect command.',
|
||||
InvalidSocksClientOptionsDestination: 'An invalid destination host was provided.',
|
||||
InvalidSocksClientOptionsExistingSocket: 'An invalid existing socket was provided. This should be an instance of stream.Duplex.',
|
||||
InvalidSocksClientOptionsProxy: 'Invalid SOCKS proxy details were provided.',
|
||||
InvalidSocksClientOptionsTimeout: 'An invalid timeout value was provided. Please enter a value above 0 (in ms).',
|
||||
InvalidSocksClientOptionsProxiesLength: 'At least two socks proxies must be provided for chaining.',
|
||||
InvalidSocksClientOptionsCustomAuthRange: 'Custom auth must be a value between 0x80 and 0xFE.',
|
||||
InvalidSocksClientOptionsCustomAuthOptions: 'When a custom_auth_method is provided, custom_auth_request_handler, custom_auth_response_size, and custom_auth_response_handler must also be provided and valid.',
|
||||
NegotiationError: 'Negotiation error',
|
||||
SocketClosed: 'Socket closed',
|
||||
ProxyConnectionTimedOut: 'Proxy connection timed out',
|
||||
InternalError: 'SocksClient internal error (this should not happen)',
|
||||
InvalidSocks4HandshakeResponse: 'Received invalid Socks4 handshake response',
|
||||
Socks4ProxyRejectedConnection: 'Socks4 Proxy rejected connection',
|
||||
InvalidSocks4IncomingConnectionResponse: 'Socks4 invalid incoming connection response',
|
||||
Socks4ProxyRejectedIncomingBoundConnection: 'Socks4 Proxy rejected incoming bound connection',
|
||||
InvalidSocks5InitialHandshakeResponse: 'Received invalid Socks5 initial handshake response',
|
||||
InvalidSocks5IntiailHandshakeSocksVersion: 'Received invalid Socks5 initial handshake (invalid socks version)',
|
||||
InvalidSocks5InitialHandshakeNoAcceptedAuthType: 'Received invalid Socks5 initial handshake (no accepted authentication type)',
|
||||
InvalidSocks5InitialHandshakeUnknownAuthType: 'Received invalid Socks5 initial handshake (unknown authentication type)',
|
||||
Socks5AuthenticationFailed: 'Socks5 Authentication failed',
|
||||
InvalidSocks5FinalHandshake: 'Received invalid Socks5 final handshake response',
|
||||
InvalidSocks5FinalHandshakeRejected: 'Socks5 proxy rejected connection',
|
||||
InvalidSocks5IncomingConnectionResponse: 'Received invalid Socks5 incoming connection response',
|
||||
Socks5ProxyRejectedIncomingBoundConnection: 'Socks5 Proxy rejected incoming bound connection',
|
||||
};
|
||||
exports.ERRORS = ERRORS;
|
||||
const SOCKS_INCOMING_PACKET_SIZES = {
|
||||
Socks5InitialHandshakeResponse: 2,
|
||||
Socks5UserPassAuthenticationResponse: 2,
|
||||
// Command response + incoming connection (bind)
|
||||
Socks5ResponseHeader: 5, // We need at least 5 to read the hostname length, then we wait for the address+port information.
|
||||
Socks5ResponseIPv4: 10, // 4 header + 4 ip + 2 port
|
||||
Socks5ResponseIPv6: 22, // 4 header + 16 ip + 2 port
|
||||
Socks5ResponseHostname: (hostNameLength) => hostNameLength + 7, // 4 header + 1 host length + host + 2 port
|
||||
// Command response + incoming connection (bind)
|
||||
Socks4Response: 8, // 2 header + 2 port + 4 ip
|
||||
};
|
||||
exports.SOCKS_INCOMING_PACKET_SIZES = SOCKS_INCOMING_PACKET_SIZES;
|
||||
var SocksCommand;
|
||||
(function (SocksCommand) {
|
||||
SocksCommand[SocksCommand["connect"] = 1] = "connect";
|
||||
SocksCommand[SocksCommand["bind"] = 2] = "bind";
|
||||
SocksCommand[SocksCommand["associate"] = 3] = "associate";
|
||||
})(SocksCommand || (exports.SocksCommand = SocksCommand = {}));
|
||||
var Socks4Response;
|
||||
(function (Socks4Response) {
|
||||
Socks4Response[Socks4Response["Granted"] = 90] = "Granted";
|
||||
Socks4Response[Socks4Response["Failed"] = 91] = "Failed";
|
||||
Socks4Response[Socks4Response["Rejected"] = 92] = "Rejected";
|
||||
Socks4Response[Socks4Response["RejectedIdent"] = 93] = "RejectedIdent";
|
||||
})(Socks4Response || (exports.Socks4Response = Socks4Response = {}));
|
||||
var Socks5Auth;
|
||||
(function (Socks5Auth) {
|
||||
Socks5Auth[Socks5Auth["NoAuth"] = 0] = "NoAuth";
|
||||
Socks5Auth[Socks5Auth["GSSApi"] = 1] = "GSSApi";
|
||||
Socks5Auth[Socks5Auth["UserPass"] = 2] = "UserPass";
|
||||
})(Socks5Auth || (exports.Socks5Auth = Socks5Auth = {}));
|
||||
const SOCKS5_CUSTOM_AUTH_START = 0x80;
|
||||
exports.SOCKS5_CUSTOM_AUTH_START = SOCKS5_CUSTOM_AUTH_START;
|
||||
const SOCKS5_CUSTOM_AUTH_END = 0xfe;
|
||||
exports.SOCKS5_CUSTOM_AUTH_END = SOCKS5_CUSTOM_AUTH_END;
|
||||
const SOCKS5_NO_ACCEPTABLE_AUTH = 0xff;
|
||||
exports.SOCKS5_NO_ACCEPTABLE_AUTH = SOCKS5_NO_ACCEPTABLE_AUTH;
|
||||
var Socks5Response;
|
||||
(function (Socks5Response) {
|
||||
Socks5Response[Socks5Response["Granted"] = 0] = "Granted";
|
||||
Socks5Response[Socks5Response["Failure"] = 1] = "Failure";
|
||||
Socks5Response[Socks5Response["NotAllowed"] = 2] = "NotAllowed";
|
||||
Socks5Response[Socks5Response["NetworkUnreachable"] = 3] = "NetworkUnreachable";
|
||||
Socks5Response[Socks5Response["HostUnreachable"] = 4] = "HostUnreachable";
|
||||
Socks5Response[Socks5Response["ConnectionRefused"] = 5] = "ConnectionRefused";
|
||||
Socks5Response[Socks5Response["TTLExpired"] = 6] = "TTLExpired";
|
||||
Socks5Response[Socks5Response["CommandNotSupported"] = 7] = "CommandNotSupported";
|
||||
Socks5Response[Socks5Response["AddressNotSupported"] = 8] = "AddressNotSupported";
|
||||
})(Socks5Response || (exports.Socks5Response = Socks5Response = {}));
|
||||
var Socks5HostType;
|
||||
(function (Socks5HostType) {
|
||||
Socks5HostType[Socks5HostType["IPv4"] = 1] = "IPv4";
|
||||
Socks5HostType[Socks5HostType["Hostname"] = 3] = "Hostname";
|
||||
Socks5HostType[Socks5HostType["IPv6"] = 4] = "IPv6";
|
||||
})(Socks5HostType || (exports.Socks5HostType = Socks5HostType = {}));
|
||||
var SocksClientState;
|
||||
(function (SocksClientState) {
|
||||
SocksClientState[SocksClientState["Created"] = 0] = "Created";
|
||||
SocksClientState[SocksClientState["Connecting"] = 1] = "Connecting";
|
||||
SocksClientState[SocksClientState["Connected"] = 2] = "Connected";
|
||||
SocksClientState[SocksClientState["SentInitialHandshake"] = 3] = "SentInitialHandshake";
|
||||
SocksClientState[SocksClientState["ReceivedInitialHandshakeResponse"] = 4] = "ReceivedInitialHandshakeResponse";
|
||||
SocksClientState[SocksClientState["SentAuthentication"] = 5] = "SentAuthentication";
|
||||
SocksClientState[SocksClientState["ReceivedAuthenticationResponse"] = 6] = "ReceivedAuthenticationResponse";
|
||||
SocksClientState[SocksClientState["SentFinalHandshake"] = 7] = "SentFinalHandshake";
|
||||
SocksClientState[SocksClientState["ReceivedFinalResponse"] = 8] = "ReceivedFinalResponse";
|
||||
SocksClientState[SocksClientState["BoundWaitingForConnection"] = 9] = "BoundWaitingForConnection";
|
||||
SocksClientState[SocksClientState["Established"] = 10] = "Established";
|
||||
SocksClientState[SocksClientState["Disconnected"] = 11] = "Disconnected";
|
||||
SocksClientState[SocksClientState["Error"] = 99] = "Error";
|
||||
})(SocksClientState || (exports.SocksClientState = SocksClientState = {}));
|
||||
//# sourceMappingURL=constants.js.map
|
||||
1
node_modules/socks/build/common/constants.js.map
generated
vendored
Normal file
1
node_modules/socks/build/common/constants.js.map
generated
vendored
Normal file
@@ -0,0 +1 @@
|
||||
{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/common/constants.ts"],"names":[],"mappings":"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"}
|
||||
162
node_modules/socks/build/common/helpers.js
generated
vendored
Normal file
162
node_modules/socks/build/common/helpers.js
generated
vendored
Normal file
@@ -0,0 +1,162 @@
|
||||
"use strict";
|
||||
Object.defineProperty(exports, "__esModule", { value: true });
|
||||
exports.ipToBuffer = exports.int32ToIpv4 = exports.ipv4ToInt32 = exports.validateSocksClientChainOptions = exports.validateSocksClientOptions = void 0;
|
||||
const util_1 = require("./util");
|
||||
const constants_1 = require("./constants");
|
||||
const stream = require("stream");
|
||||
const ip_address_1 = require("ip-address");
|
||||
const net = require("net");
|
||||
/**
|
||||
* Validates the provided SocksClientOptions
|
||||
* @param options { SocksClientOptions }
|
||||
* @param acceptedCommands { string[] } A list of accepted SocksProxy commands.
|
||||
*/
|
||||
function validateSocksClientOptions(options, acceptedCommands = ['connect', 'bind', 'associate']) {
|
||||
// Check SOCKs command option.
|
||||
if (!constants_1.SocksCommand[options.command]) {
|
||||
throw new util_1.SocksClientError(constants_1.ERRORS.InvalidSocksCommand, options);
|
||||
}
|
||||
// Check SocksCommand for acceptable command.
|
||||
if (acceptedCommands.indexOf(options.command) === -1) {
|
||||
throw new util_1.SocksClientError(constants_1.ERRORS.InvalidSocksCommandForOperation, options);
|
||||
}
|
||||
// Check destination
|
||||
if (!isValidSocksRemoteHost(options.destination)) {
|
||||
throw new util_1.SocksClientError(constants_1.ERRORS.InvalidSocksClientOptionsDestination, options);
|
||||
}
|
||||
// Check SOCKS proxy to use
|
||||
if (!isValidSocksProxy(options.proxy)) {
|
||||
throw new util_1.SocksClientError(constants_1.ERRORS.InvalidSocksClientOptionsProxy, options);
|
||||
}
|
||||
// Validate custom auth (if set)
|
||||
validateCustomProxyAuth(options.proxy, options);
|
||||
// Check timeout
|
||||
if (options.timeout && !isValidTimeoutValue(options.timeout)) {
|
||||
throw new util_1.SocksClientError(constants_1.ERRORS.InvalidSocksClientOptionsTimeout, options);
|
||||
}
|
||||
// Check existing_socket (if provided)
|
||||
if (options.existing_socket &&
|
||||
!(options.existing_socket instanceof stream.Duplex)) {
|
||||
throw new util_1.SocksClientError(constants_1.ERRORS.InvalidSocksClientOptionsExistingSocket, options);
|
||||
}
|
||||
}
|
||||
exports.validateSocksClientOptions = validateSocksClientOptions;
|
||||
/**
|
||||
* Validates the SocksClientChainOptions
|
||||
* @param options { SocksClientChainOptions }
|
||||
*/
|
||||
function validateSocksClientChainOptions(options) {
|
||||
// Only connect is supported when chaining.
|
||||
if (options.command !== 'connect') {
|
||||
throw new util_1.SocksClientError(constants_1.ERRORS.InvalidSocksCommandChain, options);
|
||||
}
|
||||
// Check destination
|
||||
if (!isValidSocksRemoteHost(options.destination)) {
|
||||
throw new util_1.SocksClientError(constants_1.ERRORS.InvalidSocksClientOptionsDestination, options);
|
||||
}
|
||||
// Validate proxies (length)
|
||||
if (!(options.proxies &&
|
||||
Array.isArray(options.proxies) &&
|
||||
options.proxies.length >= 2)) {
|
||||
throw new util_1.SocksClientError(constants_1.ERRORS.InvalidSocksClientOptionsProxiesLength, options);
|
||||
}
|
||||
// Validate proxies
|
||||
options.proxies.forEach((proxy) => {
|
||||
if (!isValidSocksProxy(proxy)) {
|
||||
throw new util_1.SocksClientError(constants_1.ERRORS.InvalidSocksClientOptionsProxy, options);
|
||||
}
|
||||
// Validate custom auth (if set)
|
||||
validateCustomProxyAuth(proxy, options);
|
||||
});
|
||||
// Check timeout
|
||||
if (options.timeout && !isValidTimeoutValue(options.timeout)) {
|
||||
throw new util_1.SocksClientError(constants_1.ERRORS.InvalidSocksClientOptionsTimeout, options);
|
||||
}
|
||||
}
|
||||
exports.validateSocksClientChainOptions = validateSocksClientChainOptions;
|
||||
function validateCustomProxyAuth(proxy, options) {
|
||||
if (proxy.custom_auth_method !== undefined) {
|
||||
// Invalid auth method range
|
||||
if (proxy.custom_auth_method < constants_1.SOCKS5_CUSTOM_AUTH_START ||
|
||||
proxy.custom_auth_method > constants_1.SOCKS5_CUSTOM_AUTH_END) {
|
||||
throw new util_1.SocksClientError(constants_1.ERRORS.InvalidSocksClientOptionsCustomAuthRange, options);
|
||||
}
|
||||
// Missing custom_auth_request_handler
|
||||
if (proxy.custom_auth_request_handler === undefined ||
|
||||
typeof proxy.custom_auth_request_handler !== 'function') {
|
||||
throw new util_1.SocksClientError(constants_1.ERRORS.InvalidSocksClientOptionsCustomAuthOptions, options);
|
||||
}
|
||||
// Missing custom_auth_response_size
|
||||
if (proxy.custom_auth_response_size === undefined) {
|
||||
throw new util_1.SocksClientError(constants_1.ERRORS.InvalidSocksClientOptionsCustomAuthOptions, options);
|
||||
}
|
||||
// Missing/invalid custom_auth_response_handler
|
||||
if (proxy.custom_auth_response_handler === undefined ||
|
||||
typeof proxy.custom_auth_response_handler !== 'function') {
|
||||
throw new util_1.SocksClientError(constants_1.ERRORS.InvalidSocksClientOptionsCustomAuthOptions, options);
|
||||
}
|
||||
}
|
||||
}
|
||||
/**
|
||||
* Validates a SocksRemoteHost
|
||||
* @param remoteHost { SocksRemoteHost }
|
||||
*/
|
||||
function isValidSocksRemoteHost(remoteHost) {
|
||||
return (remoteHost &&
|
||||
typeof remoteHost.host === 'string' &&
|
||||
typeof remoteHost.port === 'number' &&
|
||||
remoteHost.port >= 0 &&
|
||||
remoteHost.port <= 65535);
|
||||
}
|
||||
/**
|
||||
* Validates a SocksProxy
|
||||
* @param proxy { SocksProxy }
|
||||
*/
|
||||
function isValidSocksProxy(proxy) {
|
||||
return (proxy &&
|
||||
(typeof proxy.host === 'string' || typeof proxy.ipaddress === 'string') &&
|
||||
typeof proxy.port === 'number' &&
|
||||
proxy.port >= 0 &&
|
||||
proxy.port <= 65535 &&
|
||||
(proxy.type === 4 || proxy.type === 5));
|
||||
}
|
||||
/**
|
||||
* Validates a timeout value.
|
||||
* @param value { Number }
|
||||
*/
|
||||
function isValidTimeoutValue(value) {
|
||||
return typeof value === 'number' && value > 0;
|
||||
}
|
||||
function ipv4ToInt32(ip) {
|
||||
const address = new ip_address_1.Address4(ip);
|
||||
// Convert the IPv4 address parts to an integer
|
||||
return address.toArray().reduce((acc, part) => (acc << 8) + part, 0);
|
||||
}
|
||||
exports.ipv4ToInt32 = ipv4ToInt32;
|
||||
function int32ToIpv4(int32) {
|
||||
// Extract each byte (octet) from the 32-bit integer
|
||||
const octet1 = (int32 >>> 24) & 0xff;
|
||||
const octet2 = (int32 >>> 16) & 0xff;
|
||||
const octet3 = (int32 >>> 8) & 0xff;
|
||||
const octet4 = int32 & 0xff;
|
||||
// Combine the octets into a string in IPv4 format
|
||||
return [octet1, octet2, octet3, octet4].join('.');
|
||||
}
|
||||
exports.int32ToIpv4 = int32ToIpv4;
|
||||
function ipToBuffer(ip) {
|
||||
if (net.isIPv4(ip)) {
|
||||
// Handle IPv4 addresses
|
||||
const address = new ip_address_1.Address4(ip);
|
||||
return Buffer.from(address.toArray());
|
||||
}
|
||||
else if (net.isIPv6(ip)) {
|
||||
// Handle IPv6 addresses
|
||||
const address = new ip_address_1.Address6(ip);
|
||||
return Buffer.from(address.toByteArray());
|
||||
}
|
||||
else {
|
||||
throw new Error('Invalid IP address format');
|
||||
}
|
||||
}
|
||||
exports.ipToBuffer = ipToBuffer;
|
||||
//# sourceMappingURL=helpers.js.map
|
||||
1
node_modules/socks/build/common/helpers.js.map
generated
vendored
Normal file
1
node_modules/socks/build/common/helpers.js.map
generated
vendored
Normal file
@@ -0,0 +1 @@
|
||||
{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/common/helpers.ts"],"names":[],"mappings":"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"}
|
||||
43
node_modules/socks/build/common/receivebuffer.js
generated
vendored
Normal file
43
node_modules/socks/build/common/receivebuffer.js
generated
vendored
Normal file
@@ -0,0 +1,43 @@
|
||||
"use strict";
|
||||
Object.defineProperty(exports, "__esModule", { value: true });
|
||||
exports.ReceiveBuffer = void 0;
|
||||
class ReceiveBuffer {
|
||||
constructor(size = 4096) {
|
||||
this.buffer = Buffer.allocUnsafe(size);
|
||||
this.offset = 0;
|
||||
this.originalSize = size;
|
||||
}
|
||||
get length() {
|
||||
return this.offset;
|
||||
}
|
||||
append(data) {
|
||||
if (!Buffer.isBuffer(data)) {
|
||||
throw new Error('Attempted to append a non-buffer instance to ReceiveBuffer.');
|
||||
}
|
||||
if (this.offset + data.length >= this.buffer.length) {
|
||||
const tmp = this.buffer;
|
||||
this.buffer = Buffer.allocUnsafe(Math.max(this.buffer.length + this.originalSize, this.buffer.length + data.length));
|
||||
tmp.copy(this.buffer);
|
||||
}
|
||||
data.copy(this.buffer, this.offset);
|
||||
return (this.offset += data.length);
|
||||
}
|
||||
peek(length) {
|
||||
if (length > this.offset) {
|
||||
throw new Error('Attempted to read beyond the bounds of the managed internal data.');
|
||||
}
|
||||
return this.buffer.slice(0, length);
|
||||
}
|
||||
get(length) {
|
||||
if (length > this.offset) {
|
||||
throw new Error('Attempted to read beyond the bounds of the managed internal data.');
|
||||
}
|
||||
const value = Buffer.allocUnsafe(length);
|
||||
this.buffer.slice(0, length).copy(value);
|
||||
this.buffer.copyWithin(0, length, length + this.offset - length);
|
||||
this.offset -= length;
|
||||
return value;
|
||||
}
|
||||
}
|
||||
exports.ReceiveBuffer = ReceiveBuffer;
|
||||
//# sourceMappingURL=receivebuffer.js.map
|
||||
1
node_modules/socks/build/common/receivebuffer.js.map
generated
vendored
Normal file
1
node_modules/socks/build/common/receivebuffer.js.map
generated
vendored
Normal file
@@ -0,0 +1 @@
|
||||
{"version":3,"file":"receivebuffer.js","sourceRoot":"","sources":["../../src/common/receivebuffer.ts"],"names":[],"mappings":";;;AAAA,MAAM,aAAa;IAKjB,YAAY,IAAI,GAAG,IAAI;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,6DAA6D,CAC9D,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACpD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,CAC9B,IAAI,CAAC,GAAG,CACN,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,EACtC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CACjC,CACF,CAAC;YACF,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,MAAc;QACjB,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC;QAEtB,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAEO,sCAAa"}
|
||||
25
node_modules/socks/build/common/util.js
generated
vendored
Normal file
25
node_modules/socks/build/common/util.js
generated
vendored
Normal file
@@ -0,0 +1,25 @@
|
||||
"use strict";
|
||||
Object.defineProperty(exports, "__esModule", { value: true });
|
||||
exports.shuffleArray = exports.SocksClientError = void 0;
|
||||
/**
|
||||
* Error wrapper for SocksClient
|
||||
*/
|
||||
class SocksClientError extends Error {
|
||||
constructor(message, options) {
|
||||
super(message);
|
||||
this.options = options;
|
||||
}
|
||||
}
|
||||
exports.SocksClientError = SocksClientError;
|
||||
/**
|
||||
* Shuffles a given array.
|
||||
* @param array The array to shuffle.
|
||||
*/
|
||||
function shuffleArray(array) {
|
||||
for (let i = array.length - 1; i > 0; i--) {
|
||||
const j = Math.floor(Math.random() * (i + 1));
|
||||
[array[i], array[j]] = [array[j], array[i]];
|
||||
}
|
||||
}
|
||||
exports.shuffleArray = shuffleArray;
|
||||
//# sourceMappingURL=util.js.map
|
||||
1
node_modules/socks/build/common/util.js.map
generated
vendored
Normal file
1
node_modules/socks/build/common/util.js.map
generated
vendored
Normal file
@@ -0,0 +1 @@
|
||||
{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/common/util.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACH,MAAM,gBAAiB,SAAQ,KAAK;IAClC,YACE,OAAe,EACR,OAAqD;QAE5D,KAAK,CAAC,OAAO,CAAC,CAAC;QAFR,YAAO,GAAP,OAAO,CAA8C;IAG9D,CAAC;CACF;AAaO,4CAAgB;AAXxB;;;GAGG;AACH,SAAS,YAAY,CAAC,KAAgB;IACpC,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9C,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAEyB,oCAAY"}
|
||||
18
node_modules/socks/build/index.js
generated
vendored
Normal file
18
node_modules/socks/build/index.js
generated
vendored
Normal file
@@ -0,0 +1,18 @@
|
||||
"use strict";
|
||||
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
||||
if (k2 === undefined) k2 = k;
|
||||
var desc = Object.getOwnPropertyDescriptor(m, k);
|
||||
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
||||
desc = { enumerable: true, get: function() { return m[k]; } };
|
||||
}
|
||||
Object.defineProperty(o, k2, desc);
|
||||
}) : (function(o, m, k, k2) {
|
||||
if (k2 === undefined) k2 = k;
|
||||
o[k2] = m[k];
|
||||
}));
|
||||
var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
||||
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
||||
};
|
||||
Object.defineProperty(exports, "__esModule", { value: true });
|
||||
__exportStar(require("./client/socksclient"), exports);
|
||||
//# sourceMappingURL=index.js.map
|
||||
1
node_modules/socks/build/index.js.map
generated
vendored
Normal file
1
node_modules/socks/build/index.js.map
generated
vendored
Normal file
@@ -0,0 +1 @@
|
||||
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC"}
|
||||
17
node_modules/socks/docs/examples/index.md
generated
vendored
Normal file
17
node_modules/socks/docs/examples/index.md
generated
vendored
Normal file
@@ -0,0 +1,17 @@
|
||||
# socks examples
|
||||
|
||||
## TypeScript Examples
|
||||
|
||||
[Connect command](typescript/connectExample.md)
|
||||
|
||||
[Bind command](typescript/bindExample.md)
|
||||
|
||||
[Associate command](typescript/associateExample.md)
|
||||
|
||||
## JavaScript Examples
|
||||
|
||||
[Connect command](javascript/connectExample.md)
|
||||
|
||||
[Bind command](javascript/bindExample.md)
|
||||
|
||||
[Associate command](javascript/associateExample.md)
|
||||
90
node_modules/socks/docs/examples/javascript/associateExample.md
generated
vendored
Normal file
90
node_modules/socks/docs/examples/javascript/associateExample.md
generated
vendored
Normal file
@@ -0,0 +1,90 @@
|
||||
# socks examples
|
||||
|
||||
## Example for SOCKS 'associate' command
|
||||
|
||||
The associate command tells the SOCKS proxy server to establish a UDP relay. The server binds to a new UDP port and communicates the newly opened port back to the origin client. From here, any SOCKS UDP frame packets sent to this special UDP port on the Proxy server will be forwarded to the desired destination, and any responses will be forwarded back to the origin client (you).
|
||||
|
||||
This can be used for things such as DNS queries, and other UDP communicates.
|
||||
|
||||
**Connection Steps**
|
||||
|
||||
1. Client -(associate)-> Proxy (Tells the proxy to create a UDP relay and bind on a new port)
|
||||
2. Client <-(port)- Proxy (Tells the origin client which port it opened and is accepting UDP frame packets on)
|
||||
|
||||
At this point the proxy is accepting UDP frames on the specified port.
|
||||
|
||||
3. Client --(udp frame) -> Proxy -> Destination (The origin client sends a UDP frame to the proxy on the UDP port, and the proxy then forwards it to the destination specified in the UDP frame.)
|
||||
4. Client <--(udp frame) <-- Proxy <-- Destination (The destination client responds to the udp packet sent in #3)
|
||||
|
||||
## Usage
|
||||
|
||||
The 'associate' command can only be used by creating a new SocksClient instance and listening for the 'established' event.
|
||||
|
||||
**Note:** UDP packets relayed through the proxy servers are encompassed in a special Socks UDP frame format. SocksClient.createUDPFrame() and SocksClient.parseUDPFrame() create and parse these special UDP packets.
|
||||
|
||||
```typescript
|
||||
const dgram = require('dgram');
|
||||
const SocksClient = require('socks').SocksClient;
|
||||
|
||||
// Create a local UDP socket for sending/receiving packets to/from the proxy.
|
||||
const udpSocket = dgram.createSocket('udp4');
|
||||
udpSocket.bind();
|
||||
|
||||
// Listen for incoming UDP packets from the proxy server.
|
||||
udpSocket.on('message', (message, rinfo) => {
|
||||
console.log(SocksClient.parseUDPFrame(message));
|
||||
/*
|
||||
{ frameNumber: 0,
|
||||
remoteHost: { host: '8.8.8.8', port: 53 }, // The remote host that replied with a UDP packet
|
||||
data: <Buffer 74 65 73 74 0a> // The data
|
||||
}
|
||||
*/
|
||||
});
|
||||
|
||||
const options = {
|
||||
proxy: {
|
||||
host: '104.131.124.203',
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
|
||||
// This should be the ip and port of the expected client that will be sending UDP frames to the newly opened UDP port on the server.
|
||||
// Most SOCKS servers accept 0.0.0.0 as a wildcard address to accept UDP frames from any source.
|
||||
destination: {
|
||||
host: '0.0.0.0',
|
||||
port: 0
|
||||
},
|
||||
|
||||
command: 'associate'
|
||||
};
|
||||
|
||||
const client = new SocksClient(options);
|
||||
|
||||
// This event is fired when the SOCKS server has started listening on a new UDP port for UDP relaying.
|
||||
client.on('established', info => {
|
||||
console.log(info);
|
||||
/*
|
||||
{
|
||||
socket: <Socket ...>,
|
||||
remoteHost: { // This is the remote port on the SOCKS proxy server to send UDP frame packets to.
|
||||
host: '104.131.124.203',
|
||||
port: 58232
|
||||
}
|
||||
}
|
||||
*/
|
||||
|
||||
// Send a udp frame to 8.8.8.8 on port 53 through the proxy.
|
||||
const packet = SocksClient.createUDPFrame({
|
||||
remoteHost: { host: '8.8.8.8', port: 53 },
|
||||
data: Buffer.from('hello') // A DNS lookup in the real world.
|
||||
});
|
||||
|
||||
// Send packet.
|
||||
udpSocket.send(packet, info.remoteHost.port, info.remoteHost.host);
|
||||
});
|
||||
|
||||
// SOCKS proxy failed to bind.
|
||||
client.on('error', () => {
|
||||
// Handle errors
|
||||
});
|
||||
```
|
||||
83
node_modules/socks/docs/examples/javascript/bindExample.md
generated
vendored
Normal file
83
node_modules/socks/docs/examples/javascript/bindExample.md
generated
vendored
Normal file
@@ -0,0 +1,83 @@
|
||||
# socks examples
|
||||
|
||||
## Example for SOCKS 'bind' command
|
||||
|
||||
The bind command tells the SOCKS proxy server to bind and listen on a new TCP port for an incoming connection. It communicates the newly opened port back to the origin client. Once a incoming connection is accepted by the SOCKS proxy server it then communicates the remote host that connected to the SOCKS proxy back through the same initial connection via the origin client.
|
||||
|
||||
This can be used for things such as FTP clients which require incoming TCP connections, etc.
|
||||
|
||||
**Connection Steps**
|
||||
|
||||
1. Client -(bind)-> Proxy (Tells the proxy to bind to a new port)
|
||||
2. Client <-(port)- Proxy (Tells the origin client which port it opened)
|
||||
3. Client2 --> Proxy (Other client connects to the proxy on this port)
|
||||
4. Client <--(client2's host info) (Proxy tells the origin client who connected to it)
|
||||
5. Original connection to the proxy is now a full TCP stream between client (you) and client2.
|
||||
6. Client <--> Proxy <--> Client2
|
||||
|
||||
|
||||
## Usage
|
||||
|
||||
The 'bind' command can only be used by creating a new SocksClient instance and listening for 'bound' and 'established' events.
|
||||
|
||||
|
||||
```typescript
|
||||
const SocksClient = require('socks').SocksClient;
|
||||
|
||||
const options = {
|
||||
proxy: {
|
||||
host: '104.131.124.203',
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
|
||||
// This should be the ip and port of the expected client that will connect to the SOCKS proxy server on the newly bound port.
|
||||
// Most SOCKS servers accept 0.0.0.0 as a wildcard address to accept any client.
|
||||
destination: {
|
||||
host: '0.0.0.0',
|
||||
port: 0
|
||||
},
|
||||
|
||||
command: 'bind'
|
||||
};
|
||||
|
||||
const client = new SocksClient(options);
|
||||
|
||||
// This event is fired when the SOCKS server has started listening on a new port for incoming connections.
|
||||
client.on('bound', (info) => {
|
||||
console.log(info);
|
||||
/*
|
||||
{
|
||||
socket: <Socket ...>,
|
||||
remoteHost: { // This is the remote ip and port of the SOCKS proxy that is now accepting incoming connections.
|
||||
host: '104.131.124.203',
|
||||
port: 49928
|
||||
}
|
||||
}
|
||||
*/
|
||||
});
|
||||
|
||||
// This event is fired when the SOCKS server has accepted an incoming connection on the newly bound port.
|
||||
client.on('established', (info) => {
|
||||
console.log(info);
|
||||
/*
|
||||
{
|
||||
socket: <Socket ...>,
|
||||
remoteHost: { // This is the remote ip and port that connected to the SOCKS proxy on the newly bound port.
|
||||
host: '1.2.3.4',
|
||||
port: 58232
|
||||
}
|
||||
}
|
||||
*/
|
||||
|
||||
// At this point info.socket is a regular net.Socket TCP connection between client and client2 (1.2.3.4) (the client which connected to the proxy on the newly bound port.)
|
||||
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy servers)
|
||||
});
|
||||
|
||||
// SOCKS proxy failed to bind.
|
||||
client.on('error', () => {
|
||||
// Handle errors
|
||||
});
|
||||
```
|
||||
258
node_modules/socks/docs/examples/javascript/connectExample.md
generated
vendored
Normal file
258
node_modules/socks/docs/examples/javascript/connectExample.md
generated
vendored
Normal file
@@ -0,0 +1,258 @@
|
||||
# socks examples
|
||||
|
||||
## Example for SOCKS 'connect' command
|
||||
|
||||
The connect command is the most common use-case for a SOCKS proxy. This establishes a direct connection to a destination host through a proxy server. The destination host only has knowledge of the proxy server connecting to it and does not know about the origin client (you).
|
||||
|
||||
**Origin Client (you) <-> Proxy Server <-> Destination Server**
|
||||
|
||||
In this example, we are connecting to a web server on port 80, and sending a very basic HTTP request to receive a response. It's worth noting that there are many socks-http-agents that can be used with the node http module (and libraries such as request.js) to make this easier. This HTTP request is used as a simple example.
|
||||
|
||||
The 'connect' command can be used via the SocksClient.createConnection() factory function as well as by creating a SocksClient instance and using event handlers.
|
||||
|
||||
### Using createConnection with async/await
|
||||
|
||||
Since SocksClient.createConnection returns a Promise, we can easily use async/await for flow control.
|
||||
|
||||
```typescript
|
||||
const SocksClient = require('socks').SocksClient;
|
||||
|
||||
const options = {
|
||||
proxy: {
|
||||
host: '104.131.124.203',
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
|
||||
destination: {
|
||||
host: 'ip-api.com', // host names are supported with SOCKS v4a and SOCKS v5.
|
||||
port: 80
|
||||
},
|
||||
|
||||
command: 'connect'
|
||||
};
|
||||
|
||||
async function start() {
|
||||
try {
|
||||
const info = await SocksClient.createConnection(options);
|
||||
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy servers)
|
||||
|
||||
info.socket.write('GET /json HTTP/1.1\nHost: ip-api.com\n\n');
|
||||
info.socket.on('data', (data) => {
|
||||
console.log(data.toString()); // ip-api.com sees that the last proxy (104.131.124.203) is connected to it and not the origin client (you).
|
||||
/*
|
||||
HTTP/1.1 200 OK
|
||||
Access-Control-Allow-Origin: *
|
||||
Content-Type: application/json; charset=utf-8
|
||||
Date: Sun, 24 Dec 2017 03:47:51 GMT
|
||||
Content-Length: 300
|
||||
|
||||
{
|
||||
"as":"AS14061 Digital Ocean, Inc.",
|
||||
"city":"Clifton",
|
||||
"country":"United States",
|
||||
"countryCode":"US",
|
||||
"isp":"Digital Ocean",
|
||||
"lat":40.8326,
|
||||
"lon":-74.1307,
|
||||
"org":"Digital Ocean",
|
||||
"query":"104.131.124.203",
|
||||
"region":"NJ",
|
||||
"regionName":"New Jersey",
|
||||
"status":"success",
|
||||
"timezone":"America/New_York",
|
||||
"zip":"07014"
|
||||
}
|
||||
*/
|
||||
} catch (err) {
|
||||
// Handle errors
|
||||
}
|
||||
}
|
||||
|
||||
start();
|
||||
```
|
||||
|
||||
### Using createConnection with Promises
|
||||
|
||||
```typescript
|
||||
const SocksClient = require('socks').SocksClient;
|
||||
|
||||
const options = {
|
||||
proxy: {
|
||||
ipaddress: '104.131.124.203',
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
|
||||
destination: {
|
||||
host: 'ip-api.com', // host names are supported with SOCKS v4a and SOCKS v5.
|
||||
port: 80
|
||||
},
|
||||
|
||||
command: 'connect'
|
||||
};
|
||||
|
||||
SocksClient.createConnection(options)
|
||||
.then(info => {
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy servers)
|
||||
|
||||
info.socket.write('GET /json HTTP/1.1\nHost: ip-api.com\n\n');
|
||||
info.socket.on('data', (data) => {
|
||||
console.log(data.toString()); // ip-api.com sees that the last proxy (104.131.124.203) is connected to it and not the origin client (you).
|
||||
/*
|
||||
HTTP/1.1 200 OK
|
||||
Access-Control-Allow-Origin: *
|
||||
Content-Type: application/json; charset=utf-8
|
||||
Date: Sun, 24 Dec 2017 03:47:51 GMT
|
||||
Content-Length: 300
|
||||
|
||||
{
|
||||
"as":"AS14061 Digital Ocean, Inc.",
|
||||
"city":"Clifton",
|
||||
"country":"United States",
|
||||
"countryCode":"US",
|
||||
"isp":"Digital Ocean",
|
||||
"lat":40.8326,
|
||||
"lon":-74.1307,
|
||||
"org":"Digital Ocean",
|
||||
"query":"104.131.124.203",
|
||||
"region":"NJ",
|
||||
"regionName":"New Jersey",
|
||||
"status":"success",
|
||||
"timezone":"America/New_York",
|
||||
"zip":"07014"
|
||||
}
|
||||
*/
|
||||
})
|
||||
.catch(err => {
|
||||
// handle errors
|
||||
});
|
||||
```
|
||||
|
||||
### Using createConnection with callbacks
|
||||
|
||||
SocksClient.createConnection() optionally accepts a callback function as a second parameter.
|
||||
|
||||
**Note:** If a callback function is provided, a Promise is still returned from the function, but the promise will always resolve regardless of if there was en error. (tldr: Do not mix callbacks and Promises).
|
||||
|
||||
```typescript
|
||||
const SocksClient = require('socks').SocksClient;
|
||||
|
||||
const options = {
|
||||
proxy: {
|
||||
ipaddress: '104.131.124.203',
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
|
||||
destination: {
|
||||
host: 'ip-api.com', // host names are supported with SOCKS v4a and SOCKS v5.
|
||||
port: 80
|
||||
},
|
||||
|
||||
command: 'connect'
|
||||
};
|
||||
|
||||
SocksClient.createConnection(options, (err, info) => {
|
||||
if (err) {
|
||||
// handle errors
|
||||
} else {
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy servers)
|
||||
|
||||
info.socket.write('GET /json HTTP/1.1\nHost: ip-api.com\n\n');
|
||||
info.socket.on('data', (data) => {
|
||||
console.log(data.toString()); // ip-api.com sees that the last proxy (104.131.124.203) is connected to it and not the origin client (you).
|
||||
/*
|
||||
HTTP/1.1 200 OK
|
||||
Access-Control-Allow-Origin: *
|
||||
Content-Type: application/json; charset=utf-8
|
||||
Date: Sun, 24 Dec 2017 03:47:51 GMT
|
||||
Content-Length: 300
|
||||
|
||||
{
|
||||
"as":"AS14061 Digital Ocean, Inc.",
|
||||
"city":"Clifton",
|
||||
"country":"United States",
|
||||
"countryCode":"US",
|
||||
"isp":"Digital Ocean",
|
||||
"lat":40.8326,
|
||||
"lon":-74.1307,
|
||||
"org":"Digital Ocean",
|
||||
"query":"104.131.124.203",
|
||||
"region":"NJ",
|
||||
"regionName":"New Jersey",
|
||||
"status":"success",
|
||||
"timezone":"America/New_York",
|
||||
"zip":"07014"
|
||||
}
|
||||
*/
|
||||
}
|
||||
})
|
||||
```
|
||||
|
||||
### Using event handlers
|
||||
|
||||
SocksClient also supports instance creation of a SocksClient. This allows for event based flow control.
|
||||
|
||||
```typescript
|
||||
const SocksClient = require('socks').SocksClient;
|
||||
|
||||
const options = {
|
||||
proxy: {
|
||||
ipaddress: '104.131.124.203',
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
|
||||
destination: {
|
||||
host: 'ip-api.com', // host names are supported with SOCKS v4a and SOCKS v5.
|
||||
port: 80
|
||||
},
|
||||
|
||||
command: 'connect'
|
||||
};
|
||||
|
||||
const client = new SocksClient(options);
|
||||
|
||||
client.on('established', (info) => {
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy servers)
|
||||
|
||||
info.socket.write('GET /json HTTP/1.1\nHost: ip-api.com\n\n');
|
||||
info.socket.on('data', (data) => {
|
||||
console.log(data.toString()); // ip-api.com sees that the last proxy (104.131.124.203) is connected to it and not the origin client (you).
|
||||
/*
|
||||
HTTP/1.1 200 OK
|
||||
Access-Control-Allow-Origin: *
|
||||
Content-Type: application/json; charset=utf-8
|
||||
Date: Sun, 24 Dec 2017 03:47:51 GMT
|
||||
Content-Length: 300
|
||||
|
||||
{
|
||||
"as":"AS14061 Digital Ocean, Inc.",
|
||||
"city":"Clifton",
|
||||
"country":"United States",
|
||||
"countryCode":"US",
|
||||
"isp":"Digital Ocean",
|
||||
"lat":40.8326,
|
||||
"lon":-74.1307,
|
||||
"org":"Digital Ocean",
|
||||
"query":"104.131.124.203",
|
||||
"region":"NJ",
|
||||
"regionName":"New Jersey",
|
||||
"status":"success",
|
||||
"timezone":"America/New_York",
|
||||
"zip":"07014"
|
||||
}
|
||||
*/
|
||||
});
|
||||
|
||||
// Failed to establish proxy connection to destination.
|
||||
client.on('error', () => {
|
||||
// Handle errors
|
||||
});
|
||||
```
|
||||
93
node_modules/socks/docs/examples/typescript/associateExample.md
generated
vendored
Normal file
93
node_modules/socks/docs/examples/typescript/associateExample.md
generated
vendored
Normal file
@@ -0,0 +1,93 @@
|
||||
# socks examples
|
||||
|
||||
## Example for SOCKS 'associate' command
|
||||
|
||||
The associate command tells the SOCKS proxy server to establish a UDP relay. The server binds to a new UDP port and communicates the newly opened port back to the origin client. From here, any SOCKS UDP frame packets sent to this special UDP port on the Proxy server will be forwarded to the desired destination, and any responses will be forwarded back to the origin client (you).
|
||||
|
||||
This can be used for things such as DNS queries, and other UDP communicates.
|
||||
|
||||
**Connection Steps**
|
||||
|
||||
1. Client -(associate)-> Proxy (Tells the proxy to create a UDP relay and bind on a new port)
|
||||
2. Client <-(port)- Proxy (Tells the origin client which port it opened and is accepting UDP frame packets on)
|
||||
|
||||
At this point the proxy is accepting UDP frames on the specified port.
|
||||
|
||||
3. Client --(udp frame) -> Proxy -> Destination (The origin client sends a UDP frame to the proxy on the UDP port, and the proxy then forwards it to the destination specified in the UDP frame.)
|
||||
4. Client <--(udp frame) <-- Proxy <-- Destination (The destination client responds to the udp packet sent in #3)
|
||||
|
||||
## Usage
|
||||
|
||||
The 'associate' command can only be used by creating a new SocksClient instance and listening for the 'established' event.
|
||||
|
||||
**Note:** UDP packets relayed through the proxy servers are packaged in a special Socks UDP frame format. SocksClient.createUDPFrame() and SocksClient.parseUDPFrame() create and parse these special UDP packets.
|
||||
|
||||
```typescript
|
||||
import * as dgram from 'dgram';
|
||||
import { SocksClient, SocksClientOptions } from 'socks';
|
||||
|
||||
// Create a local UDP socket for sending/receiving packets to/from the proxy.
|
||||
const udpSocket = dgram.createSocket('udp4');
|
||||
udpSocket.bind();
|
||||
|
||||
// Listen for incoming UDP packets from the proxy server.
|
||||
udpSocket.on('message', (message, rinfo) => {
|
||||
console.log(SocksClient.parseUDPFrame(message));
|
||||
/*
|
||||
{ frameNumber: 0,
|
||||
remoteHost: { host: '8.8.8.8', port: 53 }, // The remote host that replied with a UDP packet
|
||||
data: <Buffer 74 65 73 74 0a> // The data
|
||||
}
|
||||
*/
|
||||
});
|
||||
|
||||
const options: SocksClientOptions = {
|
||||
proxy: {
|
||||
host: '104.131.124.203',
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
|
||||
// This should be the ip and port of the expected client that will be sending UDP frames to the newly opened UDP port on the server.
|
||||
// Most SOCKS servers accept 0.0.0.0 as a wildcard address to accept UDP frames from any source.
|
||||
destination: {
|
||||
host: '0.0.0.0',
|
||||
port: 0
|
||||
},
|
||||
|
||||
command: 'associate'
|
||||
};
|
||||
|
||||
const client = new SocksClient(options);
|
||||
|
||||
// This event is fired when the SOCKS server has started listening on a new UDP port for UDP relaying.
|
||||
client.on('established', info => {
|
||||
console.log(info);
|
||||
/*
|
||||
{
|
||||
socket: <Socket ...>,
|
||||
remoteHost: { // This is the remote port on the SOCKS proxy server to send UDP frame packets to.
|
||||
host: '104.131.124.203',
|
||||
port: 58232
|
||||
}
|
||||
}
|
||||
*/
|
||||
|
||||
// Send a udp frame to 8.8.8.8 on port 53 through the proxy.
|
||||
const packet = SocksClient.createUDPFrame({
|
||||
remoteHost: { host: '8.8.8.8', port: 53 },
|
||||
data: Buffer.from('hello') // A DNS lookup in the real world.
|
||||
});
|
||||
|
||||
// Send packet.
|
||||
udpSocket.send(packet, info.remoteHost.port, info.remoteHost.host);
|
||||
});
|
||||
|
||||
// SOCKS proxy failed to bind.
|
||||
client.on('error', () => {
|
||||
// Handle errors
|
||||
});
|
||||
|
||||
// Start connection
|
||||
client.connect();
|
||||
```
|
||||
86
node_modules/socks/docs/examples/typescript/bindExample.md
generated
vendored
Normal file
86
node_modules/socks/docs/examples/typescript/bindExample.md
generated
vendored
Normal file
@@ -0,0 +1,86 @@
|
||||
# socks examples
|
||||
|
||||
## Example for SOCKS 'bind' command
|
||||
|
||||
The bind command tells the SOCKS proxy server to bind and listen on a new TCP port for an incoming connection. It communicates the newly opened port back to the origin client. Once a incoming connection is accepted by the SOCKS proxy server it then communicates the remote host that connected to the SOCKS proxy back through the same initial connection via the origin client.
|
||||
|
||||
This can be used for things such as FTP clients which require incoming TCP connections, etc.
|
||||
|
||||
**Connection Steps**
|
||||
|
||||
1. Client -(bind)-> Proxy (Tells the proxy to bind to a new port)
|
||||
2. Client <-(port)- Proxy (Tells the origin client which port it opened)
|
||||
3. Client2 --> Proxy (Other client connects to the proxy on this port)
|
||||
4. Client <--(client2's host info) (Proxy tells the origin client who connected to it)
|
||||
5. Original connection to the proxy is now a full TCP stream between client (you) and client2.
|
||||
6. Client <--> Proxy <--> Client2
|
||||
|
||||
|
||||
## Usage
|
||||
|
||||
The 'bind' command can only be used by creating a new SocksClient instance and listening for 'bound' and 'established' events.
|
||||
|
||||
|
||||
```typescript
|
||||
import { SocksClient, SocksClientOptions } from 'socks';
|
||||
|
||||
const options: SocksClientOptions = {
|
||||
proxy: {
|
||||
host: '104.131.124.203',
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
|
||||
// This should be the ip and port of the expected client that will connect to the SOCKS proxy server on the newly bound port.
|
||||
// Most SOCKS servers accept 0.0.0.0 as a wildcard address to accept any client.
|
||||
destination: {
|
||||
host: '0.0.0.0',
|
||||
port: 0
|
||||
},
|
||||
|
||||
command: 'bind'
|
||||
};
|
||||
|
||||
const client = new SocksClient(options);
|
||||
|
||||
// This event is fired when the SOCKS server has started listening on a new port for incoming connections.
|
||||
client.on('bound', (info) => {
|
||||
console.log(info);
|
||||
/*
|
||||
{
|
||||
socket: <Socket ...>,
|
||||
remoteHost: { // This is the remote ip and port of the SOCKS proxy that is now accepting incoming connections.
|
||||
host: '104.131.124.203',
|
||||
port: 49928
|
||||
}
|
||||
}
|
||||
*/
|
||||
});
|
||||
|
||||
// This event is fired when the SOCKS server has accepted an incoming connection on the newly bound port.
|
||||
client.on('established', (info) => {
|
||||
console.log(info);
|
||||
/*
|
||||
{
|
||||
socket: <Socket ...>,
|
||||
remoteHost: { // This is the remote ip and port that connected to the SOCKS proxy on the newly bound port.
|
||||
host: '1.2.3.4',
|
||||
port: 58232
|
||||
}
|
||||
}
|
||||
*/
|
||||
|
||||
// At this point info.socket is a regular net.Socket TCP connection between client and client2 (1.2.3.4) (the client which connected to the proxy on the newly bound port.)
|
||||
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy servers)
|
||||
});
|
||||
|
||||
// SOCKS proxy failed to bind.
|
||||
client.on('error', () => {
|
||||
// Handle errors
|
||||
});
|
||||
|
||||
// Start connection
|
||||
client.connect();
|
||||
```
|
||||
265
node_modules/socks/docs/examples/typescript/connectExample.md
generated
vendored
Normal file
265
node_modules/socks/docs/examples/typescript/connectExample.md
generated
vendored
Normal file
@@ -0,0 +1,265 @@
|
||||
# socks examples
|
||||
|
||||
## Example for SOCKS 'connect' command
|
||||
|
||||
The connect command is the most common use-case for a SOCKS proxy. This establishes a direct connection to a destination host through a proxy server. The destination host only has knowledge of the proxy server connecting to it and does not know about the origin client (you).
|
||||
|
||||
**Origin Client (you) <-> Proxy Server <-> Destination Server**
|
||||
|
||||
In this example, we are connecting to a web server on port 80, and sending a very basic HTTP request to receive a response. It's worth noting that there are many socks-http-agents that can be used with the node http module (and libraries such as request.js) to make this easier. This HTTP request is used as a simple example.
|
||||
|
||||
The 'connect' command can be used via the SocksClient.createConnection() factory function as well as by creating a SocksClient instance and using event handlers.
|
||||
|
||||
### Using createConnection with async/await
|
||||
|
||||
Since SocksClient.createConnection returns a Promise, we can easily use async/await for flow control.
|
||||
|
||||
```typescript
|
||||
import { SocksClient, SocksClientOptions } from 'socks';
|
||||
|
||||
const options: SocksClientOptions = {
|
||||
proxy: {
|
||||
host: '104.131.124.203',
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
|
||||
destination: {
|
||||
host: 'ip-api.com', // host names are supported with SOCKS v4a and SOCKS v5.
|
||||
port: 80
|
||||
},
|
||||
|
||||
command: 'connect'
|
||||
};
|
||||
|
||||
async function start() {
|
||||
try {
|
||||
const info = await SocksClient.createConnection(options);
|
||||
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy servers)
|
||||
|
||||
info.socket.write('GET /json HTTP/1.1\nHost: ip-api.com\n\n');
|
||||
info.socket.on('data', (data) => {
|
||||
console.log(data.toString()); // ip-api.com sees that the last proxy (104.131.124.203) is connected to it and not the origin client (you).
|
||||
/*
|
||||
HTTP/1.1 200 OK
|
||||
Access-Control-Allow-Origin: *
|
||||
Content-Type: application/json; charset=utf-8
|
||||
Date: Sun, 24 Dec 2017 03:47:51 GMT
|
||||
Content-Length: 300
|
||||
|
||||
{
|
||||
"as":"AS14061 Digital Ocean, Inc.",
|
||||
"city":"Clifton",
|
||||
"country":"United States",
|
||||
"countryCode":"US",
|
||||
"isp":"Digital Ocean",
|
||||
"lat":40.8326,
|
||||
"lon":-74.1307,
|
||||
"org":"Digital Ocean",
|
||||
"query":"104.131.124.203",
|
||||
"region":"NJ",
|
||||
"regionName":"New Jersey",
|
||||
"status":"success",
|
||||
"timezone":"America/New_York",
|
||||
"zip":"07014"
|
||||
}
|
||||
*/
|
||||
});
|
||||
} catch (err) {
|
||||
// Handle errors
|
||||
}
|
||||
}
|
||||
|
||||
start();
|
||||
```
|
||||
|
||||
### Using createConnection with Promises
|
||||
|
||||
```typescript
|
||||
import { SocksClient, SocksClientOptions } from 'socks';
|
||||
|
||||
const options: SocksClientOptions = {
|
||||
proxy: {
|
||||
ipaddress: '104.131.124.203',
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
|
||||
destination: {
|
||||
host: 'ip-api.com', // host names are supported with SOCKS v4a and SOCKS v5.
|
||||
port: 80
|
||||
},
|
||||
|
||||
command: 'connect'
|
||||
};
|
||||
|
||||
SocksClient.createConnection(options)
|
||||
.then(info => {
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy servers)
|
||||
|
||||
info.socket.write('GET /json HTTP/1.1\nHost: ip-api.com\n\n');
|
||||
info.socket.on('data', (data) => {
|
||||
console.log(data.toString()); // ip-api.com sees that the last proxy (104.131.124.203) is connected to it and not the origin client (you).
|
||||
/*
|
||||
HTTP/1.1 200 OK
|
||||
Access-Control-Allow-Origin: *
|
||||
Content-Type: application/json; charset=utf-8
|
||||
Date: Sun, 24 Dec 2017 03:47:51 GMT
|
||||
Content-Length: 300
|
||||
|
||||
{
|
||||
"as":"AS14061 Digital Ocean, Inc.",
|
||||
"city":"Clifton",
|
||||
"country":"United States",
|
||||
"countryCode":"US",
|
||||
"isp":"Digital Ocean",
|
||||
"lat":40.8326,
|
||||
"lon":-74.1307,
|
||||
"org":"Digital Ocean",
|
||||
"query":"104.131.124.203",
|
||||
"region":"NJ",
|
||||
"regionName":"New Jersey",
|
||||
"status":"success",
|
||||
"timezone":"America/New_York",
|
||||
"zip":"07014"
|
||||
}
|
||||
*/
|
||||
});
|
||||
})
|
||||
.catch(err => {
|
||||
// handle errors
|
||||
});
|
||||
```
|
||||
|
||||
### Using createConnection with callbacks
|
||||
|
||||
SocksClient.createConnection() optionally accepts a callback function as a second parameter.
|
||||
|
||||
**Note:** If a callback function is provided, a Promise is still returned from the function, but the promise will always resolve regardless of if there was en error. (tldr: Do not mix callbacks and Promises).
|
||||
|
||||
```typescript
|
||||
import { SocksClient, SocksClientOptions } from 'socks';
|
||||
|
||||
const options: SocksClientOptions = {
|
||||
proxy: {
|
||||
ipaddress: '104.131.124.203',
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
|
||||
destination: {
|
||||
host: 'ip-api.com', // host names are supported with SOCKS v4a and SOCKS v5.
|
||||
port: 80
|
||||
},
|
||||
|
||||
command: 'connect'
|
||||
};
|
||||
|
||||
SocksClient.createConnection(options, (err, info) => {
|
||||
if (err) {
|
||||
// handle errors
|
||||
} else {
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy servers)
|
||||
|
||||
info.socket.write('GET /json HTTP/1.1\nHost: ip-api.com\n\n');
|
||||
info.socket.on('data', (data) => {
|
||||
console.log(data.toString()); // ip-api.com sees that the last proxy (104.131.124.203) is connected to it and not the origin client (you).
|
||||
/*
|
||||
HTTP/1.1 200 OK
|
||||
Access-Control-Allow-Origin: *
|
||||
Content-Type: application/json; charset=utf-8
|
||||
Date: Sun, 24 Dec 2017 03:47:51 GMT
|
||||
Content-Length: 300
|
||||
|
||||
{
|
||||
"as":"AS14061 Digital Ocean, Inc.",
|
||||
"city":"Clifton",
|
||||
"country":"United States",
|
||||
"countryCode":"US",
|
||||
"isp":"Digital Ocean",
|
||||
"lat":40.8326,
|
||||
"lon":-74.1307,
|
||||
"org":"Digital Ocean",
|
||||
"query":"104.131.124.203",
|
||||
"region":"NJ",
|
||||
"regionName":"New Jersey",
|
||||
"status":"success",
|
||||
"timezone":"America/New_York",
|
||||
"zip":"07014"
|
||||
}
|
||||
*/
|
||||
});
|
||||
}
|
||||
})
|
||||
```
|
||||
|
||||
### Using event handlers
|
||||
|
||||
SocksClient also supports instance creation of a SocksClient. This allows for event based flow control.
|
||||
|
||||
```typescript
|
||||
import { SocksClient, SocksClientOptions } from 'socks';
|
||||
|
||||
const options: SocksClientOptions = {
|
||||
proxy: {
|
||||
ipaddress: '104.131.124.203',
|
||||
port: 1081,
|
||||
type: 5
|
||||
},
|
||||
|
||||
destination: {
|
||||
host: 'ip-api.com', // host names are supported with SOCKS v4a and SOCKS v5.
|
||||
port: 80
|
||||
},
|
||||
|
||||
command: 'connect'
|
||||
};
|
||||
|
||||
const client = new SocksClient(options);
|
||||
|
||||
client.on('established', (info) => {
|
||||
console.log(info.socket);
|
||||
// <Socket ...> (this is a raw net.Socket that is established to the destination host through the given proxy servers)
|
||||
|
||||
info.socket.write('GET /json HTTP/1.1\nHost: ip-api.com\n\n');
|
||||
info.socket.on('data', (data) => {
|
||||
console.log(data.toString()); // ip-api.com sees that the last proxy (104.131.124.203) is connected to it and not the origin client (you).
|
||||
/*
|
||||
HTTP/1.1 200 OK
|
||||
Access-Control-Allow-Origin: *
|
||||
Content-Type: application/json; charset=utf-8
|
||||
Date: Sun, 24 Dec 2017 03:47:51 GMT
|
||||
Content-Length: 300
|
||||
|
||||
{
|
||||
"as":"AS14061 Digital Ocean, Inc.",
|
||||
"city":"Clifton",
|
||||
"country":"United States",
|
||||
"countryCode":"US",
|
||||
"isp":"Digital Ocean",
|
||||
"lat":40.8326,
|
||||
"lon":-74.1307,
|
||||
"org":"Digital Ocean",
|
||||
"query":"104.131.124.203",
|
||||
"region":"NJ",
|
||||
"regionName":"New Jersey",
|
||||
"status":"success",
|
||||
"timezone":"America/New_York",
|
||||
"zip":"07014"
|
||||
}
|
||||
*/
|
||||
});
|
||||
});
|
||||
|
||||
// Failed to establish proxy connection to destination.
|
||||
client.on('error', () => {
|
||||
// Handle errors
|
||||
});
|
||||
|
||||
// Start connection
|
||||
client.connect();
|
||||
```
|
||||
5
node_modules/socks/docs/index.md
generated
vendored
Normal file
5
node_modules/socks/docs/index.md
generated
vendored
Normal file
@@ -0,0 +1,5 @@
|
||||
# Documentation
|
||||
|
||||
- [API Reference](https://github.com/JoshGlazebrook/socks#api-reference)
|
||||
|
||||
- [Code Examples](./examples/index.md)
|
||||
86
node_modules/socks/docs/migratingFromV1.md
generated
vendored
Normal file
86
node_modules/socks/docs/migratingFromV1.md
generated
vendored
Normal file
@@ -0,0 +1,86 @@
|
||||
# socks
|
||||
|
||||
## Migrating from v1
|
||||
|
||||
For the most part, migrating from v1 takes minimal effort as v2 still supports factory creation of proxy connections with callback support.
|
||||
|
||||
### Notable breaking changes
|
||||
|
||||
- In an options object, the proxy 'command' is now required and does not default to 'connect'.
|
||||
- **In an options object, 'target' is now known as 'destination'.**
|
||||
- Sockets are no longer paused after a SOCKS connection is made, so socket.resume() is no longer required. (Please be sure to attach data handlers immediately to the Socket to avoid losing data).
|
||||
- In v2, only the 'connect' command is supported via the factory SocksClient.createConnection function. (BIND and ASSOCIATE must be used with a SocksClient instance via event handlers).
|
||||
- In v2, the factory SocksClient.createConnection function callback is called with a single object rather than separate socket and info object.
|
||||
- A SOCKS http/https agent is no longer bundled into the library.
|
||||
|
||||
For informational purposes, here is the original getting started example from v1 converted to work with v2.
|
||||
|
||||
### Before (v1)
|
||||
|
||||
```javascript
|
||||
var Socks = require('socks');
|
||||
|
||||
var options = {
|
||||
proxy: {
|
||||
ipaddress: "202.101.228.108",
|
||||
port: 1080,
|
||||
type: 5
|
||||
},
|
||||
target: {
|
||||
host: "google.com",
|
||||
port: 80
|
||||
},
|
||||
command: 'connect'
|
||||
};
|
||||
|
||||
Socks.createConnection(options, function(err, socket, info) {
|
||||
if (err)
|
||||
console.log(err);
|
||||
else {
|
||||
socket.write("GET / HTTP/1.1\nHost: google.com\n\n");
|
||||
socket.on('data', function(data) {
|
||||
console.log(data.length);
|
||||
console.log(data);
|
||||
});
|
||||
|
||||
// PLEASE NOTE: sockets need to be resumed before any data will come in or out as they are paused right before this callback is fired.
|
||||
socket.resume();
|
||||
|
||||
// 569
|
||||
// <Buffer 48 54 54 50 2f 31 2e 31 20 33 30 31 20 4d 6f 76 65 64 20 50 65...
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
### After (v2)
|
||||
```javascript
|
||||
const SocksClient = require('socks').SocksClient;
|
||||
|
||||
let options = {
|
||||
proxy: {
|
||||
ipaddress: "202.101.228.108",
|
||||
port: 1080,
|
||||
type: 5
|
||||
},
|
||||
destination: {
|
||||
host: "google.com",
|
||||
port: 80
|
||||
},
|
||||
command: 'connect'
|
||||
};
|
||||
|
||||
SocksClient.createConnection(options, function(err, result) {
|
||||
if (err)
|
||||
console.log(err);
|
||||
else {
|
||||
result.socket.write("GET / HTTP/1.1\nHost: google.com\n\n");
|
||||
result.socket.on('data', function(data) {
|
||||
console.log(data.length);
|
||||
console.log(data);
|
||||
});
|
||||
|
||||
// 569
|
||||
// <Buffer 48 54 54 50 2f 31 2e 31 20 33 30 31 20 4d 6f 76 65 64 20 50 65...
|
||||
}
|
||||
});
|
||||
```
|
||||
58
node_modules/socks/package.json
generated
vendored
Normal file
58
node_modules/socks/package.json
generated
vendored
Normal file
@@ -0,0 +1,58 @@
|
||||
{
|
||||
"name": "socks",
|
||||
"private": false,
|
||||
"version": "2.8.1",
|
||||
"description": "Fully featured SOCKS proxy client supporting SOCKSv4, SOCKSv4a, and SOCKSv5. Includes Bind and Associate functionality.",
|
||||
"main": "build/index.js",
|
||||
"typings": "typings/index.d.ts",
|
||||
"homepage": "https://github.com/JoshGlazebrook/socks/",
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "https://github.com/JoshGlazebrook/socks.git"
|
||||
},
|
||||
"bugs": {
|
||||
"url": "https://github.com/JoshGlazebrook/socks/issues"
|
||||
},
|
||||
"keywords": [
|
||||
"socks",
|
||||
"proxy",
|
||||
"tor",
|
||||
"socks 4",
|
||||
"socks 5",
|
||||
"socks4",
|
||||
"socks5"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 10.0.0",
|
||||
"npm": ">= 3.0.0"
|
||||
},
|
||||
"author": "Josh Glazebrook",
|
||||
"contributors": [
|
||||
"castorw"
|
||||
],
|
||||
"license": "MIT",
|
||||
"readmeFilename": "README.md",
|
||||
"devDependencies": {
|
||||
"@types/mocha": "^10.0.6",
|
||||
"@types/node": "^20.11.17",
|
||||
"@typescript-eslint/eslint-plugin": "^6.21.0",
|
||||
"@typescript-eslint/parser": "^6.21.0",
|
||||
"eslint": "^8.20.0",
|
||||
"mocha": "^10.0.0",
|
||||
"prettier": "^3.2.5",
|
||||
"ts-node": "^10.9.1",
|
||||
"typescript": "^5.3.3"
|
||||
},
|
||||
"dependencies": {
|
||||
"ip-address": "^9.0.5",
|
||||
"smart-buffer": "^4.2.0"
|
||||
},
|
||||
"scripts": {
|
||||
"prepublish": "npm install -g typescript && npm run build",
|
||||
"test": "NODE_ENV=test mocha --recursive --require ts-node/register test/**/*.ts",
|
||||
"prettier": "prettier --write ./src/**/*.ts --config .prettierrc.yaml",
|
||||
"lint": "eslint 'src/**/*.ts'",
|
||||
"build": "rm -rf build typings && prettier --write ./src/**/*.ts --config .prettierrc.yaml && tsc -p .",
|
||||
"build-raw": "rm -rf build typings && tsc -p ."
|
||||
}
|
||||
}
|
||||
162
node_modules/socks/typings/client/socksclient.d.ts
generated
vendored
Normal file
162
node_modules/socks/typings/client/socksclient.d.ts
generated
vendored
Normal file
@@ -0,0 +1,162 @@
|
||||
/// <reference types="node" />
|
||||
/// <reference types="node" />
|
||||
/// <reference types="node" />
|
||||
import { EventEmitter } from 'events';
|
||||
import { SocksClientOptions, SocksClientChainOptions, SocksRemoteHost, SocksProxy, SocksClientBoundEvent, SocksClientEstablishedEvent, SocksUDPFrameDetails } from '../common/constants';
|
||||
import { SocksClientError } from '../common/util';
|
||||
import { Duplex } from 'stream';
|
||||
declare interface SocksClient {
|
||||
on(event: 'error', listener: (err: SocksClientError) => void): this;
|
||||
on(event: 'bound', listener: (info: SocksClientBoundEvent) => void): this;
|
||||
on(event: 'established', listener: (info: SocksClientEstablishedEvent) => void): this;
|
||||
once(event: string, listener: (...args: unknown[]) => void): this;
|
||||
once(event: 'error', listener: (err: SocksClientError) => void): this;
|
||||
once(event: 'bound', listener: (info: SocksClientBoundEvent) => void): this;
|
||||
once(event: 'established', listener: (info: SocksClientEstablishedEvent) => void): this;
|
||||
emit(event: string | symbol, ...args: unknown[]): boolean;
|
||||
emit(event: 'error', err: SocksClientError): boolean;
|
||||
emit(event: 'bound', info: SocksClientBoundEvent): boolean;
|
||||
emit(event: 'established', info: SocksClientEstablishedEvent): boolean;
|
||||
}
|
||||
declare class SocksClient extends EventEmitter implements SocksClient {
|
||||
private options;
|
||||
private socket;
|
||||
private state;
|
||||
private receiveBuffer;
|
||||
private nextRequiredPacketBufferSize;
|
||||
private socks5ChosenAuthType;
|
||||
private onDataReceived;
|
||||
private onClose;
|
||||
private onError;
|
||||
private onConnect;
|
||||
constructor(options: SocksClientOptions);
|
||||
/**
|
||||
* Creates a new SOCKS connection.
|
||||
*
|
||||
* Note: Supports callbacks and promises. Only supports the connect command.
|
||||
* @param options { SocksClientOptions } Options.
|
||||
* @param callback { Function } An optional callback function.
|
||||
* @returns { Promise }
|
||||
*/
|
||||
static createConnection(options: SocksClientOptions, callback?: (error: Error | null, info?: SocksClientEstablishedEvent) => void): Promise<SocksClientEstablishedEvent>;
|
||||
/**
|
||||
* Creates a new SOCKS connection chain to a destination host through 2 or more SOCKS proxies.
|
||||
*
|
||||
* Note: Supports callbacks and promises. Only supports the connect method.
|
||||
* Note: Implemented via createConnection() factory function.
|
||||
* @param options { SocksClientChainOptions } Options
|
||||
* @param callback { Function } An optional callback function.
|
||||
* @returns { Promise }
|
||||
*/
|
||||
static createConnectionChain(options: SocksClientChainOptions, callback?: (error: Error | null, socket?: SocksClientEstablishedEvent) => void): Promise<SocksClientEstablishedEvent>;
|
||||
/**
|
||||
* Creates a SOCKS UDP Frame.
|
||||
* @param options
|
||||
*/
|
||||
static createUDPFrame(options: SocksUDPFrameDetails): Buffer;
|
||||
/**
|
||||
* Parses a SOCKS UDP frame.
|
||||
* @param data
|
||||
*/
|
||||
static parseUDPFrame(data: Buffer): SocksUDPFrameDetails;
|
||||
/**
|
||||
* Internal state setter. If the SocksClient is in an error state, it cannot be changed to a non error state.
|
||||
*/
|
||||
private setState;
|
||||
/**
|
||||
* Starts the connection establishment to the proxy and destination.
|
||||
* @param existingSocket Connected socket to use instead of creating a new one (internal use).
|
||||
*/
|
||||
connect(existingSocket?: Duplex): void;
|
||||
private getSocketOptions;
|
||||
/**
|
||||
* Handles internal Socks timeout callback.
|
||||
* Note: If the Socks client is not BoundWaitingForConnection or Established, the connection will be closed.
|
||||
*/
|
||||
private onEstablishedTimeout;
|
||||
/**
|
||||
* Handles Socket connect event.
|
||||
*/
|
||||
private onConnectHandler;
|
||||
/**
|
||||
* Handles Socket data event.
|
||||
* @param data
|
||||
*/
|
||||
private onDataReceivedHandler;
|
||||
/**
|
||||
* Handles processing of the data we have received.
|
||||
*/
|
||||
private processData;
|
||||
/**
|
||||
* Handles Socket close event.
|
||||
* @param had_error
|
||||
*/
|
||||
private onCloseHandler;
|
||||
/**
|
||||
* Handles Socket error event.
|
||||
* @param err
|
||||
*/
|
||||
private onErrorHandler;
|
||||
/**
|
||||
* Removes internal event listeners on the underlying Socket.
|
||||
*/
|
||||
private removeInternalSocketHandlers;
|
||||
/**
|
||||
* Closes and destroys the underlying Socket. Emits an error event.
|
||||
* @param err { String } An error string to include in error event.
|
||||
*/
|
||||
private closeSocket;
|
||||
/**
|
||||
* Sends initial Socks v4 handshake request.
|
||||
*/
|
||||
private sendSocks4InitialHandshake;
|
||||
/**
|
||||
* Handles Socks v4 handshake response.
|
||||
* @param data
|
||||
*/
|
||||
private handleSocks4FinalHandshakeResponse;
|
||||
/**
|
||||
* Handles Socks v4 incoming connection request (BIND)
|
||||
* @param data
|
||||
*/
|
||||
private handleSocks4IncomingConnectionResponse;
|
||||
/**
|
||||
* Sends initial Socks v5 handshake request.
|
||||
*/
|
||||
private sendSocks5InitialHandshake;
|
||||
/**
|
||||
* Handles initial Socks v5 handshake response.
|
||||
* @param data
|
||||
*/
|
||||
private handleInitialSocks5HandshakeResponse;
|
||||
/**
|
||||
* Sends Socks v5 user & password auth handshake.
|
||||
*
|
||||
* Note: No auth and user/pass are currently supported.
|
||||
*/
|
||||
private sendSocks5UserPassAuthentication;
|
||||
private sendSocks5CustomAuthentication;
|
||||
private handleSocks5CustomAuthHandshakeResponse;
|
||||
private handleSocks5AuthenticationNoAuthHandshakeResponse;
|
||||
private handleSocks5AuthenticationUserPassHandshakeResponse;
|
||||
/**
|
||||
* Handles Socks v5 auth handshake response.
|
||||
* @param data
|
||||
*/
|
||||
private handleInitialSocks5AuthenticationHandshakeResponse;
|
||||
/**
|
||||
* Sends Socks v5 final handshake request.
|
||||
*/
|
||||
private sendSocks5CommandRequest;
|
||||
/**
|
||||
* Handles Socks v5 final handshake response.
|
||||
* @param data
|
||||
*/
|
||||
private handleSocks5FinalHandshakeResponse;
|
||||
/**
|
||||
* Handles Socks v5 incoming connection request (BIND).
|
||||
*/
|
||||
private handleSocks5IncomingConnectionResponse;
|
||||
get socksClientOptions(): SocksClientOptions;
|
||||
}
|
||||
export { SocksClient, SocksClientOptions, SocksClientChainOptions, SocksClientError, SocksRemoteHost, SocksProxy, SocksUDPFrameDetails, };
|
||||
151
node_modules/socks/typings/common/constants.d.ts
generated
vendored
Normal file
151
node_modules/socks/typings/common/constants.d.ts
generated
vendored
Normal file
@@ -0,0 +1,151 @@
|
||||
/// <reference types="node" />
|
||||
/// <reference types="node" />
|
||||
/// <reference types="node" />
|
||||
import { Duplex } from 'stream';
|
||||
import { Socket, SocketConnectOpts } from 'net';
|
||||
declare const DEFAULT_TIMEOUT = 30000;
|
||||
type SocksProxyType = 4 | 5;
|
||||
declare const ERRORS: {
|
||||
InvalidSocksCommand: string;
|
||||
InvalidSocksCommandForOperation: string;
|
||||
InvalidSocksCommandChain: string;
|
||||
InvalidSocksClientOptionsDestination: string;
|
||||
InvalidSocksClientOptionsExistingSocket: string;
|
||||
InvalidSocksClientOptionsProxy: string;
|
||||
InvalidSocksClientOptionsTimeout: string;
|
||||
InvalidSocksClientOptionsProxiesLength: string;
|
||||
InvalidSocksClientOptionsCustomAuthRange: string;
|
||||
InvalidSocksClientOptionsCustomAuthOptions: string;
|
||||
NegotiationError: string;
|
||||
SocketClosed: string;
|
||||
ProxyConnectionTimedOut: string;
|
||||
InternalError: string;
|
||||
InvalidSocks4HandshakeResponse: string;
|
||||
Socks4ProxyRejectedConnection: string;
|
||||
InvalidSocks4IncomingConnectionResponse: string;
|
||||
Socks4ProxyRejectedIncomingBoundConnection: string;
|
||||
InvalidSocks5InitialHandshakeResponse: string;
|
||||
InvalidSocks5IntiailHandshakeSocksVersion: string;
|
||||
InvalidSocks5InitialHandshakeNoAcceptedAuthType: string;
|
||||
InvalidSocks5InitialHandshakeUnknownAuthType: string;
|
||||
Socks5AuthenticationFailed: string;
|
||||
InvalidSocks5FinalHandshake: string;
|
||||
InvalidSocks5FinalHandshakeRejected: string;
|
||||
InvalidSocks5IncomingConnectionResponse: string;
|
||||
Socks5ProxyRejectedIncomingBoundConnection: string;
|
||||
};
|
||||
declare const SOCKS_INCOMING_PACKET_SIZES: {
|
||||
Socks5InitialHandshakeResponse: number;
|
||||
Socks5UserPassAuthenticationResponse: number;
|
||||
Socks5ResponseHeader: number;
|
||||
Socks5ResponseIPv4: number;
|
||||
Socks5ResponseIPv6: number;
|
||||
Socks5ResponseHostname: (hostNameLength: number) => number;
|
||||
Socks4Response: number;
|
||||
};
|
||||
type SocksCommandOption = 'connect' | 'bind' | 'associate';
|
||||
declare enum SocksCommand {
|
||||
connect = 1,
|
||||
bind = 2,
|
||||
associate = 3
|
||||
}
|
||||
declare enum Socks4Response {
|
||||
Granted = 90,
|
||||
Failed = 91,
|
||||
Rejected = 92,
|
||||
RejectedIdent = 93
|
||||
}
|
||||
declare enum Socks5Auth {
|
||||
NoAuth = 0,
|
||||
GSSApi = 1,
|
||||
UserPass = 2
|
||||
}
|
||||
declare const SOCKS5_CUSTOM_AUTH_START = 128;
|
||||
declare const SOCKS5_CUSTOM_AUTH_END = 254;
|
||||
declare const SOCKS5_NO_ACCEPTABLE_AUTH = 255;
|
||||
declare enum Socks5Response {
|
||||
Granted = 0,
|
||||
Failure = 1,
|
||||
NotAllowed = 2,
|
||||
NetworkUnreachable = 3,
|
||||
HostUnreachable = 4,
|
||||
ConnectionRefused = 5,
|
||||
TTLExpired = 6,
|
||||
CommandNotSupported = 7,
|
||||
AddressNotSupported = 8
|
||||
}
|
||||
declare enum Socks5HostType {
|
||||
IPv4 = 1,
|
||||
Hostname = 3,
|
||||
IPv6 = 4
|
||||
}
|
||||
declare enum SocksClientState {
|
||||
Created = 0,
|
||||
Connecting = 1,
|
||||
Connected = 2,
|
||||
SentInitialHandshake = 3,
|
||||
ReceivedInitialHandshakeResponse = 4,
|
||||
SentAuthentication = 5,
|
||||
ReceivedAuthenticationResponse = 6,
|
||||
SentFinalHandshake = 7,
|
||||
ReceivedFinalResponse = 8,
|
||||
BoundWaitingForConnection = 9,
|
||||
Established = 10,
|
||||
Disconnected = 11,
|
||||
Error = 99
|
||||
}
|
||||
/**
|
||||
* Represents a SocksProxy
|
||||
*/
|
||||
interface SocksProxy {
|
||||
ipaddress?: string;
|
||||
host?: string;
|
||||
port: number;
|
||||
type: SocksProxyType;
|
||||
userId?: string;
|
||||
password?: string;
|
||||
custom_auth_method?: number;
|
||||
custom_auth_request_handler?: () => Promise<Buffer>;
|
||||
custom_auth_response_size?: number;
|
||||
custom_auth_response_handler?: (data: Buffer) => Promise<boolean>;
|
||||
}
|
||||
/**
|
||||
* Represents a remote host
|
||||
*/
|
||||
interface SocksRemoteHost {
|
||||
host: string;
|
||||
port: number;
|
||||
}
|
||||
/**
|
||||
* SocksClient connection options.
|
||||
*/
|
||||
interface SocksClientOptions {
|
||||
command: SocksCommandOption;
|
||||
destination: SocksRemoteHost;
|
||||
proxy: SocksProxy;
|
||||
timeout?: number;
|
||||
existing_socket?: Duplex;
|
||||
set_tcp_nodelay?: boolean;
|
||||
socket_options?: SocketConnectOpts;
|
||||
}
|
||||
/**
|
||||
* SocksClient chain connection options.
|
||||
*/
|
||||
interface SocksClientChainOptions {
|
||||
command: 'connect';
|
||||
destination: SocksRemoteHost;
|
||||
proxies: SocksProxy[];
|
||||
timeout?: number;
|
||||
randomizeChain?: false;
|
||||
}
|
||||
interface SocksClientEstablishedEvent {
|
||||
socket: Socket;
|
||||
remoteHost?: SocksRemoteHost;
|
||||
}
|
||||
type SocksClientBoundEvent = SocksClientEstablishedEvent;
|
||||
interface SocksUDPFrameDetails {
|
||||
frameNumber?: number;
|
||||
remoteHost: SocksRemoteHost;
|
||||
data: Buffer;
|
||||
}
|
||||
export { DEFAULT_TIMEOUT, ERRORS, SocksProxyType, SocksCommand, Socks4Response, Socks5Auth, Socks5HostType, Socks5Response, SocksClientState, SocksProxy, SocksRemoteHost, SocksCommandOption, SocksClientOptions, SocksClientChainOptions, SocksClientEstablishedEvent, SocksClientBoundEvent, SocksUDPFrameDetails, SOCKS_INCOMING_PACKET_SIZES, SOCKS5_CUSTOM_AUTH_START, SOCKS5_CUSTOM_AUTH_END, SOCKS5_NO_ACCEPTABLE_AUTH, };
|
||||
17
node_modules/socks/typings/common/helpers.d.ts
generated
vendored
Normal file
17
node_modules/socks/typings/common/helpers.d.ts
generated
vendored
Normal file
@@ -0,0 +1,17 @@
|
||||
/// <reference types="node" />
|
||||
import { SocksClientOptions, SocksClientChainOptions } from '../client/socksclient';
|
||||
/**
|
||||
* Validates the provided SocksClientOptions
|
||||
* @param options { SocksClientOptions }
|
||||
* @param acceptedCommands { string[] } A list of accepted SocksProxy commands.
|
||||
*/
|
||||
declare function validateSocksClientOptions(options: SocksClientOptions, acceptedCommands?: string[]): void;
|
||||
/**
|
||||
* Validates the SocksClientChainOptions
|
||||
* @param options { SocksClientChainOptions }
|
||||
*/
|
||||
declare function validateSocksClientChainOptions(options: SocksClientChainOptions): void;
|
||||
export { validateSocksClientOptions, validateSocksClientChainOptions };
|
||||
export declare function ipv4ToInt32(ip: string): number;
|
||||
export declare function int32ToIpv4(int32: number): string;
|
||||
export declare function ipToBuffer(ip: string): Buffer;
|
||||
12
node_modules/socks/typings/common/receivebuffer.d.ts
generated
vendored
Normal file
12
node_modules/socks/typings/common/receivebuffer.d.ts
generated
vendored
Normal file
@@ -0,0 +1,12 @@
|
||||
/// <reference types="node" />
|
||||
declare class ReceiveBuffer {
|
||||
private buffer;
|
||||
private offset;
|
||||
private originalSize;
|
||||
constructor(size?: number);
|
||||
get length(): number;
|
||||
append(data: Buffer): number;
|
||||
peek(length: number): Buffer;
|
||||
get(length: number): Buffer;
|
||||
}
|
||||
export { ReceiveBuffer };
|
||||
14
node_modules/socks/typings/common/util.d.ts
generated
vendored
Normal file
14
node_modules/socks/typings/common/util.d.ts
generated
vendored
Normal file
@@ -0,0 +1,14 @@
|
||||
import { SocksClientOptions, SocksClientChainOptions } from './constants';
|
||||
/**
|
||||
* Error wrapper for SocksClient
|
||||
*/
|
||||
declare class SocksClientError extends Error {
|
||||
options: SocksClientOptions | SocksClientChainOptions;
|
||||
constructor(message: string, options: SocksClientOptions | SocksClientChainOptions);
|
||||
}
|
||||
/**
|
||||
* Shuffles a given array.
|
||||
* @param array The array to shuffle.
|
||||
*/
|
||||
declare function shuffleArray(array: unknown[]): void;
|
||||
export { SocksClientError, shuffleArray };
|
||||
1
node_modules/socks/typings/index.d.ts
generated
vendored
Normal file
1
node_modules/socks/typings/index.d.ts
generated
vendored
Normal file
@@ -0,0 +1 @@
|
||||
export * from './client/socksclient';
|
||||
Reference in New Issue
Block a user