# ecnu-net

**Repository Path**: hexy-gmy/ecnu-net

## Basic Information

- **Project Name**: ecnu-net
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-29
- **Last Updated**: 2026-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ecnu-net

本工具是由华东师范大学 SOLE 实验室的 **廖佬** 的 [ecnu-cli](https://github.com/DarkHighness/ecnu-cli) 在 GLM-5.2 协助下进行的升级。

ECNU 校园网认证命令行工具。

## 快速用法
```bash
# 校园网首次登录（密码交互输入，加密保存）
ecnu-net -u 用户名(学号) -s

# 校园网免密登录（读取已保存的凭据）
ecnu-net

# 校园网后台守护（每 10 分钟自动重连）
ecnu-net -d

# VPN 登录并建立隧道（前台运行，Ctrl+C 退出）
sudo ecnu-net vpn -u 用户名(学号)

# VPN 登录并保存凭据（后台运行，登录后命令行立即返回）
sudo ecnu-net vpn -u 用户名(学号) -s
```
## 安装

### 下载预编译二进制

从 [Releases](https://gitee.com/hexy-gmy/ecnu-net/releases) ~~或 [GitHub Releases]~~ 下载对应平台的预编译二进制或压缩包。

### 源码安装
```bash
# 在源码目录
go install gitee.com/hexy-gmy/ecnu-net@latest
```

## 用法

```
ecnu-net [选项]                        # 校园网认证（默认）
ecnu-net vpn [选项]                   # AnyConnect VPN 认证
```

### 校园网认证选项

| 选项 | 简写 | 说明 |
|------|------|------|
| `-u` | `--username` | 用户名（学号） |
| `-p` | `--password` | 密码（不提供则交互式输入，推荐） |
| `-d` | `--daemon` | 后台守护模式。不传值默认每 600 秒检查；`-d 300` 可自定义间隔 |
| `--logout` | — | 登出校园网 |
| `--info` | — | 查看当前网络状态和账户信息 |
| `-e` | `--endpoint` | 认证服务器地址（默认 `https://login.ecnu.edu.cn`） |
| `-a` | `--acid` | ac_id（留空自动探测） |
| `-s` | `--save` | 将命令行参数保存到配置文件 |
| `-V` | `--verbose` | 显示详细信息 |
| `-c` | `--config` | 配置文件路径（默认 `~/.ecnu-net.yaml`） |

### 示例

#### 校园网认证

```bash
# 登录: 交互式输入密码（不回显），不保存配置文件
ecnu-net -u 学号

# 登录并保存: 密码以 AES-256-GCM 密文存入 ~/.ecnu-net.yaml
ecnu-net -u 学号 -s

# 免密登录: 从配置文件自动读取加密密码并解密
ecnu-net

# 后台守护: 登录后转入后台，每 600 秒检查一次状态，掉线自动重连
ecnu-net -u 学号 -d

# 自定义检查间隔: 每 300 秒检查一次
ecnu-net -u 学号 -d 300

# 查看当前登录信息和流量使用情况
ecnu-net --info

# 登出校园网（若后台守护在运行，自动 kill 守护进程）
ecnu-net --logout
```

#### VPN 认证

```bash
# VPN 登录: 前台建立 TUN 隧道，Ctrl+C 退出后自动恢复 DNS
# 需 root 权限（创建虚拟网卡和配置路由）
sudo ecnu-net vpn -u 学号

# VPN 登录并保存凭据: 密码加密写入配置文件，TUN 在后台运行
# 登录成功后命令行立即返回，守护进程日志写入 /tmp/ecnu-net-vpn.log
sudo ecnu-net vpn -u 学号 -s

# VPN 免密登录: 配置文件存在时无需输入密码（包括校园网保存的密码）
sudo ecnu-net vpn

# 停止 VPN: 先登出服务器端 session，再关闭 TUN 隧道和恢复 DNS
ecnu-net vpn --logout

# 指定 VPN 服务器（默认 vpn-ct.ecnu.edu.cn）和隧道组（默认 ECNU）
sudo ecnu-net vpn -S vpn-ct.ecnu.edu.cn -g ECNU
```