Skip to content

Neboer/ipgw-py-manager

Repository files navigation

NEU ipgw manager

当前版本:3.0

东北大学ipgw网关管理程序重制版,仅支持统一身份认证用户名-密码登录

  • 格式化输出,输出内容为100%的中文,表格内容清晰易读,是对网页信息的高度简化。
  • 兼容强,可以识别ipgw的所有状态和页面,比如停止服务、其他设备在线、费用不足等情况,并可以像网页端一样作出操作。
  • 适配广泛,对于无线网络、有线网络、安卓/IOS/Windows设备都有很好的支持,你完全可以把它作为树莓派联网的工具
  • 支持多用户管理,带有配置文件,可以用简单的命令执行复杂的操作。当然也可以覆盖默认的行为。配置文件人类可读,修改起来很方便。
  • 模拟真实浏览器操作,不做作,不装饰,不做不必要的请求,不漏必要的请求,节省收发数据量,节约上网时间。随时随地,只要有信号,就有校园网。
  • 不仅仅是一个网络登录程序,内置core模块可以非常容易的重用,代替实现各种校内网页认证等功能,非常方便。

使用此脚本管理自己的ipgw连接,可以加快操作ipgw网关的速度,节省时间,无论是联网还是断网都十分方便。

本项目承诺长期更新,尽量做到功能稳定。目前已经有一个cli版本供使用,TUI和GUI版本正在开发中。

11.2日校园网更新 2021.11.2,东北大学校园网迎来了一次更新。此次更新修改了后端的api接口以及原有的登录策略和校验逻辑。 2021.11.3,NEU-ipgw-manager更新到了3.0版本,适配了这个新的api。

安装

自动安装

本项目支持自动安装,只需要执行

pip install NEU-ipgw-manager

项目基于Python 3.9开发,在3.8上通过了测试,除此之外不保证能够在其他版本Python环境中运行。

手动安装

由于有安装脚本的存在,整个安装过程非常简单。

首先克隆本仓库的源代码

git clone https://github.com/Neboer/ipgw-py-manager.git

然后执行python setup.py install

这样,就可以直接在命令行中执行ipgw --help来确认安装了。

快速上手

配置文件在安装之后自动存放在用户的home目录,可以在--help输出的信息中查看。详细的命令行用法参见下面的信息。

对于首次安装的用户,你需要添加一个用户并设置其为默认用户,操作方法如下:

ipgw add -u 20180001

输入密码,成功添加用户。

ipgw default -u 20180001

成功设置用户为默认用户。

之后,登录网关:

ipgw i

如果用户名和密码没有问题,此时应该显示登录成功,并报告登录的结果。

登出:

ipgw o

快速登出当前登录的帐号。

命令行参数说明

ipgw action [options...]

看如下几个实例(示例学号为20200001):

状态

ipgw status
ipgw s

获取当前ipgw网络连接状态。

登录

ipgw login
ipgw i

使用已保存的默认用户名密码登录并联网。在任何时候login都可以替换成i。


ipgw login -u 20200001
ipgw login --username 20200001

登录20200001,程序会在已保存的账号中寻找20200001的密码,如果找不到则会要求用户输入密码。


ipgw login -u 20200001 --password thepassword
ipgw login -u 20200001 -p thepassword

使用指定密码登录账号,不推荐此类方法,建议不要在命令行中直接输入密码。

登录之后,程序会显示账号信息列表和已登录设备列表。

登出

ipgw logout
ipgw o

登出本机。


ipgw logout --all
ipgw o --all

下线所有设备。

账号管理

ipgw add 20200001 -p thepassword

与login行为基本相同,-p应该省略,由用户手动输入。

ipgw default -u 20200001

在添加用户之后,使用default命令将此用户设为默认登录用户。

程序不提供删除账号、修改密码等对已保存账号进行操作的功能,有类似需求的时候请直接编辑配置文件。

Releases

No releases published

Packages

No packages published

Languages