A framework for building composable proxy protocol stack.

• Cross-platform: running on Linux, Windows and macOS.
• Lightweight proxy interface for Socks5/Socks4/Socks4a and HTTP(S).
• Transmit data over TCP/UDP, TLS or WebSocket.
• Multiplexing over TCP/TLS/WS.
• A variety of customizable protocols and functional middlewares: using presets.
• External preset import.
• Easy and powerful Access Control(ACL) and Traffic Control(TC).
• Support shadowsocks, shadowsocksR, v2ray vmess protocols.
• Out of the box distribution and deployment.
• Experimental: dynamic protocol stack.
• Portable versions are available: download here.

blinksocks is built on top of Node.js, if you want to use it in an ordinary way or do some hacking, please install Node.js(v6.x and above) on your operating system.

You can get the latest blinksocks via package manager yarn or npm.

NOTE: Node.js comes with npm installed so you don't have to install npm individually.

latest stable version

$ npm install -g blinksocks

nightly releases

Please check out blinksocks-nightly-releases.

npm version(require Node.js)

$ blinksocks --help

executable version(Node.js, not GUI)

$ ./blinksocks --help    // Linux and macOS
$ blinksocks.exe --help  // Windows

You can download precompiled executables for different platforms and launch it directly without having Node.js installed.

For configuring blinksocks, please refer to Configuration.

For desktop use, you can download official blinksocks-desktop, a cross-platform GUI for blinksocks.

1. Usage
2. Configuration
3. Presets

1. Preparation
2. Guideline
3. Custom Preset
4. Benchmark

See contributors.

Apache License 2.0