socks
npmv2.8.10TypeScriptFully featured SOCKS proxy client supporting SOCKSv4, SOCKSv4a, and SOCKSv5. Includes Bind and Associate functionality.
Safe to adopt
Yes — socks scores well across adoption, maintenance, weight, supply chain, and licensing. 51.6M downloads per week and 2 known dependents. Last published 7 days ago. 7 releases in the last 2 years.
- AAdoption: grade A, Excellent.
51.6M downloads per week and 2 known dependents.
- AMaintenance: grade A, Excellent.
Last published 7 days ago. 7 releases in the last 2 years.
- AWeight: grade A, Excellent.
Pulls in 2 transitive packages, about 637 KB installed.
- BSupply chain: grade B, Good.
This package has a single maintainer (bus factor of 1).
- ALicense: grade A, Excellent.
MIT — permissive, with no copyleft found in the dependency tree.
Grades are computed deterministically from registry metadata collected by PackageGraph — downloads, dependents, publish dates, the resolved dependency tree, maintainer count, and declared licenses. No third-party scores are used.
Install cost
What you actually take on by adding socks to a project.
Runtime packages this one declares itself.
Distinct packages in the full runtime tree, deduplicated the way a package manager would.
Unpacked size of this package plus its entire runtime tree.
Longest resolved dependency chain below this package.
Licenses in the dependency tree
Every license you inherit by installing socks, not just its own. Check this before a legal review, not after.
Compatibility
- Node.js
- node >= 10.0.0, npm >= 3.0.0
- Module format
- CommonJS only
- TypeScript
- Types included
- Install scripts
- None
Quick start
A usage example from the socks README.
// TypeScript
import { SocksClient, SocksClientOptions, SocksClientChainOptions } from 'socks';
// ES6 JavaScript
import { SocksClient } from 'socks';
// Legacy JavaScript
const SocksClient = require('socks').SocksClient;socks vs the alternatives
Packages solving a similar problem in the npm ecosystem, compared on the signals that drive an adoption decision.
| Package | Weekly downloads | Dependents | License | Last release |
|---|---|---|---|---|
| socksthis page | 51.6M | 2 | MIT | 7 days ago |
| socks-proxy-agent | 0 | 3 | MIT | 1 day ago |
| proxy-agent | 0 | 1 | MIT | 1 day ago |
| pac-proxy-agent | 0 | 1 | MIT | 1 day ago |
| https-proxy-agent | 225.1M | 10 | MIT | 1 day ago |
| proxy-addr | 72.2M | 1 | MIT | 1 day ago |
Dependencies
Declared by socks v2.8.10. Runtime dependencies are installed with the package; dev dependencies are not.
Runtime (2)
Dev (9)
Used by
Popular packages that depend on socks.
Relationship graph
Dependencies (left) and dependents (right) of socks.
Frequently installed together
A collection of credential providers, without requiring service clients like STS, Cognito
Official client encryption module for the MongoDB Node.js driver
Fastest Snappy compression library in Node.js
[](https://github.com/mongodb-js/zstd/actions/workflows/test.yml)
Get the metadata from a Google Cloud Platform environment
TypeScript definitions for node
An extremely fast JavaScript and CSS bundler and minifier.
An AST-based pattern checker for JavaScript.
Prettier is an opinionated code formatter
Fast, unopinionated, minimalist web framework
TypeScript execution environment and REPL for node.js, with source map support
Signs and prepares requests using AWS Signature Version 4
Release history
7 releases in the last two years, typically about 32 days apart.
| Version | Published | Size | License |
|---|---|---|---|
| 2.8.10latest | 7 days ago | 152 KB | MIT |
| 2.8.9 | 4 months ago | 153 KB | MIT |
| 2.8.8 | 4 months ago | 153 KB | MIT |
| 2.8.7 | 1 year ago | 153 KB | MIT |
| 2.8.6 | 1 year ago | 153 KB | MIT |
| 2.8.5 | 1 year ago | 153 KB | MIT |
| 2.8.4 | 1 year ago | 153 KB | MIT |
| 2.8.3 | 2 years ago | 153 KB | MIT |
| 2.8.2 | 2 years ago | 152 KB | MIT |
| 2.8.1 | 2 years ago | 152 KB | MIT |
| 2.7.4 | 2 years ago | 152 KB | MIT |
| 2.7.3 | 2 years ago | 152 KB | MIT |
| 2.7.2 | 2 years ago | 152 KB | MIT |
| 2.8.0 | 2 years ago | 152 KB | MIT |
| 2.7.1 | 3 years ago | 148 KB | MIT |
Overview
socks is an npm package that fully featured SOCKS proxy client supporting SOCKSv4, SOCKSv4a, and SOCKSv5. Includes Bind and Associate functionality. It is extremely widely used, with about 51.6M downloads per week and 2 known dependents in the graph. The latest version is 2.8.10, released under the MIT license.
Who should use it
Teams working in the npm ecosystem who need fully featured SOCKS proxy client supporting SOCKSv4, SOCKSv4a, and SOCKSv5. Includes Bind and Associate functionality and value a battle-tested, widely-adopted solution.
When not to use it
Consider an alternative if you need to or if a more actively-maintained option better fits your npm stack.
Pros
- Large, well-established user base (51.6M weekly downloads).
- Ships TypeScript type definitions.
- Clear open-source license (MIT).
Cons
- No significant drawbacks detected from available metadata.
Auto-generated from collected registry metadata. No external claims are inferred.
Maintainers
Frequently asked questions
Should I use socks?
Yes — socks scores well across adoption, maintenance, weight, supply chain, and licensing. 51.6M downloads per week and 2 known dependents. Last published 7 days ago. 7 releases in the last 2 years.
How do I install socks?
Run `npm install socks` to add socks to your npm project.
How many dependencies does socks have?
socks declares 11 direct dependencies and pulls in 2 packages in total once its runtime tree is resolved totalling about 637 KB on disk.
What license is socks released under?
socks is distributed under the MIT license.
How popular is socks?
socks has approximately 51,585,351 downloads per week and 2 known dependent packages.
Is socks still maintained?
The most recent release of socks (v2.8.10) was published 7 days ago.
Does socks run install scripts?
No. socks does not define preinstall, install, or postinstall scripts, so installing it does not execute publisher-supplied code.