快速开始
本文介绍如何在本地启动 EasyIT Pay 并完成首次验证。
环境要求
| 组件 | 版本要求 |
|---|---|
| Rust | 1.75+ |
| MySQL | 5.7+ / 8.0+ |
| 操作系统 | Windows / Linux / macOS |
1. 创建数据库
mysql -uroot -p -e "CREATE DATABASE IF NOT EXISTS \`easyit-service-pay\` DEFAULT CHARSET utf8mb4;"
2. 配置环境变量
复制示例配置并编辑 .env：
cp .env.example .env
主要配置项：
| 变量 | 说明 | 示例 |
|---|---|---|
CONSOLE_MYSQL_DSN | MySQL 连接串 | mysql://root:xxx@127.0.0.1:3306/easyit-service-pay?charset=utf8mb4 |
PAY_MASTER_KEY | 渠道密钥 AES 主密钥（32 字节） | 随机 32 字符 |
BASE_URL | 平台对外 URL | http://127.0.0.1:8010 |
SERVER_PORT | 服务端口 | 8010 |
3. 启动服务
cargo run
启动时会自动：
- 执行
migrations/目录下的 SQL 迁移 - 初始化管理员账号（
lichv/li123456） - 写入默认支付渠道配置
看到日志 easyit-service-pay listening on http://0.0.0.0:8010 即表示启动成功。
4. 访问各应用
| 地址 | 说明 |
|---|---|
| http://127.0.0.1:8010/ | 跳转至 Web 介绍页 |
| http://127.0.0.1:8010/web | 服务介绍与文档 |
| http://127.0.0.1:8010/admin/login | 管理后台登录 |
| http://127.0.0.1:8010/api/v1/orders | Open API（需签名） |
5. 首次验证流程
- 登录管理后台，进入 接入应用，创建一个测试应用，记录
app_id和app_secret - 进入 支付渠道，确认微信/支付宝渠道已启用（默认演示模式已开启）
- 运行 E2E 脚本验证完整流程：
bash scripts/test_e2e.sh
脚本会自动创建订单、打开收银台、模拟支付并验证回调。
常见问题
Q：中文乱码怎么办？
确保数据库、连接串均使用 utf8mb4，连接串末尾加 ?charset=utf8mb4。平台启动时会自动执行字符集修复。
Q：没有微信/支付宝商户号能测试吗？
可以。开启渠道的 演示模式 后，收银台会提供模拟支付入口，完整走通订单状态变更与回调流程。
Q：如何修改管理员密码？
登录后台 → 修改密码，或使用环境变量重新 seed（仅开发环境）。