JenkinWoo/sheeridVerify

项目介绍

sheeridVerify 是一个 Node.js 验证流程学习项目：先通过接口查询 SheerID 验证状态，再按当前步骤选择浏览器填表或材料上传。它提供本地 Web 工作台和任务队列，支持创建、排队、停止、恢复和删除任务，按配置限制并发，并在提交后定期查询结果。项目不会生成或修改证明材料，浏览器中的交互式真人验证由用户自行完成。README 明确声明仅用于教学、学术研究和获授权的流程测试，与 SheerID 及任何学校均无隶属关系。

快速使用

需要 Node.js 22.15 或更高版本与 npm。先克隆仓库并安装依赖和浏览器运行时，然后复制配置：

git clone https://github.com/JenkinWoo/sheeridVerify.git
cd sheeridVerify
npm ci
npm run browser:install
cp -n config/sheerid.example.json config/sheerid.local.json

Windows PowerShell 中把最后一行换成 Copy-Item config/sheerid.example.json config/sheerid.local.json。编辑 config/sheerid.local.json，设置获授权的国家、学校、data.organization.emailDomain 和材料来源；该文件必须是标准 JSON，不支持注释和尾随逗号。随后启动工作台：

npm run web

打开 http://127.0.0.1:8787，填写验证链接、名、姓、出生日期、可选代理和访问密码，再把任务加入队列。本地默认访问密码为 JenkinWoo；对外开放前应通过 ONE_WEB_PASSWORD 更换密码，并配置 HTTPS 入口。

命令行方式下，npm run status 只查询状态，npm start 打开并填写表单但不提交，npm run submit -- --file <路径> 或 --url <地址> 处理材料步骤。最小配置可参考 config/documents.example.json；document.path 与 document.url 只能二选一，材料必须是 20 MiB 以内的非空 PNG、JPEG 或 PDF。

使用约束

在 Linux 上使用有界面浏览器需要桌面环境；完整部署步骤和环境变量说明见部署指南。公网部署必须更换默认密码并使用 HTTPS。队列与历史只保存在服务内存中，重启服务会丢失排队和运行中的任务；提交后的审核等待会持续占用并发名额，直到成功、失败或手动停止。

项目支持带认证的 HTTP、HTTPS 和 SOCKS5 代理；未配置代理时读取系统代理设置，但不支持 PAC 自动配置脚本和系统代理排除列表。

HotRepo 点评

该项目在 2026-11-06 进入 HotRepo 新项目榜记录，在当日早些时候开始的统计窗口内录得 101 个 Star 和 81 个 Fork。这只是单次快照，不构成趋势判断，说明它获得了早期关注，但尚无持续排名记录。对一个刚创建的仓库来说，Fork 数与 Star 数接近这一比例也值得留意。