drcom4scut

当前版本 0.3.0

• A 3rd-party DrCOM client for SCUT, written in Rust.
• 华南理工大学第三方客户端，使用Rust语言编写。

---

用法

仅供不熟悉操作的同学参考，熟悉的话直接看命令行参数和配置项应该就知道怎么用了

1. 下载 Release 并解压。
2. 如在Windows系统，安装npcap
3. 运行 drcom4scut，第一次会产生配置文件。
4. 填写配置文件，通常只需要填写 username 和 password 两项（注意yml文件格式）。
5. 再次运行 drcom4scut，通常是可以正常运行的。
   • 如果不能，请查看控制台输出的提示。
     • 如果没有自动选择正确的网卡，请在配置文件中填写 mac 或 ip 任意一项。其中 mac 是以冒号分隔的形式， ip 是你指定网卡对应设置的IP地址。
     • 如果出现不能读取配置文件，请检查填写的配置文件是否满足yml规范。

---

命令行参数

Usage: drcom4scut.exe [OPTIONS]

Options:
  -c, --config <config>      Path to config file. [default: config.yml]
  -D, --debug                Enable debug mode.
  -m, --mac <mac>            Ethernet Device MAC address.
  -i, --ip <ip>              IP address of the selected Ethernet Device.
  -u, --username <username>  Username to authorize.
  -p, --password <password>  Password to authorize.
  -H, --host <host>          Host to connect UDP server. Default value is 's.scut.edu.cn'.
  -N, --hostname <hostname>  Default value is current computer host name.
  -t, --time <time>          Time to reconnect automatically after you are not allowed to access Internet. Default value is 7:00.
  -h, --help                 Print help
  -V, --version              Print version

---

配置项

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:

---

构建和编译

一般构建

cargo build --release

• 如果你想去掉更好的日志功能而使用最简单的控制台日志，可以禁用 log4rs 特性

  cargo build --release --no-default-features

• 需要使用 Nightly 版本的 Rust 进行编译。

• 由于使用了 libpnet ，在Windows下需要安装 WinPcap 或 pcap 才能进行编译，详见libpnet。

• 目前在 Windows/Ubuntu(感谢hyh) 下编译通过，其余环境暂未测试。

OpenWRT

• 由于并没有了解这方面，待补充。

---

许可证

---

鸣谢

• hyh
• cq
• 所有参与使用的同学