/** * Copyright (c) Microsoft Corporation. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ import net from 'net'; import { assert } from './utils'; // https://tools.ietf.org/html/rfc1928 enum SocksAuth { NO_AUTHENTICATION_REQUIRED = 0x00, GSSAPI = 0x01, USERNAME_PASSWORD = 0x02, NO_ACCEPTABLE_METHODS = 0xFF } enum SocksAddressType { IPv4 = 0x01, FqName = 0x03, IPv6 = 0x04 } enum SocksCommand { CONNECT = 0x01, BIND = 0x02, UDP_ASSOCIATE = 0x03 } enum SocksReply { Succeeded = 0x00, GeneralServerFailure = 0x01, NotAllowedByRuleSet = 0x02, NetworkUnreachable = 0x03, HostUnreachable = 0x04, ConnectionRefused = 0x05, TtlExpired = 0x06, CommandNotSupported = 0x07, AddressTypeNotSupported = 0x08 } export interface SocksConnectionClient { onSocketRequested(uid: string, host: string, port: number): void; onSocketData(uid: string, data: Buffer): void; onSocketClosed(uid: string): void; } export class SocksConnection { private _buffer = Buffer.from([]); private _offset = 0; private _fence = 0; private _fenceCallback: (() => void) | undefined; private _socket: net.Socket; private _boundOnData: (buffer: Buffer) => void; private _uid: string; private _client: SocksConnectionClient; constructor(uid: string, socket: net.Socket, client: SocksConnectionClient) { this._uid = uid; this._socket = socket; this._client = client; this._boundOnData = this._onData.bind(this); socket.on('data', this._boundOnData); socket.on('close', () => this._onClose()); socket.on('end', () => this._onClose()); socket.on('error', () => this._onClose()); this._run().catch(() => this._socket.end()); } async _run() { assert(await this._authenticate()); const { command, host, port } = await this._parseRequest(); if (command !== SocksCommand.CONNECT) { this._writeBytes(Buffer.from([ 0x05, SocksReply.CommandNotSupported, 0x00, // RSV 0x01, // IPv4 0x00, 0x00, 0x00, 0x00, // Address 0x00, 0x00 // Port ])); return; } this._socket.off('data', this._boundOnData); this._client.onSocketRequested(this._uid, host, port); } async _authenticate(): Promise { // Request: // +----+----------+----------+ // |VER | NMETHODS | METHODS | // +----+----------+----------+ // | 1 | 1 | 1 to 255 | // +----+----------+----------+ // Response: // +----+--------+ // |VER | METHOD | // +----+--------+ // | 1 | 1 | // +----+--------+ const version = await this._readByte(); assert(version === 0x05, 'The VER field must be set to x05 for this version of the protocol, was ' + version); const nMethods = await this._readByte(); assert(nMethods, 'No authentication methods specified'); const methods = await this._readBytes(nMethods); for (const method of methods) { if (method === 0) { this._writeBytes(Buffer.from([version, method])); return true; } } this._writeBytes(Buffer.from([version, SocksAuth.NO_ACCEPTABLE_METHODS])); return false; } async _parseRequest(): Promise<{ host: string, port: number, command: SocksCommand }> { // Request. // +----+-----+-------+------+----------+----------+ // |VER | CMD | RSV | ATYP | DST.ADDR | DST.PORT | // +----+-----+-------+------+----------+----------+ // | 1 | 1 | X'00' | 1 | Variable | 2 | // +----+-----+-------+------+----------+----------+ // Response. // +----+-----+-------+------+----------+----------+ // |VER | REP | RSV | ATYP | BND.ADDR | BND.PORT | // +----+-----+-------+------+----------+----------+ // | 1 | 1 | X'00' | 1 | Variable | 2 | // +----+-----+-------+------+----------+----------+ const version = await this._readByte(); assert(version === 0x05, 'The VER field must be set to x05 for this version of the protocol, was ' + version); const command = await this._readByte(); await this._readByte(); // skip reserved. const addressType = await this._readByte(); let host = ''; switch (addressType) { case SocksAddressType.IPv4: host = (await this._readBytes(4)).join('.'); break; case SocksAddressType.FqName: const length = await this._readByte(); host = (await this._readBytes(length)).toString(); break; case SocksAddressType.IPv6: const bytes = await this._readBytes(16); const tokens = []; for (let i = 0; i < 8; ++i) tokens.push(bytes.readUInt16BE(i * 2)); host = tokens.join(':'); break; } const port = (await this._readBytes(2)).readUInt16BE(0); this._buffer = Buffer.from([]); this._offset = 0; this._fence = 0; return { command, host, port }; } private async _readByte(): Promise { const buffer = await this._readBytes(1); return buffer[0]; } private async _readBytes(length: number): Promise { this._fence = this._offset + length; if (!this._buffer || this._buffer.length < this._fence) await new Promise(f => this._fenceCallback = f); this._offset += length; return this._buffer.slice(this._offset - length, this._offset); } private _writeBytes(buffer: Buffer) { if (this._socket.writable) this._socket.write(buffer); } private _onClose() { this._client.onSocketClosed(this._uid); } private _onData(buffer: Buffer) { this._buffer = Buffer.concat([this._buffer, buffer]); if (this._fenceCallback && this._buffer.length >= this._fence) { const callback = this._fenceCallback; this._fenceCallback = undefined; callback(); } } socketConnected(host: string, port: number) { this._writeBytes(Buffer.from([ 0x05, SocksReply.Succeeded, 0x00, // RSV 0x01, // IPv4 ...parseIP(host), // Address port << 8, port & 0xFF // Port ])); this._socket.on('data', data => this._client.onSocketData(this._uid, data)); } socketFailed(errorCode: string) { const buffer = Buffer.from([ 0x05, 0, 0x00, // RSV 0x01, // IPv4 ...parseIP('0.0.0.0'), // Address 0, 0 // Port ]); switch (errorCode) { case 'ENOENT': case 'ENOTFOUND': case 'ETIMEDOUT': case 'EHOSTUNREACH': buffer[1] = SocksReply.HostUnreachable; break; case 'ENETUNREACH': buffer[1] = SocksReply.NetworkUnreachable; break; case 'ECONNREFUSED': buffer[1] = SocksReply.ConnectionRefused; break; } this._writeBytes(buffer); this._socket.end(); } sendData(data: Buffer) { this._socket.write(data); } end() { this._socket.end(); } error(error: string) { this._socket.destroy(new Error(error)); } } function parseIP(address: string): number[] { if (!net.isIPv4(address)) throw new Error('IPv6 is not supported'); return address.split('.', 4).map(t => +t); }