零基础棋牌APP搭建教程：2026新手也能快速上手的完整教学，从买服务器到手机测试一步步来

大家好，搞移动开发快十年了，前阵子写了篇棋牌搭建的教程，后台收到一堆留言，有个兄弟的话把我逗笑了。“B哥，你那个教程好是好，但我连服务器怎么买都不知道，能不能从更基础的地方开始讲？”

说实话，这句话让我想起自己刚入行那会儿，对着黑框框敲命令，心跳比第一次约会还快。今天这篇，我就把门槛放到最低——假设你对编程一窍不通，没敲过一行代码，甚至没登录过云服务器控制台。跟着这篇教程走，你能在自己手机上打开一个你自己搭的棋牌APP，这就是今天的目标。

第0步：开始之前，先把心态摆正

零基础搭棋牌APP，不是不可能，但也不是“点点鼠标就完事”。整个过程就像你从来没进过厨房，突然想做一桌年夜饭——能做出来，但需要耐心，需要照着菜谱一步一步来，中间肯定会有几步搞砸，搞砸了别急，那是正常流程。

你需要准备的东西就三样：

• 一台能上网的电脑（Windows或Mac都行）

• 一套棋牌源码（从哪搞、怎么挑，后面讲）

• 大概两天不受打扰的时间

没了。真的就这些。

第一步：先把“棋牌APP是怎么跑起来的”这个事，用大白话讲清楚

很多新手卡住，不是因为某一步多难，而是因为压根不理解这个系统是怎么运作的。我先用最简单的方式给你画个图。

一个能玩的棋牌APP，需要三样东西同时在工作：

第一样：你手机上的那个APP（叫“客户端”）。这玩意儿就像游戏机的屏幕和手柄，你点“出牌”、看对家打什么牌，都靠它。

第二样：一台24小时不关机的电脑（叫“服务器”）。这台电脑不是你家里那台，是放在阿里云或腾讯云机房里的一台。它的工作就是处理游戏逻辑——你打了一张三万，它判断你有没有这个牌、是不是轮到你出、然后把这个结果告诉另外三个玩家。没有这台电脑，你的APP打开就是一片空白。

第三样：一个存数据的地方（叫“数据库”）。谁有多少房卡、刚才那把赢了多少钱、张三的密码是什么——这些信息都存在数据库里。

所以，说“搭建棋牌APP”，翻译成大白话就是：把源码里的服务端程序，放到那台云端电脑上跑起来，再把客户端装到你手机上，让手机能连上那台云端电脑。

把上面这张图看懂了，后面每一步你在干什么，心里就有数了。

第二步：搞一台属于你自己的云服务器

你不需要跑电脑城，在网上买就行了。我用阿里云举例（腾讯云操作逻辑差不多）：

1. 打开阿里云官网，注册账号，实名认证（要身份证，几分钟过）。

2. 找到“云服务器ECS”，点“立即购买”。

3. 选配置的时候注意几点：

   • 地域：选离你最近的，比如你在广东就选“华南1（深圳）”。

   • 操作系统：选Linux，然后选CentOS 7.9。别选Windows——很多棋牌服务端在Windows上跑不了。

   • 配置：测试用选2核4G够了；真要上线用，4核8G起步。内存不够，服务跑着跑着就崩。

   • 带宽：选“按固定带宽”，5M起步。别选“按量计费”，流量费算起来吓人。

   • 系统盘：40G够用。

4. 付完钱之后，去控制台找到你这台服务器，点“重置密码”，设置root用户的密码。这个密码记好了，丢了只能重置。

5. 在控制台的“安全组”里，添加一条规则，把22端口放通。22端口就是你远程连接服务器的入口，不放通你连不上。

到这一步，你就拥有一台在云端24小时开着的电脑了。记下它的“公网IP地址”，大概长这样：47.xxx.xxx.xxx，后面会反复用到。

第三步：远程连上这台服务器，给它装上“锅碗瓢盆”

现在你的服务器是空的，就像一个毛坯房，需要给它装上能跑代码的环境。

先下载一个连接工具：Windows用户下载“Xshell”，Mac用户直接用系统自带的“终端”。

连上服务器：打开Xshell或终端，输入ssh root@你的服务器IP，然后输入你刚才设的root密码。看到一行绿色的[root@xxx ~]#，就说明你已经进入那台云端电脑了。

然后装宝塔面板——这东西相当于一个“手机桌面”，让你能用网页点点鼠标管理服务器，不用敲命令。去宝塔官网（bt.cn）复制那条安装命令，粘贴到Xshell里，回车。大概等5-10分钟装完，屏幕上会给你一个链接、一个用户名、一个密码，存好。

现在你在浏览器里打开那个链接，登录进去，你的服务器就已经有了一个可视化操作界面了。

通过宝塔安装数据库：在宝塔的“软件商店”里，一键安装MySQL（选5.7版本）和Redis。装好之后，在“数据库”菜单里新建一个数据库，名字随便取，比如叫qipai，用户名和密码都记好。

