npm · #519 most downloaded on npm

socks

2.8.10246M downloads/moJoshGlazebrook/socks ↗New releases in your daily digest, changelog included.

Fully featured SOCKS proxy client supporting SOCKSv4, SOCKSv4a, and SOCKSv5. Includes Bind and Associate functionality.

Last release 1 months ago
02 Sep 2026
Release timing varies
gaps range from 1 weeks to 1.4 years
Some releases are documented
notes for 9 of 32 stable releases
23 versions withdrawn
withdrawn after publishing
14 years old
56 releases · first in 2013

Release timeline

56 releases since 2013

2013201520172019

Releases

2.8.102 Sept 2026
Bump ip-address from 10.1.1 to 10.3.1 by @dependabot [bot] in #120
What's Changed

Bump ip-address from 10.1.1 to 10.3.1 by @dependabot[bot] in #120

Bump js-yaml and mocha by @dependabot[bot] in #121

Upgrade dev tooling and expand CI to current Node LTS versions by @JoshGlazebrook in #127

Full Changelog: 2.8.9...2.8.10
Open source →
2.8.98 May 2026
Nothing published for this version

One column per quarter.

Nothing published for this version

2.8.712 Aug 2025

Nothing published for this version

2.8.611 Jul 2025

Nothing published for this version

2.8.510 Jun 2025

Nothing published for this version

2.8.49 Feb 2025

Nothing published for this version

2.8.310 Apr 2024

Nothing published for this version

2.8.29 Apr 2024

Nothing published for this version

2.8.123 Feb 2024

Fixes issue with lock file in 2.7.3 and 2.8.0

Open source →

2.8.012 Feb 2024withdrawn: please use 2.8.1 to fix package-lock issue

Nothing published for this version

2.7.423 Feb 2024

v280

v280 (#98)

Open source →

2.7.312 Feb 2024withdrawn: please use 2.7.4 or 2.8.1 to fix package-lock issue

Removed ip package dependency.

Removed ip package dependency.

Open source →

2.7.212 Feb 2024withdrawn: please use 2.7.4 or 2.8.1 to fix package-lock issue

Nothing published for this version

2.7.12 Oct 2022

Nothing published for this version

2.7.017 Jul 2022

Nothing published for this version

2.6.25 Feb 2022

Nothing published for this version

2.6.118 Apr 2021

Nothing published for this version

2.6.017 Mar 2021

Adds support for custom auth methods.

Open source →

2.6.0-beta.116 Mar 2021pre-release

Nothing published for this version

2.5.14 Dec 2020

Nothing published for this version

2.5.026 Oct 2020

Changed behavior of createConnection/createConnectionChain option validation to where errors are surfaced via callback (if provided), or through promi

Changed behavior of createConnection/createConnectionChain option validation to where errors are surfaced via callback (if provided), or through promise rejection.

Open source →

2.4.48 Sept 2020

Nothing published for this version

2.4.38 Sept 2020

Nothing published for this version

2.4.229 Aug 2020

Nothing published for this version

2.4.121 Jun 2020

Nothing published for this version

2.4.021 Jun 2020

Nothing published for this version

2.3.36 Nov 2019

Nothing published for this version

2.3.219 Feb 2019

Nothing published for this version

2.3.13 Feb 2019

When creating connections, 'ipaddress' can now be a hostname (proxyserver1.com for example)

When creating connections, 'ipaddress' can now be a hostname (proxyserver1.com for example)
'host' property added to proxy config, this is intended to replace 'ipaddress'. (ipaddress remains for backwards compatibility)

The following are equivalent:

Using 'ipaddress':

const options = {
  proxy: {
    ipaddress: '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
  }
};

Using 'host'

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
  }
};

Hostnames are now allowed:

const options = {
  proxy: {
    host: 'proxy1.proxyservers.com', // 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
  }
};

Open source →

2.3.01 Feb 2019

Nothing published for this version

2.2.324 Jan 2019

Nothing published for this version

2.2.26 Nov 2018

This release fixes an issue where socks would throw an error on Electron.

Open source →

2.2.127 Jun 2018

Nothing published for this version

2.2.04 Apr 2018

Internally we now reference the socket as a duplex stream. Since (Socket instanceof Duplex === true) this shouldn't break anything, but you can now pa

Changes

Internally we now reference the socket as a duplex stream. Since (Socket instanceof Duplex === true) this shouldn't break anything, but you can now pass in a Duplex as existing_socket (if you're using this for some reason).

Open source →

2.1.618 Mar 2018

This fixes an issue with the 'receivebuffer' import.

Open source →

2.1.511 Mar 2018withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Fixes incoming data flow issues. It's highly recommended to upgrade to this version if you're using 2.x.x

Open source →

2.1.49 Mar 2018withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Nothing published for this version

2.1.39 Mar 2018withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Nothing published for this version

2.1.230 Dec 2017withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Nothing published for this version

2.1.128 Dec 2017withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Nothing published for this version

2.1.028 Dec 2017withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Nothing published for this version

2.0.528 Dec 2017withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Nothing published for this version

2.0.428 Dec 2017withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Nothing published for this version

2.0.312 Dec 2017withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Nothing published for this version

2.0.212 Dec 2017withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Nothing published for this version

2.0.112 Dec 2017withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Nothing published for this version

2.0.012 Dec 2017withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Nothing published for this version

1.1.1014 Jan 2017withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

This release upgrades smart-buffer and ip.

Open source →

1.1.97 Apr 2016withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

This release updates the smart-buffer and ip packages.

Open source →

1.1.830 Jun 2015withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Fixes a bug with http agent on node v0.12.x.

Open source →

1.1.72 Mar 2015withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Nothing published for this version

1.1.626 Feb 2015withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

First release under new package name of socks.

Open source →

1.1.526 Feb 2015withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Nothing published for this version

1.0.026 Feb 2015withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Nothing published for this version

0.0.115 Feb 2013withdrawn: If using 2.x branch, please upgrade to at least 2.1.6 to avoid a serious bug with socket data flow and an import issue introduced in 2.1.0

Nothing published for this version

Your coding agent can read these notes before it upgrades. Set up the MCP server →

socks

Release timeline

Releases

What's Changed

Changes