BitSRun_BNU 是一个北京师范大学特供版的用于自动完成深澜(srun)认证系统校园网登录的Python工具，支持多种设备平台。
- 自动获取IP地址并完成认证过程
- 支持检查在线状态
- 适用于不同运营商网络
- 跨平台支持 (Windows, Linux, macOS, ESP32等)
- 配置灵活，使用方便
- 支持守卫模式，自动检查并保持网络连接
- Python 3.6 及以上版本
pip install -r requirements.txt首次使用前，请复制配置模板并填写个人信息：
cp config.example.ini config.ini然后编辑 config.ini 文件，填入您的校园网账号和密码。
python run.py-c, --config: 指定配置文件路径 (默认: config.ini)-u, --username: 指定用户名 (将覆盖配置文件)-p, --password: 指定密码 (将覆盖配置文件)-t, --type: 指定运营商类型 (如: cmcc, unicom)--server: 指定认证服务器地址-v, --verbose: 显示详细日志-q, --quiet: 仅显示错误信息-g, --guard: 启用认证守卫模式-i, --interval: 守卫模式检查间隔(秒)，默认300秒
# 使用默认配置运行
python run.py
# 指定用户名和密码
python run.py -u student123 -p password123
# 使用移动运营商网络
python run.py -t cmcc
# 使用自定义配置文件
python run.py -c my_config.ini
# 启用守卫模式(每5分钟检查一次)
python run.py -g
# 启用守卫模式并自定义检查间隔(每60秒检查一次)
python run.py -g -i 60
# 启用守卫模式并指定自定义用户
python run.py -g -u student123 -p password123 -t cmcc守卫模式是一项持续运行的功能，可定期检查网络连接状态并在断开时自动重新连接。适用于以下场景：
- 网络环境不稳定需要保持持续连接
- 校园网认证经常自动断开
- 长时间需要保持在线状态
可通过两种方式启用守卫模式：
- 命令行参数：使用
-g参数启动程序 - 配置文件：在
config.ini的[Guard]部分设置enable = true
守卫模式检查间隔可以通过以下方式设置：
- 命令行参数：使用
-i SECONDS参数（如-i 120表示2分钟） - 配置文件：在
config.ini的[Guard]部分设置interval = 秒数
可通过Windows任务计划程序设置定时运行，确保网络保持连接。
对于需要长期保持连接的情况，建议使用守卫模式：
# 在后台启动守卫模式（需要在Windows中安装pythonw）
pythonw run.py -g -i 300在Linux系统上，可以添加cron任务实现自动运行：
# 每小时检查并登录
0 * * * * cd /path/to/bitsrun_buct && python run.py
# 或者在启动时以守卫模式运行
@reboot cd /path/to/bitsrun_buct && python run.py -g -i 300 > /dev/null 2>&1-
无法获取IP地址
- 检查网络连接
- 确认认证服务器地址是否正确
-
认证失败
- 确认账号密码正确
- 检查是否需要指定正确的运营商类型
-
日志显示JSON解析错误
- 可能是认证服务器响应格式改变
- 尝试使用
--verbose参数获取详细信息
bitsrun_buct/
├── run.py # 主入口脚本
├── bitsrun_buct.py # 核心功能模块
├── utils/ # 工具函数
│ ├── __init__.py
│ ├── base64_utils.py # Base64编码工具
│ ├── xencoding.py # 加密编码工具
├── config.ini # 用户配置
├── config.example.ini # 配置模板
├── README.md # 项目文档
└── requirements.txt # 依赖列表
如需添加新功能或适配其他认证系统，请参考bitsrun.py中的注释说明。
MIT License