Skip to content

Releases

v0.1.0

Choose a tag to compare

@ayeaaaa ayeaaaa released this 04 Oct 15:56

pushotp v0.1.0

通过 pushplus(微信)或 Telegram 发送动态验证码并校验的 Go 模块,可选签发短期 HMAC 令牌。用于替代固定 TOKEN,防止泄露。

特性

  • 两种用法:Go 库 github.com/ayeaaaa/pushotp;可选 HTTP 服务 pushotpd
  • 渠道:pushplus、Telegram(接口化设计,可自行注册新渠道)
  • 存储:memory / SQLite(纯 Go 无 CGO),配置切换,共享契约测试
  • 安全:crypto/rand 发码、加盐 SHA-256 存储、恒定时间比较、一次性使用、冷却 + 每小时配额、原子 CAS 防并发重放
  • 可选令牌:校验成功签发 HMAC-SHA256 无状态短期令牌,VerifyToken 离线验签

安装

go get github.com/ayeaaaa/pushotp@v0.1.0

预编译二进制

附件为 pushotpd 单文件(CGO_ENABLED=0、已 strip),支持:

平台 文件
Linux x86_64 pushotpd_v0.1.0_linux_amd64
Linux arm64 pushotpd_v0.1.0_linux_arm64
macOS Intel pushotpd_v0.1.0_darwin_amd64
macOS Apple Silicon pushotpd_v0.1.0_darwin_arm64
Windows x86_64 pushotpd_v0.1.0_windows_amd64.exe
chmod +x pushotpd_v0.1.0_linux_amd64
./pushotpd_v0.1.0_linux_amd64 -config config.yaml

配置参考仓库 README;config.example.yaml 复制后填入自己的 pushplus token 或 Telegram bot 凭据即可。

质量说明

  • 经过三轮对抗式代码审查(含威胁建模、运行时行为、并发/模糊测试)与 staticcheck / gosec / govulncheck 扫描,已知问题全部修复
  • 建议使用最新 Go 补丁版构建(标准库漏洞随补丁修复)

接口速览

方法 路径 说明
POST /api/v1/send {receiver, scene, ttl?, length?, data?} → {ticket_id, expires_in}
POST /api/v1/verify {ticket_id, code} → {ok, token?, expires_at?}
GET /api/v1/health 健康检查(含存储可用性)