本项目为解决浙江大学每日重复的健康打卡而开发,在完成首次手动打卡后,可以自动进行定时打卡。并通过邮件形式提醒通知打卡结果。本项目使用spring-boot、quartz和httpclient开发,使用maven进行项目管理,编译版本为jdk-14.0.2。支持多账户配置。
STEP 1 用来跑程序的设备
定时打卡任务意味着程序需要一直保持运行,因此个人建议将项目运行在一台服务器上。阿里云、华为云、腾讯云等都提供许多服务器租赁。当然,你要是保持个人电脑一直不关,那么用个人电脑也OK。
STEP 2 安装java语言
正如所说,本项目是一个java项目(src文件夹源码文件是*.java),因此需要用户事先安装java语言。作者的发行版用的是jdk-14.0.2,即java SE 14.0.2,官方下载地址。根据自己设备的操作系统选择对应的安装包即可。
安装包扩展名 | 对应系统 |
---|---|
deb | Linux发行版的Debian/Ubuntu |
rpm | Linux发行版的CentOS |
dmg | MacOS |
exe | Win |
STEP 3 下载作者提供的发行版
在gitee或github的项目发行版页面,下载最新的发行版(autocard-XXX.zip,XXX为版本号)。并解压。可以看到解压后目录结构如下
--autocard-XXX/
----autocard-XXX.jar ## 核心java程序,是编译后打包的jar包
----startup.sh ## 在linux下,用于启动java程序的shell脚本
----shutdown.sh ## 在linux下,用于关闭java程序的shell脚本
----config/
------application.json ## 用户配置,如账号密码等
------log4j2.xml ## 日志配置,不用修改
STEP 4 修改application.json
用任意文本编辑器打开config目录下的application.json,配置下列信息。
{
"mail":{ //配置发送邮件通知的邮箱
"username":"***", //用来发送邮件的账号
"nickname":"AutoCard", //发件名
"password":"***", //发件邮箱密码
"smtp":"smtp.zju.edu.cn", //SMTP邮件服务运营商服务器域名,默认浙大邮箱
"port":994 //SMTP邮件服务端口
},
"jobs":[ //配置多个打卡账号
{
"username":"***", //打卡的通行证账号1,即学工号
"password":"***", //对应登录密码
"mail":"***", //发送打卡结果的收件邮箱
"cron":"0 0 0 * * ? *", //cron表达式定时,示例为每天00:00:00
"delay":true //任务开启随机延时0-1800秒
},
{
"username":"***", //打卡的通行证账号2
"password":"***", //对应登录密码
"mail":"***", //发送打卡结果的收件邮箱
"cron":"0 0 2 * * ? *" //cron表达式定时,示例为每天02:00:00
}
]
}
邮箱用于打卡的通知,默认使用浙大邮箱,否则需要mail.smtp
和mail.port
参数配置为指定第三方邮箱如QQ邮箱的配置。若不配置邮箱信息,将不会邮件提醒。
cron表达式是用于定时任务的经典表达式,该参数允许用户自定义打卡定时方式。网上有很多现成的表达式模板以及表达式在线生成工具。默认定时设定是每天早上9点自动打卡。网上有很多介绍或在线生成器。cron表达式从左到右(空格分开)指的是“秒 分 时 每月第几天 月份 每周第几天 年份”,特殊符号表示通配。对于多个打卡用户配置,建议定时错开,并发登录容易被浙大后台拒绝
0 0 0 * * ? * ## 每天00:00:00打卡
0 30 6 * * ? * ## 每天06:30:00打卡
0 0 9 * * ? * ## 每天09:00:00打卡
delay参数为true时,每次执行任务会随机延时0~1800秒,这样的好处在于每天打卡时间固定。
STEP 5 运行程序
需要通过命令行来运行程序,在Windows下,常见的命令行是cmd和powershell,打开方式“WIN + R”,输入"cmd"或"powershell",确定即可。linux服务器打开即是shell命令行页面(To小白:如何连接Linux服务器请自行百度一下,拥有服务器用户名、密码、IP、端口,通过ssh客户端访问)。
java -jar autocard-XXX.jar # 方式一,在auotcard-XXX的解压目录下,直接通过java命令运行
.... # 然后你会看到日志输出到屏幕,此方法仅适合不关闭命令行页面,在自己电脑跑
bash startup.sh # 方式二,运行上面说的shell脚本启动,但仅限于linux服务器。可以关闭服务器连接
.... # 会弹出nohup的信息,直接enter下去就好
对于方式一,关闭命令行页面即为关闭程序。方式二请通过bash shutdown.sh
关闭程序。还是推荐服务器上,用方式二运行。
通过方式一,运行正常可以看到下列日志输出屏幕。不论哪种方式,相同的程序日志会在app.log
文件中看到。最后日志显示JVM running。(等到了打卡时间,日志会继续输出)
- app.autoCard.cronExpresssion
该参数可以统一修改了默认的cron表达式。每个用户如果配置各自的cron,那么定时任然按照用户配置。注意示例中的引号。
java -jar autocard-XXX.jar "--app.autoCard.cronExpresssion= 0 0 7 * * ? *"
- app.zjuClient.cookieCached
该参数默认为false,设置为true则会启动cookie缓存。多用户配置时,此参数不要启用,否则会造成冲突登录。
java -jar autocard-XXX.jar --app.zjuClient.cookieCached=true
若用户需要使用低版本如jdk 1.8,需要在对应版本(安装对应版本jdk并修改pom.xml中版本信息)下重新编译打包maven项目(要求用户得安装了maven),建议配置maven工具的镜像为阿里云(这样首次打包时下载依赖库会快一点,阿里云教程)。
- 克隆或下载本项目
在github或gitee中,都提供了项目的clone、fork或者直接下载zip,下载完成后进入目录。
利用git工具,命令行下克隆项目
git clone https://gitee.com/GCSZHN/AutoCard.git
git clone https://github.com/GCS-ZHN/AutoCard.git
- 修改pom.xml
<maven.compiler.source>你的java版本</maven.compiler.source>
<maven.compiler.target>你的java版本</maven.compiler.target>
用任意文本编辑器编辑pom.xml,修改上述配置。
- 运行打包脚本
bash build.sh ## linux
powershell build.ps1 ## windows
根据平台,运行打包脚本。会产生一个release子文件夹。不过个人没有macOS,故没有编写macOS打包脚本,用户可以直接执行mvn package spring-boot:repackage
打包生成jar文件,然后按照前面的目录结构放置。
java.lang.reflect.InaccessibleObjectException
这是与java模块化有关的问题,采用java 16等很新的java版本可能会抛出,解答详细请看相关issue。修改时请将startup.sh中的java命令一并修改。
若打卡题目被更新或者你的任何信息情况有变化(如返校),请先手动打卡一次。本项目仅供学习参考。使用时请确保信息的正确性。滥用造成的后果请自行承担。
修复报错“从下列地区返回浙江格式错误”和代码优化。
修复了打卡后,前端页面显示在境外的问题。实际上这并不影响打卡实际定位,但由于undefined和空字符串""在javascript中的不同,前端页面会显示在境外。
该版本修正了2021年11月9日学校健康打卡平台前端格式变换引起的BUG,同时在打卡信息提示上引入了当前打卡地点的提示。自动打卡是作用是解放手动,但若信息变化,请如实手动打卡更改。
近期,直接登录https://zjuam.zju.edu.cn/cas/login,即使登录成功,也无法顺利进入service.zju.edu.cn,从而导致Connection Timeout情况的出现而打卡失败,因此做出此次更新。
引入了打卡的随机延时,使得每天打卡时间相对不固定。
修复了打卡地区发生变化时的小Bug。打卡地区发生变化时请自行打卡(注意先关掉打卡程序或先于打卡定时时间)。
2021年8月5日,学校健康打卡平台代码逻辑有变化(感兴趣去看一下它JS源码),AutoCard进行针对性升级。原先版本会一直提示重复打卡。
任何使用问题,欢迎通过邮箱[email protected]交流。