MIT 开源 · 多语言 SDK
让你的用户
用上短信验证码登录
个人开发者专用。对接阿里云「短信认证」，无需自建签名模板。PHP / Node / Python / Go 直接用，其它语言走 HTTP 网关。
新手 3 步上手（复制即可）
不需要懂阿里云签名算法。下载 → 运行配置脚本 → 命令行测一条短信。
1
下载并进入目录
git clone https://github.com/aiyangdie/sms-verify-kit.git
cd sms-verify-kit
2
一键配置（输入 AccessKey 和 SignName）
bash scripts/setup.shSignName 常见为「速通互联验证码」，以阿里云控制台为准。
3
测试发码 & 验码
php bin/sms-verify.php doctor
php bin/sms-verify.php send 13800138000 login
php bin/sms-verify.php verify 13800138000 收到的验证码测试会真实发短信并扣费（约 ¥0.06/条）。
为什么选择 SmsVerifyKit？
不是又一个闭源 SaaS。给你源码、文档和 SDK，密钥和账单都在你自己的阿里云账号里。
⚡ 10 分钟接入
开通阿里云短信认证 → 填 AccessKey → 调 SDK。系统模板免申请。
🌍 任意语言
官方 SDK 四种语言；Gateway 提供 REST，Java/Rust/C# 都能 curl。
🔐 场景齐全
登录、注册、绑手机、换绑、找回密码，scene 参数一行切换。
📖 规则透明
费用、合规、安全边界写进文档，不玩文字游戏。
🏗 可自托管
Gateway 部署在你自己的服务器，数据不经第三方平台。
💚 永久免费
MIT 协议，可商用、可修改。社区驱动，Issue/PR 欢迎。
快速开始
先在 阿里云号码认证控制台 开通「短信认证」，获取 AccessKey 和系统签名。
# 配置好 .env 后
$client = AliyunPnvsClient::fromEnv('/path/to/sms-verify-kit');
$client->send('13800138000', 'login');
$client->verify('13800138000', '1234');const { AliyunPnvsClient } = require('@aiyangdie/sms-verify-kit');
const client = new AliyunPnvsClient({
accessKeyId: process.env.SMS_ACCESS_KEY_ID,
accessKeySecret: process.env.SMS_ACCESS_KEY_SECRET,
signName: '速通互联验证码',
});
await client.send('13800138000', 'register');
await client.verify('13800138000', '1234');from sms_verify_kit.client import AliyunPnvsClient
client = AliyunPnvsClient(
access_key_id="...",
access_key_secret="...",
sign_name="速通互联验证码",
)
client.send("13800138000", scene="bind_phone")
client.verify("13800138000", "1234")# 先启动: php -S 127.0.0.1:8080 -t gateway/public
curl -X POST http://127.0.0.1:8080/v1/send \
-H "Content-Type: application/json" \
-d '{"phone":"13800138000","scene":"login"}'
curl -X POST http://127.0.0.1:8080/v1/verify \
-H "Content-Type: application/json" \
-d '{"phone":"13800138000","code":"1234"}'
# API 说明: http://127.0.0.1:8080/docs完整文档：docs/zh-CN
费用说明（必读）
SmsVerifyKit 源码免费。 短信由阿里云直接向你的账户收费，与本项目作者无关。测试短信也计费。
| 项目 | 谁付费 | 大约多少钱 |
|---|---|---|
| SmsVerifyKit SDK / Gateway | 你 | ¥0（MIT 开源） |
| 阿里云短信认证（按量） | 你 → 阿里云 | 约 ¥0.06/条（≤1000次/月档位） |
| 阿里云短信认证（套餐包） | 你 → 阿里云 | 按控制台套餐，折合更低 |
| 你的 VPS / 服务器 | 你 | 视服务商而定 |
例：个人站点每月 500 条验证码 ≈ 500 × ¥0.06 ≈ ¥30/月（仅供参考，以阿里云账单为准）。 官方定价 →
产品规则（通俗版）
- 我们提供代码，不提供短信。 你必须有自己的阿里云账号并开通短信认证。
- AccessKey 只能放服务端。 禁止写进前端、App 或 Git 仓库。
- 验码通过后再信任用户。 SDK 只管发码/验码，登录态和用户库你自己做。
- 短信不是免费的。 成功发送即计费，请设置阿里云费用预警和接口限流。
- 合规是你的责任。 需隐私政策，禁止垃圾短信；遵守当地法律。
- 软件按原样提供。 MIT 协议，无商业 SLA，社区尽力维护。