闲来潮汕互娱-潮汕房卡棋牌全套PHP源码/Workerman游戏服务端+H5网页客户端非组件/带整库与搭建教程

房卡联盟2026-09-03326 阅读
约 2,813 字 · 大约 9 分钟

文章摘要: 这是一套 2019 年前后的潮汕地方房卡棋牌源码,主打微信 H5、熟人房卡局。它没有用 Cocos、Laya 之类的游戏引擎,客户端就是 jQuery 加 CSS 手写的网页牌桌,服务端用 Workerman 一款游戏拉一个进程扛长连接,网站与后台跑在 ThinkCMF 上。本文按拿到的实际文件把三层结构、玩法清单、部署流程和二开边界梳理一遍。


一、这套源码到底是什么

先说结论:闲来潮汕互娱是一套定位在广东潮汕地区的房卡制 H5 棋牌平台,玩家全程在微信里打开,走的是熟人开房、发房卡、亲友圈那一套模式,不是金币运营站。大厅顶上那句"闲来潮汕互娱,绝无外挂。米白团队,二次开发"说明手上这份是被人二开过的流通版本。

它和市面上常见的网狐 C++ 编译组件完全是两个路子。整套三层——网站、游戏服务端、客户端——全是明文 PHP 和网页代码,没有一个编译产物,没有加壳混淆,这在棋牌源码里算是相当难得的完整交付。配套还给了整库 slcshy.sql 和一份文字版搭建教程,属于拿来能直接搭起来跑的货。

闲来潮汕互娱 大厅游戏列表一闲来潮汕互娱 大厅游戏列表二闲来潮汕互娱 三公房间加入

大厅是竖版长列表,一屏铺开潮汕三公、葫芦鱼、六到十二人牛牛、明牌金花、九人牌九、二八杠、潮汕麻将、斗地主这些卡片,点进去就是一张牌桌加一个"加入游戏 / 观战"的弹窗,顶上带房间号和防伪码。整个界面是微信内嵌网页的观感,不是原生 App。

二、三层架构与技术栈

这套源码最值得讲的是它的架构选型——在没有游戏引擎的前提下,用一整套 PHP 技术栈把实时对战棋牌做了出来。三层各司其职:

层

技术栈

作用

网站 / 后台

ThinkCMF X2.2.0(基于 ThinkPHP 3.2)

大厅页面、用户中心、房卡系统、代理、微信对接、运营后台

游戏服务端

Workerman(PHP socket 框架,PHP 5.4)

每款游戏一个独立进程,WebSocket 长连接,发牌结算全在这里

客户端

原生 HTML5 + CSS3 + jQuery + fastclick + 微信 JS-SDK

网页牌桌,DOM 渲染,无 Cocos / Laya / Egret 引擎

数据库

MySQL(utf8mb4,表前缀 jz_,38 张表)

用户、房间、房卡包、群、代理、记录、防伪码等

客户端是纯网页这点要单独强调。翻开资源目录,游戏皮肤就是 jh12.css(12 人金花)、jh6.css、339ren.css 这种 CSS 文件,脚本是 jq.js、fastclick.js、jweixin-1.2.0.js,牌面靠 DOM 加背景图拼出来。三公、牛牛、金花这类回合制纸牌不需要复杂的图形引擎,用网页做反而包体小、微信里加载快,代价是动画和表现力比引擎版朴素。

服务端用 Workerman 扛长连接是这套的核心。客户端里那句 new WebSocket("ws://"+host+":"+port) 连的就是它。打开 auto/php54n/ 目录能看到 game1 到 game49 一堆文件夹,外加 game3.php、game5.php 这些十几 KB 的逻辑文件——每一个 gameN.php 都是一段 new Worker('websocket://0.0.0.0:'.$dk),一款游戏独占一个进程、监听一个端口。数据库里 jz_server 表就是这套端口分配表:

端口

游戏

端口

游戏

9692

三公

9694

九人三公

