KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

bupt-net-login

★ 143 Open GitHub ↗

北邮北京邮电大学校园网网关自动化认证脚本。支持有线网和无线网。支持带参数 Portal 认证、AC 跳转、掉线重连。跨平台。 BUPT Network Login.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# bupt-net-login

这是一个用于认证北京邮电大学校园网网关的脚本（包括有线网和无线网 BUPT-portal ）。支持带参数 AC 重定向认证、掉线重连。支持所有能运行 bash 和 curl 的操作系统（包括 Linux, macOS, FreeBSD, Windows 等）。

还在因为服务器没有 GUI 难以登录校园网而烦恼吗？还在因为偶尔网络掉线而忧虑吗？快用 bupt-net-login 吧！

## 为什么选择这个脚本

众所周知，现在北邮无线网 (portal) 认证 `10.3.8.216` 需要带参数了（有线网 `10.3.8.211` 暂时还不需要）。传统一个 POST 直接硬怼 `10.3.8.216/login` 的方法不行了（目前绝大多数的脚本都是这么做的），所以跑不了了。即自行访问 Captive Portal 认证页，而非由 AC 重定向，将会缺少必要参数，当 ClearPass 缓存过期时，认证页将会提示用户"认证失败 0x01000003"。

这个脚本能同时处理 **有线网** 和 **无线网** 的带参数认证方式、遵循 AC 重定向，并掉线自动登录，确保长期在线。

如果后续北邮认证又做了什么更改，我又没更新，可以提 issue （x 。

## 快速开始

