基于终端的代理客户端,提供直观的 TUI 界面管理代理连接。
- 终端图形界面 (TUI)
- 支持多种协议 (VMess, VLESS, Shadowsocks, Trojan)
- 订阅管理和自动更新
- 服务器延迟测试
- 实时流量统计
- GeoIP 智能分流
- 跨平台支持 (macOS, Linux, Windows)
从 Releases 下载对应平台的安装包:
| 平台 | 文件 |
|---|---|
| macOS (Apple Silicon) | superray-tui-1.0.1-darwin-arm64.tar.gz |
| macOS (Intel) | superray-tui-1.0.1-darwin-amd64.tar.gz |
| macOS (通用) | superray-tui-1.0.1-darwin-universal.tar.gz |
| Linux (x64) | superray-tui-1.0.1-linux-amd64.tar.gz |
| Linux (ARM64) | superray-tui-1.0.1-linux-arm64.tar.gz |
| Windows (x64) | superray-tui-1.0.1-windows-amd64.zip |
# macOS/Linux tar -xzf superray-tui-1.0.1-darwin-arm64.tar.gz cd superray-tui # Windows # 解压 zip 文件即可
cp .env.example .env
# 编辑 .env 设置订阅地址.env 配置项:
SUPERRAY_SUB_URL=https://your-subscription-url # 订阅地址 SUPERRAY_LOCAL_PORT=10808 # SOCKS5 端口 SUPERRAY_GEO_PATH=./geoip # GeoIP 数据目录 DIRECT_COUNTRIES=cn # 直连国家
# 普通模式 ./superray-tui # TUN 模式 (全局代理,需要管理员权限) sudo ./superray-tui
| 按键 | 功能 |
|---|---|
↑/↓ 或 k/j |
选择服务器 |
Enter / c |
连接 |
d |
断开连接 |
t |
测试延迟 |
r |
刷新订阅 |
s |
设置订阅 |
u |
切换 TUN 模式 |
q |
退出 |
连接成功后,配置系统使用代理:
- SOCKS5:
127.0.0.1:10808 - HTTP:
127.0.0.1:10809
- Go 1.21+
- CGO 支持
- Zig (交叉编译)
# 当前平台 make build # macOS 全架构 make darwin-all # 全平台 make package-all # 查看所有命令 make help
SuperRay-TUI/
├── main.go # 主程序
├── pkg/superray/ # CGO 绑定
├── third_party/superray/ # SuperRay 库
│ ├── include/ # 头文件
│ ├── lib/ # 动态库
│ └── geoip/ # GeoIP 数据
├── build/ # 编译输出
├── dist/ # 打包输出
└── docs/ # 文档
├── BUILD.md # 编译指南
├── INSTALL.md # 安装指南
└── USAGE.md # 使用说明
- Telegram 频道: @OpineWorkPublish
- Telegram 群组: @OpineWorkOfficial
MIT License