25 个版本
0.2.22 | 2024 年 8 月 2 日 |
---|---|
0.2.21 | 2024 年 7 月 29 日 |
0.2.16 | 2024 年 5 月 31 日 |
0.2.1 | 2024 年 3 月 31 日 |
0.1.1 | 2023 年 4 月 28 日 |
#31 在 WebSocket
710 每月下载量
43KB
939 行
WebSocket 反射器 X
受控 TCP-over-WebSocket 转发隧道。
Crate 主页 | Crate 文档 | 本地守护进程 API 文档
备注
WebSocket 反射器 X 0.2.0 完全重写了 GUI,使用 Qt/C++,守护进程和 crate 仍然使用纯 Rust。
守护进程(命令行)可以独立使用。
新的桌面应用程序使用 HTTP API 与守护进程通信,并从守护进程的 stdout 流式传输日志。守护进程作为桌面应用程序的子进程运行。
使用方法
从 发行版页面 下载并运行。
命令行工具
此版本包含桌面 GUI 应用程序和命令行守护进程,因此对于某些用户来说可能太大。
您可以直接从 Cargo 安装命令行工具
cargo install wsrx --features=binary
然后您可以直接使用 wsrx
而不需要桌面应用程序。
Linux 用户
AppImage 打包工具对 wayland 的支持不完整,在某些 wayland 平台上您将看到桌面应用程序输出一些错误并在 XWayland 中启动 GUI,这是一个上游问题,与 WSRX 本身无关,因此请不要在此处发布问题。
对于 Arch Linux 用户,更好的选择可能是
yay -S wsrx-git
# or you use paru
paru -S wsrx-git
然后您可以使用具有原生 wayland 支持的 WSRX 桌面应用程序。
欢迎提交有关其他 Linux 发行版的 GitHub CI 的 PR!
开发
编译
cmake -B build -DCMAKE_BUILD_TYPE=Release -G Ninja
cmake --build build --config Release --target all
CMake 将自动调用 cargo 来构建守护进程。
您可以在 build/bin
目录中找到两个二进制文件,wsrx
和 wsrx-desktop
。 wsrx
是命令行守护进程,wsrx-desktop
是桌面应用程序。
如果您不想构建桌面应用程序而只想使用命令行守护进程,只需运行
cargo build --release
然后在 target/release/wsrx
中找到二进制文件。
运行
只需运行二进制文件。 wsrx-desktop
将自动将 wsrx
守护进程作为子进程启动,然后您可以使用桌面应用程序来控制守护进程。
如果您想独立运行命令行界面(CLI)
./wsrx --help
以下将指导您如何使用CLI守护进程。
在大多数情况下,您只需运行 wsrx connect wss://example.com:443
来启动隧道代理。
wsrx服务器也集成在CLI守护进程中,您可以通过运行 wsrx serve
并在 https://127.0.0.1:<port>/pool
访问管理API。
进一步阅读
如果您想了解更多关于守护进程API的信息,可以阅读API文档。
如果您想在您自己的服务器项目中集成wsrx
,可以阅读crate文档。
此外,wsrx
是一个简单的工具,它使用纯WebSocket协议来隧道TCP连接,因此您可以使用您喜欢的其他语言实现自己的服务器/客户端。您可以通过阅读协议文档了解更多信息。
桌面预览
依赖项
~11-23MB
~411K SLoC