如果您只想登录一次（不需要后续自动登录），请查阅 [手动登录](#手动登录) ，其余部分跳过即可。

如果你希望自动登录：

- 如果你用的是 Windows ，请跳过其他部分，直接阅读 [Windows 用户单独说明](#windows-用户单独说明) 。
- 如果你用 Linux, macOS, FreeBSD 等，请查阅 [cronjob](#cronjob) 。
- 如果你用 Linux 且想用 Docker , 请查阅 [Docker](#docker) 。

## 手动登录

立即登录网关，不自动检查掉线。

首先需要下载本项目下的 `bupt-net-login` 这个文件（无论通过哪种方式，例如 GitHub 网页下载、 git clone 等等，只要拿到这个文件就行。如果你在服务器上，那么想办法传上去就行，例如使用 scp ），并 `chmod +x bupt-net-login` 。

```bash
./bupt-net-login
```

脚本会询问你的学号和网关密码用于登录（如果需要），你也可以保存用户名和密码（脚本会询问），方便下次登录。

> [!NOTE]
> Windows 用户记得在 Git Bash 里面跑（或者其他 bash 环境）。

如果你已经登录：
```console
2023-05-06 09:24:16 [INFO] 您已经登录, 无需进一步操作
```
如果你没有登录：
```console
2023-05-06 09:24:16 [INFO] 您未登录, 准备认证...
2023-05-06 09:24:16 [INFO] 准备使用账号 xxx 进行认证, 认证地址 xxx
2023-05-06 09:24:16 [INFO] 获取 cookie ...
2023-05-06 09:24:16 [INFO] 正在认证...
2023-05-06 09:24:17 [INFO] 账号 xxx 认证成功
```
</details>

科研有线网用户：对于确实只需要临时登录一下，而且 scp 这个文件都嫌麻烦/有问题的，考虑一键式登录（随时可能失效）：`curl -L -X POST --data 'user=<学号>&pass=<网关密码>' http://10.3.8.211/login`。

## 自动登录

这是建议的用法，可以保证你的网关一直都是登录的。默认情况下会 _每 5 分钟_ 检查网关是否登录，如果没有将自动登录。

有两种运行方法（二选一）:

- crobjob: 你的系统是任何类 Unix (Linux, macOS, FreeBSD等)；
- Docker: 你的系统是 Linux 并有 Docker ，能拉到 DockerHub 或 GHCR 的镜像。

> [!NOTE]
> 鉴于国内网络状况（ GFW 在约 2024 年 6 月阻断了境内对 DockerHub 的访问，如果你没有科学上网的姿势，镜像大概率是拉不下来的），建议使用 cronjob 。

> Windows 用户直接阅读 [Windows 用户单独说明](#windows-用户单独说明)

### cronjob

首先需要下载本项目下的 `bupt-net-login` 这个文件（无论通过哪种方式，例如 GitHub 网页下载、 git clone 等等，只要拿到这个文件就行。如果你在服务器上，那么想办法传上去就行，例如使用 scp ），并 `chmod +x bupt-net-login` 。

如果你希望全局安装（以 root 用户），你可以运行，安装脚本将会在安装前告诉你它会做的事：
```bash
sudo ./bupt-net-login install
```

如果想以当前用户安装至 `~/bin` 可以这么写，安装脚本将会在安装前告诉你它会做的事：
```bash
PREFIX=$HOME/bin \
    ./bupt-net-login install
```

因为已经安装至系统 PATH 了，安装完就可以删除 `bupt-net-login` 这个文件了： `rm `bupt-net-login`。

接下来它会在后台运行并自动检查登录态，后续你可以使用 `cat /tmp/bupt-net-login.log` 查看日志。你也可以直接使用 `bupt-net-login` 来手动运行一次。

如果你需要卸载：

- `bupt-net-login uninstall` 删除当前用户的自动登录（如果有）
- `sudo bupt-net-login uninstall` 删除 root 用户的自动登录（如果有）
- `rm $(which bupt-net-login)` 删除 bupt-net-login 自身

### Docker

对于 `docker` ，你可以直接 `docker run` 或者使用 `docker compose`。

- 直接使用 `docker run` 只需一行命令即可：
    ```bash
    docker run \
        --detach \
        --name bupt-net-login \
        --restart unless-stopped \
        --network host \
        -e BUPT_USERNAME="你的学号" \
        -e BUPT_PASSWORD="你的网关密码" \
        charlie0129/bupt-net-login
    ```
    参数说明：`--detach` 表示在后台运行，如果你调试时需要在前台运行，将其替换成 `-it --rm`；`--restart unless-stopped` 指定了自动重启的策略，即在意外停止后自动重开（例如重启计算机后）；`--network host` 表示使用宿主机网络协议栈，以防走 NAT 可能会有的奇怪小问题。

接下来它会在后台运行并自动检查登录态（重启后也能继续）。后续你可以使用 `docker logs bupt-net-login` 查看日志；`docker stop bupt-net-login` 来停止运行；`docker rm bupt-net-login` 来删除容器；

- 使用 `docker compose`：你可以查阅本项目下的 `docker-compose.yml` ，其中包含了足够的例子。然后使用 `docker compose up -d` 来启动。

> `charlie0129/bupt-net-login` Docker 镜像支持的平台包括 `linux/amd64` ( 64 位 x86 ), `linux/386` ( 32 位 x86 ), `linux/arm64` ( 64 位 arm ), `linux/arm/v7` `linux/arm/v6` ( 32 位 arm ), `linux/s390x` (IBM z Systems), `linux/ppc64le` (IBM POWER8) 。

## 高级

### 自定义 cron

默认每 5 分钟检查一次登录态，你可以通过附加命令行参数来自定义它，参数为标准 cron 格式 `x x x x x` ，注意时区（默认 UTC+0 ）。

例如你想每分钟运行一次：
- 在 `docker run` 的时候附加参数：`docker run <省略> charlie0129/bupt-net-login "* * * * *"` 
- 本机运行 `./bupt-net-login install` 的时候附加参数：`./bupt-net-login install "* * * * *"`。

### 指定学号和密码

默认脚本会以交互式的方式询问你的学号和密码，如果你想无人值守操作，可以通过环境变量 `BUPT_USERNAME` 和 `BUPT_PASSWORD` 来指定，这时脚本就不会询问密码了。

### Windows 用户单独说明

众所周知， Windows 下面是没有 bash 的，自带的 curl 也是 [假 curl](https://github.com/PowerShell/PowerShell/pull/1901) ，根本没法用。所以如果想在 Windows 下跑这个脚本，那首先需要解决的是 bash 和 curl 的问题。

幸好， Git for Windows 已经为我们解决了这个问题（当本质上利用了它自带的 MinGW64 ）。作为北邮学子，相信你一定用过 Git 吧！（千万别说你不知道什么是 Git）既然你用过了，那就大概率已经安装了 Git for Windows 。

> 如果确实不知道并且没安装 Git for Windows ，那就现在装一下罢，使用搜索引擎搜索安装即可。

> Git for Windows 是最推荐最简单的方法，接下来的教程都基于它。如果你确实不想用 Git for Windows 自带的 MinGW64 ， **提示：** 你可以使用 MinGW, WSL, Cygwin 等运行 bash 脚本。不过这样就需要靠你自行解决遇到的问题了罢。

从 GitHub 下载代码：

然后你需要打开 Git Bash ，它长这样：

接下来你只需知道，README 里面读到的每一行命令都需要在 Git Bash 里面执行（别在 cmd 或者 PowerShell 里面跑，大概率跑不了）。不过你忘了也没事，会持续提醒你的（

你可以先尝试一下 [手动登录](#手动登录) 看看能不能跑。

如果可以跑，那就能继续配置自动登录了。（相当于 [自动登录](#自动登录) 章节的 Windows 做法）。在开始前确保你已经下载了本项目下的 bupt-net-login 文件，后面要用到（你可以把它放在一个容易找到的位置，例如 C 盘根目录）。

首先你需要打开 Task Scheduler （计划任务），你可以使用 win+S 搜索。

选择 Create Task

填写任务基本信息，接下来基本照着做就行，注意红框中的要点。

你可以自行调整重复间隔（即每过多久检查一次登录态）。

**注意：**

- 这里的 `Program/script` 为你的 Git for Windows 中 bash 的位置，一般情况下保持图中的值即可。如果你修改过安装目录则对应修改，图中 `"C:\Program Files\Git\bin\bash.exe"` 为默认位置。 
- `Add arguments` 中填入 `-c "BUPT_USERNAME='你的学号' BUPT_PASSWORD='你的网关密码' bash '你的bupt-net-login所在位置' >>/tmp/bupt-net-login.log 2>&1"` 。注意这里有三处你需要替换的地方： 1. 学号 2. 网关密码 3. bupt-net-login 所在位置。 **不要漏掉任何一个标点！**

例如：

- 你下载的 bupt-net-login 放在了 C 盘根目录 （ `C:\bupt-net-login` 对应到 bash 里面是 `/c/bupt-net-login` ） 
- 学号为 2019000000
- 密码为 00000000

那么你的 `Add arguments` 可以这么填写： `-c "BUPT_USERNAME='2019000000' BUPT_PASSWORD='00000000' bash '/c/bupt-net-login' >>/tmp/bupt-net-login.log 2>&1"`。 **不要漏掉任何一个标点！**

其他地方按需修改即可，然后点击 OK 创建任务。

选择刚刚创建的任务，选择 Run 即可测试。

为了测试是否成功，你可以查看日志 `%TEMP%\bupt-net-login.log` 。快捷查看方法： Win+R 输入 `notepad %TEMP%\bupt-net-login.log` 即可用记事本打开。看到登录成功的提示说明操作完成。

你的 Windows 自动网关认证就配置完成了！他会在后台自动保持登录。

> [有用户](https://github.com/charlie0129/bupt-net-login/issues/2) 报告称执行计划任务时会报 2147943726 错误，如果你遇到了类似的问题，可以尝试在 `General` 选项卡中勾选 `Do not store password` 。
> <img width="632" src="img/task-fix-1.png"></img>
> Acknowledgement: [@kahakaha](https://github.com/kahakaha)

bupt-net-login

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README