Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Berrysoft/tunet-rust
清华大学校园网 Rust 库与客户端
https://github.com/Berrysoft/tunet-rust
android campus-network dart flutter ios linux macos rust rust-lang slint tsinghua-university windows
Last synced: about 1 month ago
JSON representation
清华大学校园网 Rust 库与客户端
- Host: GitHub
- URL: https://github.com/Berrysoft/tunet-rust
- Owner: Berrysoft
- License: mit
- Created: 2019-05-21T16:41:27.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-10-30T15:54:46.000Z (about 1 month ago)
- Last Synced: 2024-10-30T16:38:37.590Z (about 1 month ago)
- Topics: android, campus-network, dart, flutter, ios, linux, macos, rust, rust-lang, slint, tsinghua-university, windows
- Language: Rust
- Homepage:
- Size: 3.82 MB
- Stars: 120
- Watchers: 3
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - Berrysoft/tunet-rust - 清华大学校园网 Rust 库与客户端 (Rust)
- awesome-rust-list - Berrysoft/tunet-rust - rust?style=social"/> : 清华大学校园网 Rust 库与客户端。 (GUI)
- awesome-rust-list - Berrysoft/tunet-rust - rust?style=social"/> : 清华大学校园网 Rust 库与客户端。 (GUI)
README
# tunet-rust
清华大学校园网 Rust 库与客户端。
[](https://strawberry-vs.visualstudio.com/tunet-rust/_build)
## GUI（桌面端）
基于 [Slint](https://slint-ui.com/) 开发。使用如下命令启动：
``` bash
$ tunet-gui
```
| 平台 | 亮 | 暗 |
| ------- | ------------------------------------ | ----------------------------------- |
| Windows |  |  |
| Linux |  | （暂无图片） |
| macOS |  |  |
## GUI（移动端）
基于 [Flutter](https://flutter.dev/) 开发。会尽量保证 iOS 版本能用，但是没钱发布。
| 平台 | 亮 | 暗 |
| ------- | ------------------------------------ | ----------------------------------- |
| Android |  |  |
## CUI（命令行图形界面）
使用如下命令启动：
``` bash
# 使用默认（自动判断）方式登录/注销
$ tunet-cui
# 使用 auth4 方式登录/注销
$ tunet-cui -s auth4
```
## 命令行
### 登录/注销
``` bash
# 使用默认（自动判断）方式登录
$ tunet login
# 使用默认（自动判断）方式注销
$ tunet logout
# 使用 auth4 方式登录
$ tunet login -s auth4
# 使用 auth4 方式注销
$ tunet logout -s auth4
```
### 在线状态
``` bash
# 使用默认（自动判断）方式
$ tunet status
# 使用 auth4 方式
$ tunet status -s auth4
```
### 查询/强制下线在线 IP
``` bash
# 查询
$ tunet online
# IP 上线
$ tunet connect -a IP地址
# IP 下线
$ tunet drop -a IP地址
```
### 流量明细
``` bash
# 使用默认排序（注销时间，升序）查询明细
$ tunet detail
# 使用登录时间（升序）查询明细
$ tunet detail -o login
# 使用流量降序查询明细
$ tunet detail -o flux -d
# 使用流量降序查询明细，并按注销日期组合
$ tunet detail -o flux -dg
```
### Nushell 集成
`status`、`online`、`detail` 子命令支持 `--nuon` 参数，可以配合 Nushell 得到结构化的数据：
``` bash
# 在线状态表格
> tunet status --nuon | from nuon
# 查询在线 IP 表格
> tunet online --nuon | from nuon
# 明细表格
> tunet detail --nuon | from nuon
# 使用流量降序查询明细，并按注销日期组合
> tunet detail -g --nuon | from nuon | sort-by flux -r
```
### Windows 服务/macOS launchd
``` bash
# 注册服务
$ tunet-service register
# 注册服务，并定时5分钟连接一次
$ tunet-service register -i "5min"
# 注销服务
$ tunet-service unregister
```
注意 `tunet-service.exe` 自身是服务程序，如需删除应先注销服务。
### Systemd
由于不同 Linux 发行版的服务机制不同，没有提供 `register` 和 `unregister` 命令。
Debian 打包提供了 `[email protected]` 文件。对于用户 `foo`，可以运行
``` bash
# 启用服务
$ sudo systemctl enable tunet@foo
# 启动服务
$ sudo systemctl start tunet@foo
```
可以通过编辑该文件来调整重复登录的间隔。
## 密码
用户名和密码在第一次登录时根据提示输入。请不要在不信任的电脑上保存密码。可以在桌面端图形界面点击“删除并退出”，或在命令行使用如下命令删除：
``` bash
$ tunet deletecred
```
注意：由于 Linux 的限制，目前没有找到合适的持续化密码保存方法，因此会直接明文存储。
## 网络状态
针对不同平台使用平台特定的方式尝试获得当前的网络连接方式，如果是无线网连接还会获取 SSID。
如果无法获取，则尝试连接特定的网址来判断。
平台
网络状态
WIFI SSID
MAC 地址
Windows
Windows::Networking::Connectivity
GetAdaptersAddresses
Linux
（无）
Netlink
getifaddrs
Android
ConnectivityManager
WifiManager
macOS X
System Configuration
Core WLAN
iOS
NEHotspotNetwork
## 编译说明
使用 `cargo` 直接编译：
``` bash
$ cargo build --release --workspace --exclude native
```
即可在 `target/release` 下找到编译好的程序。
若要为 Android 编译 APK：
``` bash
$ cd tunet-flutter
$ make apk
```
即可在 `tunet-flutter/build/app/outputs/flutter-apk/app-<架构>-release.apk` 找到打包。
## 安装说明
从 Releases 即可找到最新版分发。
### Arch Linux
有第三方打包的 AUR 和 [archlinuxcn](https://www.archlinuxcn.org/) 源可以安装。