上海海事大学-校园网-自动认证

src="Assets/Images/Logo/Logo128.png" 
alt="Logo"

src="https://img.shields.io/badge/Python-3.8%2B-brightgreen"
alt=""

使用文档

请参考 使用文档

支持平台

• Windows命令行(exe、pip)
• macOS命令行(二进制文件、pip)
• Linux命令行(pip)
• Docker镜像

GUI Coming Soon...

Features

• 自动认证
• 程序记录日志

使用方法

使用 UV 包管理器 (推荐)

本项目现已支持 uv 包管理器，提供更快的依赖安装和管理体验。

快速开始

Windows (PowerShell):

# 自动安装 uv 并初始化项目
.\setup_uv.ps1

# 运行程序
uv run python start_cli.py

Linux/macOS (Bash):

# 自动安装 uv 并初始化项目
./setup_uv.sh

# 运行程序
uv run python start_cli.py

详细的 uv 使用指南请参考 UV_GUIDE.md。

直接使用二进制可执行文件

Docker(推荐在服务器中使用这种方式)

https://hub.docker.com/r/a645162/shmtu-auth

docker pull registry.cn-shanghai.aliyuncs.com/a645162/shmtu-auth:latest

直接运行Python源代码(请手动安装依赖库)

Windows

.\start.ps1

Linux

chmod +x start.sh
./start.sh

环境变量

必选配置项：

学号列表中，学号之间用 ; 分隔

• SHMTU_AUTH_USER_LIST : {学号1}; {学号2}
• SHMTU_AUTH_USER_PWD_{学号1} : {学号1的密码}
• SHMTU_AUTH_USER_PWD_{学号2} : {学号2的密码}
• SHMTU_AUTH_USER_PWD_ENCRYPT_{学号1} : {学号1的密码的是否为密文，密文为1，否则不用填}

可选配置项：

• SHMTU_MACHINE_NAME: 服务器名称
• SHMTU_AUTH_TIME_INTERVAL: 认证状态检测时间间隔

开发指南

推荐使用 uv 进行包管理，也可以使用 Anaconda 或 Miniconda 创建虚拟环境。 推荐使用学生认证的 Jetbrains PyCharm Professional 进行开发。

因为许多开发步骤已经在 PyCharm 中配置好，因此推荐使用 PyCharm 进行开发。

GUI说明

Windows下AMD显卡显示Mica云母特效会有问题，因此全局关闭了Mica云母特效。

macOS x64下Python版本必须小于等于3.11，否则无法安装PySide6。

License

本程序使用GPL-3.0协议开源。

GPLv3协议是我非常喜欢的一个协议，我的大部分程序均基于GPLv3协议开源。

此外，本程序使用到的QFluentWidgets库恰好也是基于GPLv3协议开源的。