wsrx
| Crates.io | wsrx |
| lib.rs | wsrx |
| version | |
| source | src |
| created_at | 2023-04-22 00:07:56.84177 |
| updated_at | 2024-12-04 07:38:22.20301 |
| description | Controlled TCP-over-WebSocket forwarding tunnel. |
| homepage | https://github.com/XDSEC/WebSocketReflectorX |
| repository | https://github.com/XDSEC/WebSocketReflectorX |
| max_upload_size | |
| id | 845748 |
| Cargo.toml error: | TOML parse error at line 19, column 1 | 19 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include` |
| size | 0 |
Reverier Xu (Reverier-Xu)
documentation
README
WebSocket Reflector X
Controlled TCP-over-WebSocket forwarding tunnel.
Crate Homepage | Crate Docs | Local daemon API Docs
Notes
WebSocket Reflector X 0.2+ has completely rewritten the GUI in Qt/C++, it's daemon and the crate are still written in pure safe Rust.
The daemon (cli) could be used standalone.
New desktop app using HTTP API to communicate with the daemon, and stream logs from daemon's stdout. The daemon is running as a child process of the desktop app.
Usage
Download from Releases page and run it.
Command Line Tools
This release contains the desktop GUI application and the cli daemon, so it's size may too big for some users.
you can just install the command-line tool from Cargo:
cargo install wsrx --features=binary
then you can use wsrx directly without desktop application.
Linux users
AppImage packaging tool has an incomplete support for wayland, in some wayland platforms you will see the desktop application outputs some errors and start the GUI in XWayland, this is an upstream issue, not related to WSRX itself, so do not post issues here.
For Arch Linux users, the better choice maybe:
yay -S wsrx-git
# or you use paru
paru -S wsrx-git
then you can use WSRX desktop application with native wayland support.
PRs about GitHub CI for other linux distro are welcome!
Development
Compile
cmake -B build -DCMAKE_BUILD_TYPE=Release -G Ninja
cmake --build build --config Release --target all
CMake will automatically call cargo to build the daemon.
You can find two binaries inside the build/bin directory, wsrx and wsrx-desktop. wsrx is the cli daemon, and wsrx-desktop is the desktop app.
If you don't want to build the desktop app and only want to use the cli daemon, you can just run:
cargo build --release
and find the binary in target/release/wsrx too.
Run
Just run the binary. wsrx-desktop will automatically start wsrx daemon as a child process, then you can use the desktop app to control the daemon.
If you want to run the cli standalone:
./wsrx --help
will show you how to use the cli daemon.
In most cases, you just need run wsrx connect wss://example.com:443 to start a tunnel proxy.
The wsrx server is also implemented in the cli daemon, you can run wsrx serve and access the manage API at http://localhost:<port>/pool.
Further Reading
If you want to know more about the daemon's API, you can read the API Docs.
If you want to intergrate wsrx in your own server project, you can read the crate docs.
Also, wsrx is a simple tool that using plain WebSocket protocol to tunnel TCP connections, so you can implement your own server / client in other languages you like. You can read the Protocol Docs for more information.
Desktop Preview
