- Autobahn tests all pass.
- Linux, OS X & Windows support.
- Valgrind clean.
- Built-in load balancing and multi-core scalability.
- SSL/TLS support & integrates with foreign HTTPS servers.
- Permessage-deflate built-in.
- Node.js binding exposed as the well-known
ws
interface. - 10-300x faster than
ws
(if they are "fastest", we are "fastester"). - Default engine in SocketCluster & deepstream.io, optional in Socket.IO & Primus.
Benchmarks table - validate
Implementation | User space memory scaling | Connection performance | Short message throughput | Huge message throughput |
---|---|---|---|---|
libwebsockets 2.0 | µWS is 11x as lightweight | µWS is equal in performance | µWS is 6x as performant | µWS is 4x in performance |
ws v1.1.0 + binary addons | µWS is 47x as lightweight | µWS is 18x as performant | µWS is 33x as performant | µWS is 2x as performant |
WebSocket++ v0.7.0 | µWS is 63x as lightweight | µWS is 4x as performant | µWS is 3x as performant | µWS is 2x as performant |
Kaazing Gateway Community 5.0.0 | µWS is 62x as lightweight | µWS is 15x as performant | µWS is 18x as performant | unable to measure |
Benchmarks are run with default settings in all libraries, except for ws
which is run with the native performance addons. These results were achieved with the native C++ server, not the Node.js addon. Expect worse performance and scalability when using Node.js (don't worry, the Node.js addon will run circles around ws
).
deepstream.io | SocketCluster | wilds.io | Crisp.im |
We built µWS
with the existing Node.js infrastructure in mind. That's why we target the widespread ws
interface, allowing us to seamlessly integrate with projects like SocketCluster, deepstream.io, Socket.IO & Primus.
- Read the ws documentation
- Read the Primus transformer documentation
µWS
is the default engine in SocketCluster as of 5.0.0.
µWS
is the default engine in deepstream.io as of 1.0.0.
Use the new wsEngine: 'uws'
option like so:
var io = require('socket.io')(80, { wsEngine: 'uws' });
This option has not yet been released, one alternative way of enabling uws
in current versions of Socket.IO is:
var io = require('socket.io')(80);
io.engine.ws = new (require('uws').Server)({
noServer: true,
perMessageDeflate: false
});
Set 'uws' as transformer:
var primus = new Primus(server, { transformer: 'uws' });
If your code directly relies on ws
you can simply swap require('ws')
with require('uws')
:
var WebSocketServer = require('uws').Server;
var wss = new WebSocketServer({ port: 8080 });
wss.on('connection', function (ws) {
ws.on('message', function (message) {
console.log('received: ' + message);
});
ws.send('something');
});
For maximum performance and memory scaling the native interface is recommended. Look in the examples folder for threading and load balancing examples. There is no documentation written yet but a bright person like you will have no problem just reading the header file.
int main()
{
/* this is an echo server that properly passes every supported Autobahn test */
uWS::Server server(3000);
server.onConnection([](uWS::WebSocket socket) {
cout << "[Connection] clients: " << ++connections << endl;
});
server.onMessage([](uWS::WebSocket socket, char *message, size_t length, uWS::OpCode opCode) {
socket.send(message, length, opCode);
});
server.onDisconnection([](uWS::WebSocket socket) {
cout << "[Disconnection] clients: " << --connections << endl;
});
server.run();
}
- Valgrind clean.
- Autobahn tests all pass.
- All Primus transformer integration tests pass.
- All Engine.IO server tests pass.
- Small & efficient code base.
- Node.js 4.x, 5.x & 6.x supported
- Linux, Mac OS X & Windows supported
Windows version requires Node.js 6.4.0+
First of all you need to install the required dependencies. On Unix systems this is typically done via package managers, like homebrew in the case of OS X or dnf
in the case of Fedora Linux. On Windows you need to search the web for pre-compiled binaries or simply compile the dependencies yourself.
- libuv 1.x
- OpenSSL 1.0.x
- zlib 1.x
- CMake 3.x
Obviously you will need to clone this repo to get the sources. We use CMake as build system.
git clone https://github.com/alexhultman/uWebSockets.git && cd uWebSockets
cmake .
Now, on Unix systems it should work by simply running make
. Run [sudo] make install
as you wish.
If you are running Windows you should now have a bunch of Visual Studio project files and one solution file. Open the solution file, now you need to make sure the header include paths and library paths are all set according to where you installed the dependencies. You might also need to change the names of the libraries being linked against, all according to the names of the installed library files. You know the drill.