9688

九人牛牛

9685

十人斗牛

9690

炸金花

9697

九人炸金花

9696

二八杠

9686

五兽九人牌九

这种"一游戏一进程一端口"的拓扑,好处是单款游戏崩了不影响别的桌,扩容也简单——加一款游戏就是加一个 gameN.php 再拉起一个进程。坏处是进程一多,端口管理和内存都得盯着,所以搭建教程里直接让你把服务器 1 到 60000 端口全开。

下面两张是项目根目录和游戏服务端目录的实拍,能看清三层文件是真实存在的:

闲来潮汕互娱 项目根目录结构
闲来潮汕互娱 Workerman游戏服务端目录

根目录分得很清楚:潮汕互娱前台(网站 + 游戏服务端)、潮汕互娱后台(运营后台)、数据库、搭建教程、外加一份 Nginx 伪静态.txt。服务端目录里 game1~game49 加 workerman 框架本体一目了然。

三、玩法清单

数据库 jz_game 表里登记了 48 款玩法定义,其中实际配了服务端进程、能开桌的核心玩法在十五款上下,全部是潮汕、广东一带的地方牌型。按类别归一下:

类别

玩法

三公

潮汕三公、九人三公、十二人吉祥三公

牛牛 / 斗牛

六人斗牛、九人斗牛、十人牛牛、十二人斗牛、九人斗牛八倍

炸金花

炸金花、六人金花、九人炸金花、十二人金花、明牌金花

牌九

九人牌九、五兽九人牌九

骰宝

葫芦鱼 / 鱼虾蟹(十二人五兽)

其他

二八杠(10~15 人)、斗地主、潮汕麻将

以招牌的潮汕三公为例,房间规则做得很本地化:分自由抢庄和明牌三公两种模式,底分 1 到 5 分,下注倍数有 1/2/4/5 倍、1/3/5/8 倍、2/4/6/10 倍三档,特殊牌型按"天公 X10、雷公 X7、地公 X5、暴玖 X9"翻倍,局数则是 10 局收 3 张房卡、20 局收 6 张房卡。这些参数在建房弹窗里全部可勾选,也对应着服务端结算逻辑里的倍率,二开时想调赔率直接改 gameN.php 就行。

四、服务器条件与部署

按官方搭建教程,这套跑在 Linux CentOS 7 + 宝塔面板 上,环境组合是:

  • Nginx 1.14

  • MySQL 5.6

  • PHP 7.1(网站层)+ 内置 PHP 5.4(auto/php54n,Workerman 游戏服务端专用)

  • 服务器放开 1~60000 端口(游戏进程要占大量端口)

对硬件要求不高,一台 2 核 4G 的云服务器起步就能跑测试,正式运营再按同时在线加配。整套部署对熟手来说一到两小时能搞定,流程很标准:

  1. 宝塔装好 Nginx / MySQL / PHP 环境,导入 slcshy.sql。

  2. 改两个配置文件:data/conf/db.php 填数据库账号密码;auto/php54n/config.php 填数据库信息、域名 $url 和防伪码机器服务地址(默认 127.0.0.1:5432)。

  3. 宝塔里给站点挂上 ThinkPHP 伪静态(不挂后台打不开),把伪静态规则填进去。

  4. 进 auto/ 目录执行 ./1.sh——里面就是 php server.php start -d 一条命令,一次性把所有 Workerman 游戏进程后台拉起。

  5. 前台访问 你的域名/dh,后台访问 你的域名/admin,登录后改密码。

  6. 进后台填微信公众号 AppID、AppSecret,配业务域名 / JS 安全域名 / 网页授权域名,再点一下获取 access_token。

闲来潮汕互娱 ThinkCMF前台应用目录
闲来潮汕互娱 ThinkCMF前台应用目录

网站层就是标准的 ThinkCMF 应用结构,Portal、User、Admin、Api 几个模块分得清清楚楚,房卡、代理、微信、房间这些业务逻辑都落在 Portal 模块的控制器里。因为是明文 PHP,域名、微信参数这些都能直接搜出来改。

