介绍：

已在微擎 2.x / PHP 7.2 环境亲测，10 分钟可上线。

一、准备

1. 服务器：CentOS 7+/Ubuntu 18+，Nginx+PHP7.2+MySQL5.7
2. 域名已备案并解析到服务器
3. 安装好微擎框架（宝塔一键安装即可）

二、上传与导入

1. 将源码包上传至 /www/wwwroot/你的域名/ 并解压
2. 宝塔 → 数据库 → 导入 install.sql
3. 修改 /data/config.php 里的数据库信息（主机、用户名、密码、库名）

三、后台登录
浏览器访问 http://你的域名/web
账号：admin
密码：qq123456

四、必改 3 处域名

1. 微擎文件
   /framework/class/account/weixin.account.class.php
   第 3251 行与 3259 行
   把 api.iiiuwu.com 替换为你的域名，如 open.你的域名.com
2. 公众号回调
   微擎后台 → 平台入口 → 公众号设置 → 基础信息
   填写：
   • AppID
   • AppSecret
   • 服务器地址：http://你的域名/api.php（自动生成，确认无误即可）
3. 导航链接
   微擎后台 → 应用入口 → 基本设置 → 导航管理
   把 5 个导航里的域名全部改成 http(s)://你的域名

五、支付与存储

1. 支付参数
   微擎后台 → 平台入口 → 支付参数
   依次配置：微信、支付宝、银联、服务商支付（按向导填商户号、密钥、证书）
2. 外部存储
   微擎后台 → 全局 → 附件设置
   可选阿里云OSS、腾讯云COS、七牛云，填写对应 bucket、AK/SK、域名

六、前端入口
微擎后台 → 应用入口 → 封面链接入口 → 生成/更新二维码
扫码或复制链接即可访问 H5 端。

七、暗黑模式（可选）
前端 static/css/dark.css 已内置，手动在 index.html 里把 <link rel="stylesheet" href="dark.css"> 取消注释即可。

常见问题

• 空白页：检查 PHP 是否开启 fileinfo / redis 扩展
• 支付回调失败：确认域名可外网访问，443 端口已放行
• 上传大文件：宝塔 → PHP → 配置修改 → upload_max_filesize 调大

演示图：