《职校家园实习备案自动打卡系统》安装与配置指南
1. 项目基础介绍
本项目是一个开源的自动打卡系统,适用于职校家园和实习备案平台。其主要功能是实现自动打卡,并支持多用户、自定义位置与时间、微信消息推送等。项目采用Python语言开发,利用GitHub Actions或个人服务器进行部署。
2. 项目使用的关键技术和框架
- Python:项目的主要编程语言。
- requests:用于发送HTTP请求。
- pytz:用于处理时区。
- pycryptodome:用于加密。
- GitHub Actions:用于自动化运行打卡任务。
- pushPlus:用于微信消息推送。
3. 项目安装和配置的准备工作与详细步骤
准备工作
- 确保您的系统中已安装Python环境。
- 准备一个GitHub账户,用于Fork和操作项目。
- 如果使用服务器部署,确保服务器已安装Python环境。
安装步骤
使用GitHub Actions部署
-
Fork项目:访问项目主页,点击右上角的“Fork”按钮,将项目复制到自己的GitHub账户中。
-
配置文件:在项目中找到
user.json
文件,根据以下模板填写您的配置信息。[ { "enable": true, "alias": "张三", "phone": "18888888888", "password": "123456...", "deviceType": "Xiaomi|Mi 13|13", "deviceId": "设备ID", "randomLocation": true, "address": "打卡地址", "longitude": "位置经度", "latitude": "位置纬度", "pushKey": "推送Key" } ]
-
设置Secrets:在GitHub仓库的Settings->Secrets->Actions中,添加一个名为
USERS
的Secret,值为您的配置文件内容。 -
运行测试:在GitHub仓库的Actions中,找到Sign workflow,点击“Run workflow”运行测试。
使用个人服务器部署
-
下载项目源码:将项目源码下载到您的服务器。
-
安装依赖:在服务器中运行以下命令安装依赖。
pip install requests pip install pytz pip install pyryptodome
-
配置文件:在项目目录中创建一个
user.json
文件,并填入您的配置信息。 -
设置定时任务:根据您的系统,搜索如何创建定时任务。例如,在Linux系统中,可以编辑crontab文件来设置定时任务。
-
运行测试:运行
python Main.py
测试配置是否正确。
以上步骤为您提供了从零开始部署和使用职校家园实习备案自动打卡系统的详细指南。请确保按照步骤操作,并根据自己的实际情况调整配置。