五、房卡与运营体系

作为房卡产品,它的运营体系是围着"熟人局 + 亲友圈"转的,后台和前台都给足了配套:

闲来潮汕互娱 个人中心房卡管理闲来潮汕互娱 创建三公房间闲来潮汕互娱 发送房卡

  • 房卡系统:个人中心里有同步房卡(找回)、发送房卡、制作房卡、卡包记录,房主开房消耗房卡,对应数据库 jz_fk_bag 房卡包表。

  • 亲友圈 / 群:jz_qun 表撑起群主管理、成员、邀请函,玩家在自己的圈子里开局,是这类地方棋牌的典型玩法。

  • 代理体系:大厅底部就有"代理中心"入口,后台带独立的代理管理控制器,做分层推广。

  • 防伪码:每个房间头上那个三位数(截图里是 261)就是防伪码,配合个人中心的"防伪码设置"和后台 jz_usermachine 表,用来防第三方假客户端接入。

  • 透视 / 点控:搭建教程里明确写了"开启透视功能要在会员管理→所有会员→编辑功能到期时间",也就是说这套内置了给指定账号开牌面透视的后门,属于这类产品常见的点控手段。

这些功能都在明文代码和数据库里,改起来没有黑盒。

六、能二开到什么程度

一句话:这是三层全明文的全套源码,二开自由度很高,属于能改到骨子里的那种。

  • 换皮改品牌:大厅、皮肤是 HTML + CSS + 图片,域名、名称、微信参数都是明文配置,换品牌成本很低。

  • 改玩法与输赢逻辑:每款游戏的发牌、比牌、抢庄、结算、倍率全在对应的 gameN.php 里,是可读可改的 PHP,想调赔率、加牌型、改抽水甚至新增一款玩法,都能直接下手——这是它比编译组件值钱的地方。

  • 加游戏 / 扩容:照着现有 gameN.php 的 Workerman 模板复制一份、在 jz_game 和 jz_server 里登记新端口即可,横向扩展路径很清晰。

  • 要留意的点:技术栈偏老,ThinkCMF X2.2.0 是 ThinkPHP 3.2 时代的框架,游戏服务端还绑着 PHP 5.4,PHP 版本和依赖都停在 2019 年,新环境上跑要处理一些兼容问题;客户端是手写网页,表现力和防作弊天生比引擎版弱,正式运营前安全和风控这块得自己补。

这套最值钱的其实是"后台也没加密"这一点。之前拆过一套同底座的另一个品牌版——"H5 大联盟牛来了",架构几乎一模一样(同样的 ThinkCMF 加 auto/php54n 的 Workerman,同样的 jz_ 前缀 38 张表),玩法还更多,多出一整个拼十系列。但那套的 ThinkCMF 后台是 SourceGuardian 加密的,两百多个控制器全锁死、改不了,等于只能改游戏服务端和皮肤。手上这份闲来潮汕互娱刚好反过来——网站、后台、游戏服务端三层全明文,连运营后台的逻辑都能下手。想做同底座二开、又在乎后台能不能改的,把这两套放一起对比正合适,那篇也放在文末了,感兴趣可以去看看。

小结

闲来潮汕互娱不是那种画面华丽的大型平台,它的价值在于用一整套纯 PHP 技术栈,把潮汕地方房卡棋牌从网站、服务端到客户端完整地开源交付了出来,还配齐了整库和搭建教程。对想研究"不靠游戏引擎怎么做实时棋牌"、或者想拿一套明文源码改玩法、做地方房卡产品的人来说,这份料的可拆解程度和上手速度都很友好。技术栈老是它最明显的短板,但换个角度,简单直接、全明文、一键起服务端,恰恰也是它容易被吃透的原因。

延伸阅读1 篇

下载地址

会员免费

本资源为会员专享,登录后可下载