大家好,我是这个小工具的开发者。
作为一名经历过软考(计算机技术与软件专业技术资格考试)折磨的考生,我深知“查成绩”这个环节有多反人类:官网从来不准时,只能蹲在电脑前疯狂刷新,或者眼巴巴盯着群里别人的消息。
为了彻底解决这个痛点,我开发了ruankao-monitor—— 一个轻量级的软考成绩监控助手。
简单来说,它能帮你:
- 24小时自动监控软考官网(ruankao.org.cn)。
- 一旦出成绩,立即通过微信、邮件、钉钉等渠道通知你。
- 部署极简,不需要昂贵的服务器,家里的 NAS(群晖/威联通/飞牛等)就能跑,且内存占用极低(<50MB)。
不用再焦虑地刷新网页了,出分那一刻,它会像闹钟一样叫醒你。
🛠️ 一、核心功能特性
- 多平台推送:支持 Server酱(微信推送)、企业微信、钉钉、Bark(iOS)、SMTP邮件。
- NAS友好:基于 Docker 打包,x86/ARM 架构通吃,非常适合挂机运行。
- 防误报:内置多种 HTML 解析策略,即使官网微调也能稳定运行。
- 去重机制:状态持久化,重启容器不会导致微信消息刷屏。
🚀 二、手把手部署教程 (Docker版)
如果你有一台 7x24 小时开机的 NAS 或服务器,请按照以下步骤操作,一分钟即可上线。
第一步:准备配置文件
你需要先创建一个配置文件config.yaml。你可以直接在服务器上创建,或者下载模板修改。
# 1. 创建项目目录并进入 mkdir -p ruankao-monitor && cd ruankao-monitor # 2. 下载配置文件模板 wget https://raw.githubusercontent.com/jason-PLA/ruankao-monitor/main/config.yaml.example -O config.yaml第二步:配置通知渠道(关键步骤)
使用编辑器(如nano或vim)打开config.yaml,填入你的通知信息。
- 微信推送(推荐 Server酱):
去 Server酱官网获取SendKey,填入server_chan_skey字段。 - 邮件推送:
填入你的 SMTP 服务器地址、端口、发件箱账号和授权码。 - 其他(钉钉/企业微信):
填入对应的 Webhook 地址即可。
第三步:启动容器
项目根目录下有一个docker-compose.yml文件,或者你可以直接使用以下命令运行:
# 使用 Docker Compose (推荐) docker-compose up -d # 或者使用纯 Docker 命令 docker run -d \ --name ruankao-monitor \ -v $(pwd)/config.yaml:/app/config.yaml \ jason-pla/ruankao-monitor:latest第四步:坐等出分
启动后,容器会自动开始轮询软考官网。当检测到成绩查询入口出现时,你会立刻收到推送!
💡 三、给非技术用户的建议
如果你不太熟悉 Docker 命令,但使用的是群晖(Synology)或飞牛NAS(fnOS):
- 在套件中心安装Docker。
- 打开 Docker 图形界面,注册表搜索
jason-pla/ruankao-monitor。 - 挂载路径:将本地的
config.yaml映射到容器内的/app/config.yaml。 - 启动即可。
📦 开源与反馈
这个项目是MIT 开源协议的,代码托管在 GitHub:
GitHub 仓库地址:https://github.com/jason-PLA/ruankao-monitor
如果你在部署过程中遇到问题,或者有新的功能建议(比如支持 Telegram),欢迎去 Issues 区提,或者直接在本帖回复。希望能帮到正在焦虑等成绩的你,祝大家逢考必过!🎉