校园网守护 · 适配 Ruijie ePortal 的校园网自动认证与断网重连工具
Ruijie ePortal campus network auto-login and reconnect tool
CampusNet Guard（校园网守护）是适配 Ruijie ePortal 的校园网自动认证与断网重连工具，覆盖宿舍、教室、实验室、办公室、图书馆、机房、NAS、软路由、小主机等需要保持校园网在线的场景。
| 名称 | 说明 |
|---|---|
| CampusNet Guard | 公开产品名和 Release 下载文件名 |
| campusnet | 推荐 CLI 命令 |
| campusnet-guard | 兼容 CLI 别名 |
| cyber-lobster | 旧版本兼容命令 / 内部 Python 包名 |
| 场景 | 说明 |
|---|---|
| 宿舍电脑 | 个人笔记本、台式机，断网自动重连 |
| 教室/实验室 | 工位机、教学设备，保持在线 |
| 办公室 | 办公电脑，避免频繁认证 |
| 图书馆 | 公共区域设备（不建议保存账号） |
| 机房 | 批量设备，长期在线 |
| NAS | 群晖/威联通等，7x24 在线 |
| 软路由 | OpenWrt/爱快等，网关级守护 |
| 小主机 | 树莓派、工控机、迷你主机 |
| 个人电脑 | 任何需要保持校园网在线的设备 |
Windows 普通用户：下载 campusnet-guard-windows.zip，解压后双击 1-点我启动-校园网守护.exe 即可使用，不需要安装 Python。
更多下载说明见 docs/MIRROR_DOWNLOADS.md 或官网。
⚠️ 安全提醒：请只从官网、GitHub Releases 或这里列出的网盘入口下载，不要使用来路不明的 exe 文件。
从 Releases 页面 下载 campusnet-guard-windows.zip，解压到任意文件夹。
双击 1-点我启动-校园网守护.exe。
首次运行提示：当前版本暂未进行代码签名，因此 Windows SmartScreen 可能提示未知发布者。请只从官方 GitHub Releases 下载，并自行判断是否信任。点击 "更多信息" → "仍要运行" 即可。详见 Windows 安全提示说明。
打开 GUI 的 高级 页，点击 添加账号：
- 选择运营商（电信/移动/联通/校园网）
- 输入学号
- 输入密码（输入时不会显示）
- 确认认证服务器地址（不同学校可能不同）
- 点击 保存并验证
验证成功后账号自动保存。密码不会明文保存，由 Windows DPAPI 加密保护。
回到 主页，点击 开始守护。程序会每 10 秒检测一次网络，断网时自动重新认证。
打开 设置 页，勾选 开机后自动运行并守护校园网。以后电脑开机后会自动启动并进入守护模式。
| 页面 | 功能 |
|---|---|
| 主页 | 开始守护、停止守护、注销下线、检测网络、实时日志 |
| 高级 | 添加账号、多账号切换、测试登录、删除账号 |
| 设置 | 检测间隔、开机自动守护、配置保存位置 |
| 帮助 | 内置使用说明 |
当前版本暂未进行代码签名，因此 Windows SmartScreen 可能提示未知发布者。请只从官方 GitHub Releases 下载，并自行判断是否信任。
处理方式：
- 弹出蓝色窗口 → 点击 "更多信息" → "仍要运行"
- 弹出黄色窗口 → 点击 "更多信息" → "仍要运行"
UPX 是可执行文件压缩工具，可能触发安全软件误报。本项目不使用 UPX，文件较大（约 15 MB），但兼容性更好。
- 密码不明文落盘
- Windows：使用 DPAPI 加密，绑定当前系统用户，换用户/换电脑后需重新输入
- Linux：使用本地密钥保护密码，配置文件权限 600
- 配置文件权限：
chmod 600，仅当前用户可读写 - 配置路径：
- Windows：
%APPDATA%\cyber-lobster\config.json - Linux：
~/.config/cyber-lobster/config.json
- Windows：
- 配置与程序分离：EXE 放在哪里都不影响配置文件位置
- 不收集遥测：不收集任何日志、密码、cookie、token
Linux 用户通过源码运行，不提供 Linux EXE。适用于 NAS、软路由、小主机、实验室/办公室工位等场景。
git clone https://github.com/mi179/campusnet-guard.git
cd campusnet-guard
bash scripts/linux/install.sh或手动安装：
python3 -m venv .venv
source .venv/bin/activate
pip install -e .# 添加账号（密码隐藏输入，自动加密保存）
campusnet setup
# 启动断网自动重连
campusnet start
# 诊断配置和网络状态
campusnet doctor
# 查看已保存账号
campusnet list
cyber-lobster是旧版本兼容命令，仍然可用。campusnet是 CampusNet Guard 的轻量 CLI 推荐入口。
# tmux 后台运行
tmux new -s campusnet
campusnet start
# Ctrl+B D 退出 tmux，程序继续运行
# tmux attach -t campusnet 重新连接
# screen 后台运行
screen -S campusnet
campusnet start
# Ctrl+A D 退出 screen
# screen -r campusnet 重新连接仓库提供 systemd user service 模板，但不会自动启用。高级用户可手动配置：
# ~/.config/systemd/user/campusnet-guard.service
[Unit]
Description=CampusNet Guard 校园网自动认证守护
After=network-online.target
[Service]
Type=simple
ExecStart=%h/.venv/bin/campusnet start
Restart=on-failure
RestartSec=30
[Install]
WantedBy=default.targetWindows 普通用户推荐使用 GUI。 Linux 用户使用 CLI。
| 命令 | 用途 |
|---|---|
campusnet setup |
添加账号（add 是别名） |
campusnet start |
启动守护 |
campusnet list |
查看账号 |
campusnet verify |
验证登录（test 是别名） |
campusnet doctor |
诊断 |
campusnet logout |
注销下线 |
campusnet autostart enable |
开启开机自启 |
cyber-lobster是旧版本兼容命令，仍然可用。campusnet是推荐入口。
完整命令列表：campusnet --help
- 运营商选错 — 电信选 DX，移动选 YD，联通 LT；校内直连选"校园网"
- 账号或密码错误 — 确认学号和密码正确
- 认证服务器地址不对 — 不同学校的认证服务器地址可能不同，示例
172.16.54.18，联系学校网络中心确认 - queryString 过期 — 重新添加账号，或从浏览器登录页复制
不同区域的认证服务器可能不同。尝试在添加账号时修改认证服务器地址。部分教室/网络环境不弹认证页，可能是学校网络策略限制。
学校网络系统可能限制同时在线设备数量。如果超出限制，其他设备会被踢下线。这取决于学校策略，本工具无法改变。
普通 Windows 用户优先使用国内快速下载：
GitHub Releases 仍然是可信源和版本源。不要从搜索结果里的陌生下载站下载 exe 文件。
Windows DPAPI 加密的密码绑定当前系统用户，换电脑/换用户后需要重新运行 campusnet setup 输入密码。
通常不用先手动关闭。CampusNet Guard 会尽量让校园网认证请求直连认证服务器，不走环境代理。
如果登录失败，先运行：
campusnet doctor看输出里的"代理/VPN 兼容性"。普通用户可以先临时暂停代理/VPN/TUN 后重试；高级用户可以把认证服务器地址加入直连规则。
开机自启动的程序不会在桌面显示图标。它在后台运行，只在任务栏右下角（系统托盘）有图标。如果找不到，按 Ctrl+Shift+Esc 打开任务管理器，查看"启动"选项卡。
- 删除下载的程序文件夹
- 删除配置文件：
- Windows：
%APPDATA%\cyber-lobster\ - Linux：
~/.config/cyber-lobster/
- Windows：
- 本工具仅用于用户自己的校园网账号自动认证和断网重连
- 本工具不绕过认证、不破解、不共享账号、不突破在线数量限制
- 本工具只自动提交用户自己的账号，模拟正常的登录流程
- 学校/运营商的认证策略、在线设备数量、教室是否弹认证页，由网络系统决定，本工具无法控制
- 部分教室/网络环境不弹认证页、无法认证、在线数满，可能不是软件问题
- 不保证适配所有 Ruijie ePortal 版本
- 不建议在公共电脑保存账号
- 使用者应遵守学校网络管理规定
- 下载请以 GitHub Releases 或官方页面为准，不要使用来路不明的 exe
- 使用者自行承担账号安全和网络合规责任
| 文件 | 用途 |
|---|---|
campusnet-guard-windows.zip |
Windows 用户下载包 |
1-点我启动-校园网守护.exe |
图形界面版（推荐） |
9-排障工具-不懂不用点.exe |
排障工具，普通用户不用打开 |
- 不需要安装 Python — EXE 已包含 Python 运行时
- 不需要安装 PyInstaller — 这是开发工具，普通用户不需要
- Linux 用户：通过源码安装，参见上方 Linux 使用说明
- macOS：暂未验证，不作为当前支持平台
- 官网：https://campusnet.journeymind.blog
- GitHub Releases：https://github.com/mi179/campusnet-guard/releases/latest
- 国内快速下载：见 docs/MIRROR_DOWNLOADS.md
⚠️ 安全提醒：无论从哪个渠道下载，都请优先核对 GitHub Releases 或官网说明，避免来路不明的 exe 文件。
有问题请提交 Issue → https://github.com/mi179/campusnet-guard/issues