开发文档

一、环境要求

• Linux 服务器（x86_64，推荐 Debian/Ubuntu 或宝塔环境）；
• SQLite 无需额外安装（程序自带，数据就是 db/dujiao.db 一个文件）；Redis 可选（建议开，缓存/队列更稳）；
• Nginx（反代 + 两个域名）；域名 + HTTPS 证书。

二、安装步骤

1. 新建目录（如 /www/wwwroot/dujiao-next），把程序文件上传进去：二进制 dujiao-next、config.yml、空的 db/、uploads/、logs/；
2. 给二进制可执行权限：chmod +x dujiao-next；
3. 编辑 config.yml：server 段（监听地址/端口，默认 127.0.0.1:8090）、database 段（SQLite 文件路径）、jwt/user_jwt（改成随机密钥）、redis（如启用）、upload（上传目录）；
4. 首次启动：./dujiao-next —— 程序会自动建库建表并初始化；
5. 用 systemd 托管（新建 dujiao-next.service，WorkingDirectory 指向程序目录，ExecStart 指向二进制），systemctl enable --now dujiao-next；
6. Nginx 配两个域名：前台（如 dujiao-net.你的域名）与 后台（如 dujiao-admin.你的域名），都反代到 127.0.0.1:8090；
7. 浏览器打开后台域名 → 用初始管理员登录：账号密码就在 config.yml 的 bootstrap 段（default_admin_username / default_admin_password，程序首次启动时写入），登录后第一件事改密码。

三、安装后必做

• 支付渠道：后台「支付渠道」逐个配置，每个渠道的 notify_url（异步）与 return_url（同步）必填且必须是外网可访问地址，否则回调不到、订单不发货；
• 商品与卡密：先建商品/规格，再批量导入卡密（有卡密池与批次表）；
• 邮件：SMTP 填好，否则验证码/通知发不出；
• 备份：定期打包 db/dujiao.db + config.yml + uploads/（SQLite 建议先停服或使用 sqlite3 .backup 再拷）；
• 代理/分销（如启用）：配置 reseller/affiliate 相关开关与结算参数。

四、常见问题

• 启动即退出：config.yml 格式错误（YAML 缩进）或端口被占用；
• 后台打不开：后台域名的 Nginx 没指到后台 SPA 入口，或程序未启动（systemctl status dujiao-next）；
• 下单后不发货：支付回调没通（渠道的 notify_url 没填对外地址 / 被防火墙拦）；查看订单的支付流水与回调日志；
• 数据丢了：SQLite 是单文件，务必把 db/ 纳入日常备份，别只备份程序。

五、升级

停服 → 备份 db/ 与 config.yml → 替换二进制 → 启动（程序启动时自动执行数据库迁移）。