使用指南

1系统介绍

短信分销系统（独立部署版）是一套自行部署的短信管理平台，包含用户管理、短信发送、余额计费、多级分销、通道管理、状态回执、在线升级等完整功能，对外提供 HTTP API 供业务系统调用。

系统使用 PHP + MySQL 开发，运行在您自己的服务器上，数据和通道配置完全自主，不依赖任何第三方平台，也没有年费与按量抽成。

2获取安装包

安装包里有什么

• 程序源码（PHP）与数据库结构文件
• Nginx / Apache 伪静态与安全配置
• 安装向导（浏览器访问即可安装）

3环境要求

• PHP 7.2 及以上（推荐 7.4 / 8.x）
• MySQL 5.6 及以上
• 必须扩展：PDO、PDO_MySQL、cURL、OpenSSL
• 服务器：Nginx / Apache 均可，宝塔面板、LNMP、虚拟主机都支持

如何确认环境

安装向导第一步会自动检测以上环境，全部通过才能进入下一步，不需要手动逐个验证。

4安装部署

1. 上传代码

将安装包解压后的所有文件上传到站点目录，例如 /www/wwwroot/sms.example.com。

2. 创建数据库

在宝塔面板或数据库管理工具中新建数据库，记下数据库名、用户名、密码，安装时会用到。

3. 运行安装向导

浏览器访问 http://你的域名/install/，按向导依次完成环境检测、填写数据库信息和管理员账号，即可完成安装。

4. 配置伪静态

Nginx 使用安装包自带的 nginx.conf 规则，Apache 使用 .htaccess。宝塔面板可直接在站点设置中粘贴对应规则。

5. 登录后台

访问 http://你的域名/admin/，使用安装时设置的管理员账号密码登录。

5配置上下游

短信业务的两端：上游是给你供量的短信通道商，下游是你的客户和代理。两边都接通，系统才能跑起来。

上游：对接短信通道

• 进入后台「通道管理」，点击添加上游短信通道
• 填写通道名称、API 提交地址、账号、密钥（向通道商索要）
• 可同时配置多个通道，系统按优先级自动轮询，单个通道故障自动切换
• 在「模板管理」提交短信模板，通道审核通过后即可正式发送

下游：开通用户与分销

• 系统内置用户体系，可在后台手动开通用户，或开放前台自助注册
• 为用户充值余额、设置折扣与费率，用户即可通过系统发送短信
• 开启代理分销后，可开通下级代理，下级产生的消费按比例自动分账
• 对外提供 HTTP API，客户接入只需申请 API 密钥，几分钟即可完成联调

API 使用方式

向客户提供接口文档（发送短信、查询余额、查询回执等），客户凭 API 密钥调用，不需要给他们开后台账号。

6系统设置

登录后台后，按顺序检查以下配置项：

• 基本设置：站点名称、公告、客服联系方式
• 通道管理：添加上游短信通道并设为启用
• 模板管理：提交并维护短信模板
• 用户管理：开通客户账号、调整余额与费率
• 分销设置：开启代理层级、设置分账比例
• 订单与财务：查看充值订单、财务流水
• 系统升级：配置授权后在此检查并更新版本

各模块在后台左侧菜单均可找到，首次使用建议从「通道管理」开始配置。

7购买授权

系统可免费部署体验，购买授权后即可开启在线升级与全部功能。下单时请填写正确的收货邮箱，支付成功后授权码会自动发送到该邮箱。

• 授权按域名数量与时长计费，一个授权码对应一个系统实例
• 如需绑定域名，下单时请填写系统部署使用的域名
• 授权码丢失可在发布中心后台「授权管理」中重新查看
• 免登录购买，全程不需要注册账号

前往购买

8配置授权并开启升级

收到授权码后，编辑系统根目录的 version.php，填入更新服务器地址与授权码：

// 更新源地址（版本发布中心）
define('UPGRADE_SERVER_URL', 'https://release.zljai.top/');

// 系统授权密钥
define('DL_LICENSE_KEY', 'A1B2-C3D4-E5F6-7890');

保存后，登录后台进入「系统升级」，即可检查并下载最新版本。版本发布中心地址以购买后官方提供为准。

升级包只覆盖程序文件，数据库配置、用户、订单等数据均保留。升级前建议先在后台做一次数据库备份。

9常见问题

授权码有什么作用？

授权码用于验证系统合法性与开通在线升级，一个授权码只可绑定一个系统实例。

可以绑定多个域名吗？

根据购买的方案决定，多域名方案可绑定多个域名，购买时填写即可。

授权过期了怎么办？

到期前可续费，续费后授权时间自动延长，不影响已部署的系统。

升级会影响现有数据吗？

升级包只覆盖程序文件，数据库配置、用户、订单等数据均保留，升级前建议先备份。

系统可以放几个通道？

通道数量不限，可同时接入多家上游通道，系统自动按优先级轮询与故障切换。

客户需要安装客户端吗？

不需要。客户通过后台账号或 HTTP API 使用系统，手机、电脑均可访问。