https://github.com/sealoong/drcom4scut
A 3rd-party DrCOM client for SCUT, written in Rust.
https://github.com/sealoong/drcom4scut
drcom libpnet rust
Last synced: 10 months ago
JSON representation
A 3rd-party DrCOM client for SCUT, written in Rust.
- Host: GitHub
- URL: https://github.com/sealoong/drcom4scut
- Owner: SeaLoong
- License: lgpl-3.0
- Created: 2020-09-21T08:00:49.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-07-19T18:42:04.000Z (11 months ago)
- Last Synced: 2025-07-19T21:48:57.192Z (11 months ago)
- Topics: drcom, libpnet, rust
- Language: Rust
- Homepage:
- Size: 260 KB
- Stars: 29
- Watchers: 2
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# drcom4scut
> 当前版本 0.3.0
+ A 3rd-party DrCOM client for SCUT, written in Rust.
+ 华南理工大学第三方客户端，使用Rust语言编写。
---
## 用法
> 仅供不熟悉操作的同学参考，熟悉的话直接看命令行参数和配置项应该就知道怎么用了
1. 下载 Release 并解压。
2. 如在Windows系统，安装[npcap](https://npcap.com/#download)
3. 运行 drcom4scut，第一次会产生配置文件。
4. 填写配置文件，通常只需要填写 `username` 和 `password` 两项（注意yml文件格式）。
5. 再次运行 drcom4scut，通常是可以正常运行的。
+ 如果不能，请查看控制台输出的提示。
+ 如果没有自动选择正确的网卡，请在配置文件中填写 `mac` 或 `ip` 任意一项。其中 `mac` 是以冒号分隔的形式， `ip` 是你指定网卡对应设置的IP地址。
+ 如果出现不能读取配置文件，请检查填写的配置文件是否满足yml规范。
---
## 命令行参数
```bash
Usage: drcom4scut.exe [OPTIONS]
Options:
-c, --config Path to config file. [default: config.yml]
-D, --debug Enable debug mode.
-m, --mac Ethernet Device MAC address.
-i, --ip IP address of the selected Ethernet Device.
-u, --username Username to authorize.
-p, --password Password to authorize.
-H, --host Host to connect UDP server. Default value is 's.scut.edu.cn'.
-N, --hostname Default value is current computer host name.
-t, --time
---
## 配置项
```yml
mac: # (可选)网卡MAC地址，以冒号':'分隔
ip: # (可选)网卡对应设置的IP地址
username: '' # 账号（学号）
password: '' # 密码
dns: # 学校DNS服务器IP地址，默认已填入五山校区和大学城校区的DNS
- 202.38.193.33
- 222.201.130.30
- 202.112.17.33
- 222.201.130.33
host: s.scut.edu.cn # (可选) 用于UDP连接的地址，通常不需要改动
hostname: # (可选) 主机名，留空会使用当前电脑的主机名
time: 7:00 # (可选) 在收到“本时段禁止上网”后的重连时间，默认为7点整
reconnect: 15 # (可选) 出现意外情况时的重连间隔，默认为15秒
heartbeat:
eap_timeout: 60 # (可选) EAP连接心跳间隔，默认为60秒
udp_timeout: 12 # (可选) UDP连接心跳间隔，默认为12秒
retry:
count: 2 # (可选) 错误重试次数
interval: 5000 # (可选) 数据包重发间隔、错误重试间隔，默认为5000毫秒
log:
enable_console: false # (可选) 是否输出日志到控制台
enable_file: false # (可选) 是否输出日志到文件
file_directory: ./logs # (可选) 日志文件目录
level: INFO # (可选) 日志等级
data: # (可选) 以下参数通常不需要填写，填写错误可能会导致不可预计的问题
response_identity:
unknown:
response_md5_challenge:
unknown:
misc_info:
unknown1:
cks32_param:
unknown2:
os_major:
os_minor:
os_build:
os_unknown:
version:
hash:
```
---
## 构建和编译
### 一般构建
```bash
cargo build --release
```
+ 如果你想去掉更好的日志功能而使用最简单的控制台日志，可以禁用 `log4rs` 特性
```bash
cargo build --release --no-default-features
```
+ 需要使用 *Nightly* 版本的 Rust 进行编译。
+ 由于使用了 [**libpnet**](https://crates.io/crates/pnet) ，在Windows下需要安装 *WinPcap* 或 *pcap* 才能进行编译，详见[**libpnet**](https://crates.io/crates/pnet)。
+ 目前在 Windows/Ubuntu(感谢hyh) 下编译通过，其余环境暂未测试。
### 自动构建
+ 已经为Ubuntu和Windows自动构建了最新版本的drcom4scut，如有需要请从GitHub Action下载。如果文件过期可以自己fork后构建。
### OpenWRT
+ 由于并没有了解这方面，待补充。
---
## 许可证
[](https://github.com/SeaLoong/drcom4scut/blob/master/LICENSE)
---
## 鸣谢
+ hyh
+ cq
+ 所有参与使用的同学