This is a websocket to tcp proxy, written in node.js. It is adapted from the original roBrowser project, and is designed to be fully compatible with the original wsProxy. However, this version is heavily modified and does not have any of the original maintainers. It is also a goal to make this version more lightweight and efficient than the original, as javascript has come a long way in the last decade.
Caution
This repository is now archives as of April 26th, 2024. It is advised to use wisp-server-node or any other project that implements the wisp protocol. The Wisp protocol is much more mature and most implementations have backwards-compatibility for wsProxy. This repository will stay here as a reference for future implementers of the wsProxy protocol, as the code is much more readable than the original.
npm install wsproxy -g
wsproxy [-p PORT] [-t THREADS (# of threads to spawn)] [-s ENABLE_SSL] [-k KEY_FILE] [-c CERT_FILE]
-p
Port to bind wsProxy to- If no
port
is specified it will default toprocess.env.PORT
or port 5999.
- If no
-a
List of allowed servers to proxy to- By default wsProxy will proxy to any ip:port, this is a major risk, since malicous users may use your wsProxy server for illegal activity, or any other use other then connecting to your athena server.
- The list of IP:PORT's should be separate by comma! Ex:
wsproxy -a 127.0.0.1:6900,127.0.0.1:6121,127.0.0.1:5121
- Note: Use the same IP's you configured your server address at ROConfig at roBrowser.
-t
Number of cpu cores that wsProxy should use-s
Enable SSL-k
Path to ssl key file-c
Path to ssl cert file
- Use
wsproxy --help
for a list of available commands.
When connecting to this websocket you will give it an IP:PORT uri, for example:
ws://websocket.example.com:5999/127.0.0.1:6900
- You can edit allowed.js to only allow proxy to certain IP:PORT
- Note: if you pass in the
-a
or--allow
option when starting thewsproxy
this file will be ignored.
- Note: if you pass in the
- You can also use the
wsproxy
as a library, and use it in your own node.js application.
- Simply require and extend current files from the
/src
folder, once done, require them on wsProxy/index.js
. - BE CAREFUL, MODULES NEED TO BE LIGHTWEIGHT, LIMIT YOURSELF TO SIMPLE I/O OPERATIONS, DON'T BLOCK, AND CREATE LITTLE GARBAGE!
- Don't forget that node.js is single threaded, cpu intensive blocks of code will block the entire proxy!
- Don't create to much garbage, or the garbage collector will also block for extended periods of time, thus creating "lag" for the users.
This was adapted from and originally designed for the roBrowser project.
This version is heavily modified and maintained by:
- roBrowser team for the original code
- Mercury Workshop for the base64 patch
- Einaros/ws for providing the websocket middleware