到这一步，你的“毛坯房”已经通水通电了。

第四步：把棋牌源码传到服务器上，改几个关键配置

你需要有一套源码。如果手头没有，去Gitee上搜“棋牌”、“麻将”，有一些开源的练手版本可以拿来学习用。注意，开源版功能不全、安全性基本为零，只能用来跑通流程，不能拿去运营。

拿到源码后，在你的电脑上先解压，你会看到几个文件夹，名字大概类似server（服务端）、client（客户端）、admin（后台管理）、sql（数据库脚本）。不同源码叫法不同，但基本是这几类。

先导入数据库：在宝塔的“数据库”页面里，用phpMyAdmin打开你建的qipai数据库，点“导入”，把源码里那个.sql文件传上去执行。这一步是把游戏需要的表结构和初始数据都建好。

然后改服务端配置文件：在server文件夹里，找到一个叫application.yml或config.properties的文件（常见的名字），用记事本或VS Code打开。你需要改的东西就这几样：

• 数据库地址：改成127.0.0.1:3306（因为数据库和游戏在同一台服务器上，用本地地址就行）

• 数据库用户名和密码：改成你刚才在宝塔建的那个

• Redis地址：改成127.0.0.1:6379

• 服务器外网IP：有几处要填，都改成你服务器的公网IP

其他地方，不懂的别乱动。 很多新手就是手痒改了一堆看不懂的配置，结果怎么死的都不知道。

上传服务端到服务器：用宝塔的“文件”功能，在/home/下新建一个文件夹叫game，把整个server文件夹里的东西拖进去。或者在宝塔里直接上传压缩包再解压。

第一次启动服务端：用宝塔的“终端”功能，进入/home/game/目录，执行java -jar xxx.jar（xxx是你源码里那个jar包的名字）。如果用的是Go源码，就执行./xxx。然后看屏幕上的输出——如果有红色的报错，截图下来去问源码卖家或者搜索引擎；如果没有报错且一直跑着不退出，恭喜，服务端起来了。

第五步：把客户端弄到手机上，看到APP界面

这一步是让你真正有成就感的一步。

先改客户端里的服务器地址：在源码的客户端文件夹里，你需要找到一个配置IP的地方。不同的源码位置不同，常见的有：

• assets/config/下的某个json或xml文件

• res/values/strings.xml里的一个叫server_url或base_url的字段

• 项目根目录的config.js或app-config.json

找到之后，把里面的IP改成http://你的服务器公网IP:端口号。端口号去服务端配置文件里找，一般是8080或9000之类。

用Android Studio打包安卓APP：

1. 去Android Studio官网下载安装，一路下一步。

2. 打开Android Studio，选“Open an existing project”，找到你源码里的安卓客户端文件夹，打开。

3. 等它自动下载依赖，这个过程第一次比较慢，需要联网下载一堆东西，去泡杯茶。

4. 在顶部菜单选 Build → Build Bundle(s)/APK(s) → Build APK(s)，等编译完成。

5. 右下角会弹出一个提示，点“Locate”打开APK所在文件夹，把这个APK文件用微信或QQ传到你的安卓手机上。

6. 在手机上打开APK，允许“安装未知来源应用”，装好之后，点开APP——如果能看到登录界面或大厅界面，说明你已经成功了一大半。

真机测试要完整跑一遍：打开APP之后，别光看个主界面就完了。有登录功能的，试着注册一个账号；有创建房间功能的，试着开个房间；如果能让另一个手机也装上，两个手机进同一个房间，那就证明你的服务端和客户端已经完整跑通了。

到这里，“零基础搭建”的任务就算完成了。你已经亲手把服务端部署到云端，把APP装到了手机上，并且成功连上了。

写在最后：跑通之后，你需要知道的事

这篇教程的目标，是让零基础的你能把一套棋牌源码跑起来，在自己手机上看到效果。我假设你在这个过程中会遇到各种报错——这是正常的，每个老手都是这么过来的。报错的时候，先看报错信息里写了什么，大部分时候它会明确告诉你“哪个文件、哪一行、出了什么问题”，对着去改就行。

但我也必须说清楚：能跑通和能上线运营，中间隔着十万八千里。 你搭的这一套，目前安全防护基本为零、没有支付资质、没有版号、可能连后台管理都是残废的。如果只是自己玩玩、朋友之间娱乐，跑通就可以了。如果有任何商业化运营的想法，安全、合规、资质，每一条都绕不开。

如果你手里的源码跑不通，或者想找一套能直接上线运营的成熟棋牌系统，又或者在部署过程中卡住了，欢迎来聊聊。我们团队做棋牌搭建快十年了，市面主流品牌都经手过，从服务器选配到源码部署、从安全加固到上架指导，可以提供全程技术支持。

扫描下方二维码，或添加微信。（备注“源码搭建”，优先通过）