WePoker微扑克德州扑克全端源码部署教程与二开分析

一、项目概述

WePoker（微扑克）是一套仿 WePoker 官方的德州扑克全端源码，涵盖游戏服务端、运营后台、代理后台、客服系统、资源热更站及 Unity 客户端，具备完整的俱乐部私局、公共大厅、代理返佣、充值兑换等业务闭环。

以德州扑克为核心，同时集成短牌、奥马哈、SNG 锦标赛及多款休闲小游戏（捕鱼、21 点、体育竞猜等），支持俱乐部/好友局社交玩法。客户端品牌化启动页与 WePoker 官方高度一致，支持中文/英文/越南语三种语言，采用海底主题牌桌，视觉效果精致。

二、前端效果展示

启动页 / 大厅主页 / 好友局

从左到右依次为：品牌化启动界面（WePoker Logo + 代言人 + 热更进度条，v5.03.2）；大厅主页（钻石/金币余额、广告轮播、房间列表，支持按游戏类型和盲注级别筛选）；好友局俱乐部（支持创建/加入俱乐部，开设德州局、短牌局、奥马哈局、SNG 四种房型，密码快速入局）。

小游戏大厅 / 牌桌界面

左图为小游戏大厅，集成了德州牛仔、扑克大师、老虎机、体育竞猜、捕鱼王、百人德州、21 点、加勒比德州、太空人等多款休闲游戏。右图为海底珊瑚主题的德州扑克牌桌，6 人座位布局，顶部显示 JP 奖池与牌局计时器，支持语音互动和表情等社交功能。

三、技术架构总览

整套系统由 8 个组件构成，核心链路如下：

                      +------------------+
                      |   Unity 客户端    |
                      | (团结引擎 2022.3) |
                      +--------+---------+
                               |
                 TCP:16666 / WS:9999
                               |
+------------+   HTTP   +------+--------+   MySQL 8.0
| Nginx 反代  +--------->  游戏服务端     +-----------> texaspokertest
| (80/443)   |  :8080   | Spring Boot   |              (69 张表)
+-----+------+          | + Netty       |
      |                  +---------------+
      |
      +---> 运营后台 (admin)  -- 同一 jar，Beetl 模板
      +---> 代理后台 (agent)  -- Vue3 静态站，仅编译产物
      +---> 客服系统 (chat)   -- ThinkPHP 5 + Workerman
      +---> 资源站   (a)      -- 静态 + PHP，热更包/APK/配置

各组件的技术栈与端口分配：

数据库共 69 张核心表，按业务可分为以下几大模块：

• 用户与权限 -- game_user、sys_user、sys_role、sys_menu 等，RBAC 权限体系

• 俱乐部 -- club、club_members、club_join_apply、club_level_config 等 7 张表

• 牌局记录 -- round、round_log、game_log、game_log_details 等，每手牌完整流水

• 经济系统 -- coin_change_log、diamond_convert_coin、recharge_diamond_log、usdt_change_log 等

• 代理系统 -- sys_agent、agent_award_log、commission

• 运营配置 -- global_config、announcement、broadcast、sys_swiper、version 等

四、服务器系统要求

硬件配置

内存 8G 是硬下限 -- JVM 占 2-4G、MySQL 占 2G、PHP/Workerman 占 1G、系统/宝塔占 1G，4G 内存跑不动全套。带宽建议 10 Mbps 以上（客户端需下载几百 MB 的 APK 和热更包）。

操作系统与节点

推荐 Ubuntu 20.04 LTS（首选）或 CentOS 7.9（次选）。不要选 Ubuntu 22.04+、Debian 12 等系统，因为 openssl 3.0 下宝塔编译 PHP 7.3 容易失败。

节点建议选香港/新加坡/日本（免备案，对国内延迟 30-60ms）。国内大陆节点需域名备案。架构必须选 x86_64，不要 ARM。

软件环境

• JDK 1.8（必须，高版本启动报错）

• Maven 3.6+（建议配阿里云镜像加速）

• MySQL 8.0.x（需关闭 ONLY_FULL_GROUP_BY，时区设 Asia/Shanghai）

• Nginx 1.20+（反代游戏服 + 托管 4 个静态站）

• PHP 7.4 + 7.3 双版本（7.4 给资源站，7.3 给客服，客服需 pcntl/posix 扩展）

• 宝塔面板（统一管理，与原线上环境一致）

防火墙端口

五、部署步骤教程

预计耗时

整体部署约 1-2 天（含客户端出包）。如果已有可用 APK 不需要重新打包客户端，服务端半天内可完成。

步骤 1：环境安装

# 安装宝塔面板
wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh ed8484bec

# 宝塔面板中安装 Nginx 1.20+、MySQL 8.0、PHP 7.3、PHP 7.4

# 手动安装 JDK 8 和 Maven
sudo apt install openjdk-8-jdk maven -y
java -version  # 确认输出 1.8

步骤 2：数据库初始化

mysql -uroot -p

CREATE DATABASE texaspokertest DEFAULT CHARSET utf8mb4;
CREATE DATABASE kefu2024 DEFAULT CHARSET utf8mb4;

# 导入 SQL
mysql -uroot -p texaspokertest < sql/texaspokertest-new.sql
mysql -uroot -p kefu2024 < sql/kefu2024.sql

# 关闭 ONLY_FULL_GROUP_BY（Guns 框架需要）
SET GLOBAL sql_mode = 'STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION';

步骤 3：域名解析

需要 4 个子域名，全部 A 记录指向服务器 IP：

建议直接申请 *.域名.com 泛域名证书。WSS(9999 端口) 额外需要 JKS 格式证书，用 keytool 从 pem 转换。

