美盛API Windows 搭建教程

本页介绍如何在 Windows 服务器上部署美盛（MSAPI）包网系统，并完成基础 API 对接。完整视频教程见下方，也可返回首页搭建区块观看。

一、环境要求

  • Windows Server 2016 及以上，或 Windows 10/11 开发/测试环境
  • Web 服务：IIS / Nginx / Apache（推荐宝塔 Windows 面板统一管理站点、PHP、MySQL、Redis）
  • PHP 7.4+（建议 7.4 或 8.0，按程序包说明启用扩展：curl、openssl、redis、fileinfo 等）
  • MySQL 5.7+ 或 MariaDB 10.3+
  • Redis（用于缓存、会话或队列，按包网程序说明配置）
  • 可用域名 + SSL 证书（生产环境务必 HTTPS）
  • 服务器开放 80 / 443 端口；若使用宝塔，按面板提示放行防火墙

二、宝塔面板安装与环境

  1. 在 Windows 服务器安装 宝塔 Windows 面板，登录面板后台。
  2. 在「软件商店」安装：Nginx（或 IIS）、MySQL、PHP、Redis。
  3. PHP 设置中启用程序所需扩展，并将 upload_max_filesize、post_max_size 调整为适合程序包上传的大小（如 50M 以上）。
  4. 「网站」→「添加站点」：填写域名，根目录指向即将解压的包网程序目录，并申请/绑定 SSL。

三、上传程序与目录权限

  1. 将美盛 ley美盛包网 / 星汇包网程序包上传至站点根目录（可用宝塔文件管理或 FTP）。
  2. 解压后确认存在前台入口、总后台、代理后台等目录（具体以程序包说明为准）。
  3. 将 runtime、upload、cache 等需写入目录设置为可写（IIS 用户或 Everyone 写入，按面板提示操作）。
  4. 若使用伪静态，在站点设置中导入程序附带的 Nginx/IIS 重写规则。

四、数据库创建与导入

  1. 宝塔「数据库」→ 新建数据库与用户，记录库名、用户名、密码。
  2. 使用 phpMyAdmin 或命令行导入程序包内的 .sql 初始化文件。
  3. 编辑程序配置文件（常见为 .env 或 config/database.php），填入数据库连接、Redis 地址、站点 URL（含 https://）。
  4. 保存后访问安装/初始化地址（若有），按向导完成基础配置。

五、美盛 API 对接

  1. 在总后台找到「API 配置 / 游戏接口 / 商户对接」等菜单（名称因模板而异）。
  2. 填入美盛官方提供的 API 网关地址、商户号、API 密钥（正式环境向 @MsGameApi 申请）。
  3. 在商户后台配置 服务器 IP 白名单（演示站请勿使用生产密钥）。
  4. 选择钱包模式：单一钱包（实时回调）或 转账钱包，详见 钱包模式说明。
  5. 按 接口文档 完成会员登录、余额、游戏 launch、回调 URL 联调。

六、功能测试与上线

  1. 使用演示账号 admin / xh123456 登录前台与总后台（仅演示环境）。
  2. 逐项测试：注册登录、充值演示、进入真人/体育/电子游戏、注单查询、代理后台。
  3. 检查回调日志与 API 返回码，确认无签名错误或 IP 限制。
  4. 测试通过后切换正式商户配置，并备份数据库与配置文件。

视频教程

以下为官方演示站提供的 Windows 搭建录屏，建议全屏观看：

常见问题

安装后页面 500 或空白？

检查 PHP 版本与扩展、数据库连接是否正确、runtime 目录是否可写；查看站点错误日志（宝塔 → 网站 → 日志）。

游戏无法进入或提示 API 错误？

确认商户号、密钥、网关地址无误；服务器 IP 已加入白名单；回调地址为 HTTPS 且外网可访问。参考 接口文档 与 FAQ。

演示站与正式环境有何区别？

msgameapi.com 及各 xhbwapi.com 子域为官方演示，线路与额度仅供预览。正式运营需联系官方开通独立商户与生产 API。

重要提醒

演示站（msgameapi.com 及各 xhbwapi.com 子站）仅用于功能展示，请勿填入真实商户密钥或生产环境数据。正式对接请联系美盛官方 Telegram 客服，API 文档：doc.msgameapi.com/home。