mirror of
https://github.com/moparisthebest/WebSocketSocket
synced 2024-12-21 06:58:52 -05:00
client | ||
server | ||
.gitignore | ||
license.txt | ||
pom.xml | ||
readme.md |
WebSocketSocket
WebSocketSocket implements a custom java.net.Socket over top of a WebSocket, and also a server component that accepts a WebSocket connection and connects to a host/port. This allows you to tunnel arbitrary TCP over a WebSocket, even TLS can be used over it. Which potentially allows you to securely establish a trusted TLS connection even on a network that intercepts TLS on port 443.
Sample Usage
Configure and run SocketWebSocketServer on a remote server.
Socket sock = new WebSocketSocket("ws://remote-server:remote-port/websocket/ssh");
// use sock just like any other standard Socket
You can also run SocketProxy on the client which listens on a local TCP port, and connect to that with anything.
Licensing
This project is licensed under the GNU/LGPLv2.1, which allows use in Open Source or Proprietary programs. If you need to modify this code though, you should contribute back to it.
Contributing
- Fork it. (Alternatively, if you really can't use github/git, email me a patch.)
- Create a branch (
git checkout -b my_WebSocketSocket
) - Commit your changes (
git commit -am "Implemented method X"
) - Push to the branch (
git push origin my_WebSocketSocket
) - Open a Pull Request
- Enjoy a refreshing beverage and wait