斗战胜佛H5棋牌房卡源码部署教程与二开分析

一、项目概述

「斗战胜佛」是一套西游记主题的 H5 棋牌房卡平台源码，面向移动端浏览器和微信内置浏览器运行。以俱乐部房卡制为核心玩法，集成牛牛、炸金花、三公、牌九、二八杠、麻将、斗地主、十三水等 10 余款游戏，支持微信授权登录和 USDT 充值。

二、前端效果展示

登录页面

导航站首页  |  游戏大厅（牛牛系列）  |  游戏选择列表

三、技术架构

系统采用三站分离架构，主程序处理业务逻辑，导航站承载游戏大厅 H5 界面，资源站提供静态资源 CDN。

导航站(H5大厅:8080) ─ WS:5510 ─▶ GatewayWorker 游戏服务 ─▶ MySQL + Redis
                          │
主程序(:80) ─▶ ThinkPHP 6 后台/API ─▶ MySQL(33表)
                          │
资源站(:1888) ─▶ Nginx 纯静态(JS/CSS/图片)

四、服务器要求

• 系统： Ubuntu 20.04 / CentOS 7+，推荐宝塔面板或 Docker

• 配置： 2 核 4G 起步，推荐 4 核 8G

• 软件： PHP 7.3 + Swoole 4 + Swoole Loader + MySQL 5.6 + Redis 5 + Nginx 1.20

• 域名： 3 个子域（主程序 / 导航站 / 资源站），或纯 IP 部署

• 端口： 80（主程序）、8080（导航站）、1888（资源站）、5510（游戏 WebSocket）

• PHP 扩展： pcntl、posix、redis、swoole、fileinfo、gd、sockets

• 节点： 香港/新加坡推荐（免备案 + 微信端可用）

五、部署步骤

提供两种部署方式，Docker 方式约 30 分钟，宝塔手动方式约 2~3 小时。

Docker Compose 方式（推荐）：

1. 安装 Docker + Docker Compose： 服务器装好 Docker 环境

2. 上传部署包： 将 deploy/ 目录上传至 /opt/dzsf/deploy

3. 配置环境变量： 创建 .env 文件设置 MySQL root 密码

4. 启动容器： docker compose up -d --build，首次启动自动导入数据库

5. 验收： 访问 /admins 后台登录（admin / 123456），访问 :8080/dh.html 导航站

宝塔手动方式：

1. 装环境： Nginx 1.20 + PHP 7.3 + MySQL 5.6，安装 Swoole Loader 扩展，解除 pcntl/posix 函数禁用

2. 三个站点： 主程序（PHP 7.3）、导航站（纯静态）、资源站（纯静态，端口 1888）

3. 导入数据库 + 改配置： .env 和 yy/database.txt 中修改数据库连接

4. 导航站全局替换： js/config.js 改主程序地址，全局搜索替换资源站 IP 和端口

5. 后台配置导航域名： 登录后台，在导航菜单将桶名称/标签/自定义信息改为导航站域名各段

6. 启动游戏服务： 进入 yy/ 目录执行 ./start 开启 Workerman 游戏进程

六、二次开发评估

核心限制： 后端 PHP 文件（控制器 + 游戏逻辑）全部经过 Swoole Loader（SG11/SG14）加密，运行时需加载 swoole_loader73.so 扩展解密执行。无法阅读、修改或调试后端业务代码，二开仅限于前端 UI 换皮、资源替换、数据库层面配置调整。

七、核心功能

• 棋牌游戏： 牛牛（6/10/13/17/19/21/23人）、炸金花、大牌炸金花、三公、牌九、二八杠、斗地主、麻将、十三水、大小点、鱼虾蟹

• 房卡制： 创建房间消耗房卡，支持多人数/多局数配置

• 俱乐部系统： 创建/加入俱乐部、成员管理、俱乐部内建房

• 微信登录： 公众号 OAuth 授权、微信内嵌 H5 运行

• 运营后台： 用户管理、房卡充值、游戏记录、导航配置、COS 资源地址

• 代理体系： 联盟/代理层级、佣金分成、代理报表

• 安全机制： 巡查系统、白名单管理、IP 监控

• 聊天系统： 房间内实时聊天

八、注意事项

• 后端 PHP 全加密，锁死 PHP 7.3，升级版本将无法运行

• 纯 IP 部署可用但微信 OAuth 登录要求绑定域名

• 导航站和资源站有大量硬编码 IP/域名，换域名需全局批量替换

• 数据库 SQL 备份与代码版本可能有时间差，首次启动需检查字段兼容性

• Docker 方式游戏 WebSocket 端口 5510 映射在 MySQL 容器上（设计如此，共享 network）

九、总结

一套游戏种类丰富的 H5 棋牌房卡平台，西游记主题美术风格鲜明，Docker Compose 部署方案成熟，30 分钟可启动完整环境。但后端 PHP 代码全部 Swoole Loader 加密，二开空间仅限前端换皮和数据库配置，无法修改游戏逻辑和后台功能。适合有运营需求、不需要深度定制后端的团队直接部署使用。