5分钟快速部署

程序安装教程

按照以下步骤操作，即可完成自动发卡网程序的部署

1环境要求 2上传文件 3创建数据库 4修改配置 5导入数据 6授权激活 7后台配置 8支付配置 常见问题
1
环境要求
确保服务器满足运行条件

请确保您的服务器满足以下环境要求：

组件最低版本推荐版本说明
PHP7.48.0 / 8.1需开启 PDO、cURL、OpenSSL 扩展
MySQL5.65.7 / 8.0字符集建议 utf8mb4
Web服务器Apache 2.4 / Nginx 1.18最新稳定版需支持伪静态
推荐使用宝塔面板部署，一键安装 LNMP 环境，操作简单方便。
2
上传程序文件
将源码上传到网站根目录
  • 解压下载的程序压缩包
  • 将所有文件上传到网站根目录（如 /www/wwwroot/你的域名/）
  • 宝塔面板用户：文件管理 → 进入根目录 → 上传压缩包 → 右键解压
  • FTP用户：使用 FileZilla 等工具连接服务器上传
解压后请确认 config.php、index.php、admin/、api/ 等文件都在根目录下。
gen_license.php 是作者专用的授权码生成工具，不要上传到客户服务器，用完请删除。
3
创建数据库
新建 MySQL 数据库和用户

宝塔面板操作：

  • 进入宝塔面板 → 数据库 → 添加数据库
  • 填写数据库名、用户名、密码（请记录好，后续配置需要）
  • 字符集选择 utf8mb4
  • 权限设置为"所有权限"
  • 点击提交完成创建
// 建议命名规范
数据库名：shop_card
用户名：shop_card
密码：自定义强密码
4
修改数据库配置
编辑 config.php 填入数据库信息

打开网站根目录下的 config.php，修改最顶部的数据库配置：

// ====== 数据库配置 ======
$db_host = '127.0.0.1'; // 数据库地址，一般不用改
$db_user = 'shop_card'; // 改成你的数据库用户名
$db_pwd = '你的密码'; // 改成你的数据库密码
$db_name = 'shop_card'; // 改成你的数据库名
配置文件编码必须是 UTF-8 无 BOM，否则可能导致页面空白或 500 错误。
5
导入数据库
将 install.sql 导入到数据库中

方法一：phpMyAdmin 导入（推荐）

  • 宝塔面板 → 数据库 → 找到对应数据库 → 点击"管理"
  • 进入 phpMyAdmin，选择你的数据库
  • 点击顶部"导入"选项卡
  • 选择程序包中的 install.sql 文件
  • 点击"执行"，等待导入完成

方法二：命令行导入

mysql -u用户名 -p 数据库名 < install.sql
导入成功后，数据库中会出现 admin、goods、orders、pay_channel 等数据表。
6
程序授权激活
输入授权码激活程序
  • 浏览器打开你的网站域名
  • 首次访问会自动跳转到授权激活页面
  • 页面会显示当前授权域名，请确认是否正确
  • 输入作者提供的 64位授权码
  • 点击"立即激活"，验证通过后自动进入网站
授权码绑定域名，xxx.com 和 www.xxx.com 共用同一个授权码。其他二级域名需要单独授权。
如果提示"授权码不正确"，请检查域名是否一致，授权码是否复制完整（64位，不要有多余空格）。
本地开发环境（127.0.0.1 / localhost）自动免授权，无需输入授权码。
7
登录后台配置
进入管理后台进行基础设置

访问后台地址：https://你的域名/admin/

// 默认登录账号
账号：admin
密码：admin123

登录后请完成以下设置：

  • 修改密码：立即修改默认管理员密码
  • 站点设置：填写店铺名称、LOGO、公告、客服QQ等
  • 商品管理：添加商品，导入卡密
  • 订单管理：查看订单记录，手动发货
务必修改默认管理员密码！使用弱密码可能导致后台被暴力破解。
8
配置支付接口
对接易支付实现自动收款

在后台 → 支付通道中添加易支付配置：

  • 接口地址：易支付平台的 API 地址（如 https://pay.xxx.com/）
  • 商户ID（PID）：易支付平台分配的商户号
  • 商户密钥（Key）：易支付平台分配的密钥
  • 支付方式：alipay（支付宝）/ wxpay（微信）/ qqpay（QQ）
易支付后台回调地址配置：
异步通知地址：https://你的域名/api/pay_callback.php
同步跳转地址：https://你的域名/search.php
配置完成后，下单支付测试一笔，确认回调正常、卡密自动发放，即部署完成。
常见问题
安装和使用过程中的常见问题排查
网站打开显示 HTTP 500 错误？
检查 config.php 数据库配置是否正确，数据库服务是否启动，PHP版本是否满足要求（7.4+）。可查看服务器错误日志获取详细信息。
支付成功但卡密没自动发放？
检查易支付后台的异步通知地址是否正确，服务器是否能被外网访问，防火墙/安全组是否拦截了回调请求。可在易支付后台查看回调日志。
提示授权码不正确？
确认授权域名和实际访问域名一致，www 前缀会自动去除，其他二级域名需单独授权。授权码为64位，请确保复制完整，没有多余空格。
后台登录提示 CSRF 校验失败？
清除浏览器缓存和 Cookie 后重试，或检查服务器 session 配置是否正常，session.save_path 目录是否有写入权限。
图片/Logo 不显示？
检查 uploads/ 目录是否有写入权限，文件是否上传成功，路径是否正确。Nginx 用户需检查静态文件配置。
如何更换域名？
更换域名后需要重新生成授权码。联系作者提供新域名，获取新的64位授权码，在授权页面重新激活即可。