步骤 4：服务端配置与编译

修改 texasPoker/src/main/resources/application.yml：

# 数据库连接（三个 profile 都要改）
url: jdbc:mysql://127.0.0.1:3306/texaspokertest
username: <新账号>
password: <新密码>

# 文件上传路径（改为 Linux 路径）
guns:
  file-upload-path: /home/upLoadFile

设置环境变量并编译启动：

export GUNS_JWT_SECRET=<64位随机串>
export GUNS_AGENT_JWT_SECRET=<64位随机串>
export GUNS_SHIRO_REMEMBER_ME_SECRET=<随机串>

cd texasPoker
mvn clean package -P test -DskipTests
java -jar target/texasPoker.jar

日志出现"服务器启动成功"，确认 8080/16666/9999 三端口 LISTEN 即可。

步骤 5：Nginx 反代配置

server {
    listen 443 ssl;
    server_name admin.域名.com;

    ssl_certificate     /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

步骤 6：客服系统部署

修改 config/database.php 中数据库配置指向 kefu2024，修改 service/config.php 中域名为新地址。PHP 7.3 需解除 putenv、pcntl_* 的禁用函数限制，然后执行 bash init.sh 设置 crontab 守护 workerman。

步骤 7：代理后台部署

代理后台没有前端源码，只有编译产物，需要批量替换 JS 中硬编码的旧域名：

grep -rl "admin.ttp8088.xyz" assets/ | xargs sed -i "s|admin.ttp8088.xyz|admin.域名.com|g"

步骤 8：客户端出包（可选）

安装团结引擎 2022.3.17f1c1（版本必须精确一致），修改 Assets/StreamingAssets/app_android.json 中的服务器 IP 和资源站地址，然后打包 APK。

注意：原始签名 keystore 已丢失，需新建签名，出包后无法覆盖安装老版本。

六、二次开发评估

二开可行性总览

二开程度分析

服务端（可深度二开） -- 源码完整，包结构清晰（core 核心逻辑、netty 网络层、aomaha 奥马哈、shortCard 短牌、api 接口层）。基于 Guns 4.0 快速开发框架，有代码生成器，新增功能开发效率高。游戏逻辑在 Java 层完整实现，经济系统、代理返佣、俱乐部体系均可定制。

客户端（可中度二开） -- Unity 工程源码完整，C# 脚本可修改。采用 HybridCLR 热更新方案，部分逻辑可热更而无需重新出包；YooAsset 资源管理，美术资源可替换。限制在于需要团结引擎精确版本，且签名 keystore 丢失需新建。

无法二开的部分 -- 代理后台前端仅有 webpack 编译产物，JS 已 hash 化压缩，只能替换字符串或完全重写。

七、核心功能清单

游戏玩法

• 德州扑克 -- 大厅公共桌（按盲注分微/小/中/大级别）、好友私局

• 短牌（Short Deck） -- 36 张牌玩法，独立牌型大小规则

• 奥马哈 -- 四张底牌玩法

• SNG / Spins -- 锦标赛模式、快速赛

• 必下 / 菠萝蜜 -- 特殊德扑变体玩法

• 休闲小游戏 -- 德州牛仔、扑克大师、老虎机、体育竞猜、捕鱼王、百人德州、21 点、加勒比德州、太空人

社交与俱乐部

• 创建/加入俱乐部，俱乐部等级与成员管理

• 好友系统，好友局快速入桌

• 密码入局，快速进入指定牌局

• 牌桌内礼物、语音互动、表情包

• 站内消息系统

经济与运营

• 双币体系 -- 钻石（充值货币）+ 金币（游戏货币），可互相兑换

• USDT 通道 -- 支持 USDT 充值/兑换

• 代理系统 -- 多级代理、返佣机制、独立代理后台

• JP 奖池 -- Jackpot 累积奖池

• 保险 / 猜牌 -- 德州保险买卖、猜牌玩法

• 游戏控制 -- 控牌、固定牌功能

运营管理

• 运营后台（用户管理、牌局回放、数据统计、充值记录）

• 公告/广播、轮播图管理、弹窗管理

• 版本管理（客户端版本号控制与强更）

• 独立在线客服（WebSocket 实时通讯）

• 多语言支持（中文/英文/越南语）

• 玩家生涯数据（战绩、牌谱、数据统计面板）

八、已知风险与注意事项

高风险：

• SQL 备份（2024-07）与代码最后改动（2026-06）存在时间差，数据库结构可能与代码不匹配，启动后需检查缺失字段

• 客户端签名 keystore 丢失，新建签名出包后无法覆盖安装老版本

中风险：

• 代理后台没有前端源码，只能字符串替换域名先用，后续建议 Vue3 重写

• 源码内含多处明文密码，正式环境必须全部更换

• 出客户端包需安装团结引擎 2022.3.17f1c1 精确版本

• 存在两份服务端代码，以 texasPoker/ 为准

低风险：

• newdezou2024.rar（1.1GB）未解压，可能是更新版客户端，建议解压对比

• 落地页（sdad）是空壳站，可不部署

九、项目文件结构

wpk/
  +-- WePoker微扑克/
  |     +-- texasPoker/          # 游戏服务端 Java 源码
  |     +-- newdezou2022/        # Unity 客户端工程
  |     +-- sql/                 # 数据库 SQL 文件
  |     +-- 备份/                 # 线上站点备份包
  |     +-- newdezou2024.rar     # 新版客户端（未解压）
  +-- kefu/                      # 客服系统 ThinkPHP 源码
  +-- 部署配置清单.md              # 详细部署文档

十、总结