NEU-ipgw-manager 3.1.3

ipgw manager for NEU network gateway

NEU ipgw manager

当前版本：3.1.1

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

• 漂亮的、格式化的表格输出，内容清晰易读，和网页端提供相同的信息。
• 兼容强，可以识别ipgw的所有状态和页面，比如停止服务、其他设备在线、费用不足等情况，并可以像网页端一样作出操作。
• 适配广泛，对于无线网络、有线网络、安卓/IOS/Windows设备都有很好的支持，你完全可以把它作为无界面服务器联网的工具，同时比浏览器使用方便很多。
• 支持多用户管理，带有配置文件，可以用简单的命令执行复杂的操作。当然也可以覆盖默认的行为。配置文件人类可读，修改起来很方便。
• 模拟真实浏览器操作，稳定运行多年，无任何使用风险。
• 不仅仅是一个网络登录程序，内置core模块可以非常容易的重用，代替实现各种校内网页认证等功能，非常方便。

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

本项目承诺长期更新，长期可用，功能稳定。

11.2日校园网更新 2021.11.2，东北大学校园网迎来了一次更新。此次更新修改了后端的api接口以及原有的登录策略和校验逻辑。 2021.11.3，NEU-ipgw-manager更新到了3.0版本，适配了这个新的api。 2024.09.13, NEU-ipgw-manager更新到了3.1版本，将整个软件的框架和构建系统升级到最新的Python标准中，并简化了安装要求。

安装

自动安装

本软件已经发布到PyPI，只需要执行

pip install NEU-ipgw-manager

本项目支持从3.7开始的所有现代Python版本，项目本身是在Python 3.12上开发的。

手动安装

首先克隆本仓库的源代码

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

切换到文件夹中，cd ipgw-py-manager

然后执行pip install .从源代码安装本软件

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

快速上手

配置文件在安装之后自动存放在用户的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命令将此用户设为默认登录用户。

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

详细输出

程序支持详细日志输出，如果程序出现异常，可以添加-v或者--verbose选项让程序输出更详细的日志，供debug使用。