情怀源码零基础搭建全指南 从环境准备到上线全流程避坑攻略

很多新手想要入局棋牌游戏行业，拿到心仪的情怀源码后，却被搭建部署的环节难住了 —— 不知道该选什么配置的服务器、不清楚环境该怎么配置、经常遇到服务启动报错、数据库连接失败等问题，甚至一不小心就踩坑，导致部署失败，浪费大量的时间和精力。

这篇情怀源码零基础搭建全指南，结合了上千次源码部署的实操经验，从服务器选型、环境准备、源码配置、服务端部署、功能测试到正式上线，全流程一步步详解，同时整理了新手搭建过程中必踩的 10 个坑和对应的避坑方案，即使是完全没有代码基础的新手，也能跟着教程，顺利完成情怀源码的搭建部署，成功上线运行。

一、搭建前的准备工作：选对配置，少走弯路

搭建情怀源码的第一步，是做好前期准备工作，很多新手搭建失败，都是因为前期准备不到位，比如服务器配置不够、环境版本不兼容，导致后续出现各种问题。做好以下三项准备工作，能规避 80% 的搭建问题。

1. 服务器选型与配置推荐

情怀源码的搭建，必须选用独立的服务器，不能使用虚拟主机，服务器的配置直接影响游戏的运行稳定性和并发能力，针对不同的使用场景，推荐对应的服务器配置，新手可直接对照选择：

新手避坑提示：

· 系统优先选择 CentOS 7.6 64 位版本，这是目前适配性最好、最稳定的服务器系统，几乎所有的情怀源码都能完美适配，避免使用高版本的 CentOS 8/9，容易出现环境兼容性问题。

· 带宽优先选择 BGP 多线带宽，保障电信、联通、移动不同网络的用户都能流畅访问，避免使用单线带宽，导致部分地区用户访问延迟高、卡顿。

· 服务器必须开启端口映射，放行所需的端口，很多新手服务启动成功，却无法访问，都是因为端口没有放行，这是最常见的坑。

2. 域名与备案准备

如果是商用运营，必须提前注册域名，并完成工信部 ICP 备案，备案一般需要 3-7 个工作日，新手可提前办理，避免耽误上线进度。如果只是本地测试学习，无需域名，直接使用服务器 IP 地址即可。

新手避坑提示：域名备案必须使用国内服务器，国外 / 香港服务器无法办理 ICP 备案，而商用运营必须使用国内备案服务器，这是合规运营的基础，切勿使用国外服务器搭建商用平台，不仅访问速度慢，还存在合规风险。

3. 工具软件准备

搭建过程中，需要用到几款基础的工具软件，新手可提前下载安装，全程都是免费软件，无需付费：

1. 宝塔面板：服务器可视化管理工具，新手无需记住复杂的 Linux 命令，通过可视化界面，即可完成环境安装、文件上传、数据库管理等所有操作，是新手搭建的必备工具。

2. Xshell/FinalShell：服务器远程连接工具，用于连接服务器，安装宝塔面板，新手也可直接使用服务器厂商提供的远程控制台，无需额外安装。

3. Notepad++：文本编辑工具，用于修改源码的配置文件，避免使用系统自带的记事本，容易出现编码格式错误，导致配置文件失效。

4. Cocos Creator v2.3.2：客户端源码编辑和打包工具，如需修改客户端内容、打包 APP，需要安装对应版本的编辑器，版本必须与源码适配，避免出现兼容性问题。

二、情怀源码宝塔一键搭建全流程，零基础一步步操作

目前市面上 99% 的情怀源码，都适配宝塔面板搭建，全程可视化操作，无需复杂的命令，新手跟着以下步骤，一步步操作，就能在 1 小时内完成搭建部署。

第一步：服务器远程连接与宝塔面板安装

1. 购买服务器后，获取服务器的 IP 地址、root 账号和密码，通过远程连接工具，连接到服务器。

2. 输入宝塔面板安装命令，一键安装宝塔面板，CentOS 7 系统的安装命令如下：

plaintext

yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh

1. 等待安装完成，安装成功后，会显示宝塔面板的访问地址、账号和密码，一定要保存好这些信息，后续所有操作都需要在宝塔面板中完成。

2. 打开浏览器，输入宝塔面板的访问地址，输入账号和密码，登录宝塔面板，首次登录会提示安装推荐的环境套件，按照下一步的要求选择对应的环境版本安装即可。

新手避坑提示：安装宝塔面板后，一定要放行宝塔面板的端口，同时修改默认的面板端口、账号和密码，提升服务器的安全性，避免被黑客攻击。

第二步：服务器环境安装与配置

情怀源码的运行，需要对应的基础环境，不同的源码版本，环境版本要求略有差异，以下是通用的、适配 99% 情怀源码的环境版本，新手直接按照这个配置安装即可，避免版本不兼容导致的报错：

1. 首次登录宝塔面板，会弹出环境套件安装窗口，选择LNMP 套件，对应的版本如下：

o Nginx 1.20+

o MySQL 5.7

o PHP 7.3+

o Pure-Ftpd 1.0.49+

o phpMyAdmin 4.9+

2. 除了 LNMP 套件，还需要额外安装 Java JDK 1.8、Redis 5.0+、Tomcat 8.5+，这些是情怀源码服务端运行的必备环境，在宝塔面板的软件商店中，直接搜索对应的软件，一键安装即可。

3. 等待所有软件安装完成，安装过程中不要关闭页面，避免安装中断，安装完成后，在宝塔面板的软件管理中，可查看所有软件的运行状态，确保所有软件都正常启动，无报错。

新手避坑提示：环境版本一定要严格对应，尤其是 Java JDK 必须是 1.8 版本，MySQL 必须是 5.7 版本，很多新手安装了高版本的 JDK 和 MySQL，导致服务端无法启动，数据库连接失败，这是新手最容易踩的坑。

第三步：源码上传与数据库配置

1. 在宝塔面板中，点击 “网站” 菜单，添加站点，输入你的域名（或服务器 IP 地址），创建网站，同时新建数据库，设置数据库名、账号和密码，一定要保存好数据库信息，后续配置需要用到。

2. 点击 “文件” 菜单，进入网站的根目录，将完整的情怀源码压缩包，上传到根目录中，然后解压压缩包，确保所有源码文件都在根目录下，不要出现多层嵌套的文件夹，否则会导致路径错误。

3. 点击 “数据库” 菜单，打开 phpMyAdmin，选择新建的数据库，导入源码包内附带的数据库 SQL 脚本文件，一键导入，等待导入完成，即可完成数据库的初始化。如果 SQL 文件过大，可通过宝塔面板的数据库导入功能，直接上传导入，避免导入失败。

新手避坑提示：导入数据库前，一定要先备份空数据库，同时检查 SQL 脚本文件的编码格式，确保是 UTF-8 编码，避免出现乱码、导入失败的问题。

第四步：源码配置文件修改，核心参数设置

这是搭建过程中最关键的一步，很多新手搭建失败，都是因为配置文件修改错误，一定要仔细对照部署文档，修改对应的核心参数，主要修改以下三个部分的配置：

1. 服务端配置文件修改：在源码的服务端文件夹中，找到 application.yml、config.properties 等核心配置文件，用 Notepad++ 打开，修改数据库连接信息，包括数据库地址、数据库名、账号、密码，确保与新建的数据库信息一致；同时修改服务器 IP 地址、端口号，确保端口没有被占用，且已经在服务器防火墙和宝塔面板中放行。

2. 客户端配置文件修改：打开客户端源码工程，找到全局配置文件，修改服务器 IP 地址和端口号，确保客户端能正常连接到服务端，修改完成后，可先在本地编译测试，查看是否能正常连接服务器。

3. 支付、短信等第三方接口配置：如需对接支付、短信等第三方接口，在对应的配置文件中，填写商户号、密钥、接口地址等信息，配置完成后，进行测试，确保接口能正常调用。

新手避坑提示：修改配置文件前，一定要先备份原文件，避免修改错误无法恢复；修改完成后，检查配置文件的格式，确保没有语法错误，尤其是 yml 格式的配置文件，对缩进要求非常严格，缩进错误会导致配置文件失效，服务无法启动。

第五步：服务端启动与运行状态检查

1. 所有配置修改完成后，进入服务端的 bin 目录，通过宝塔面板的终端，执行启动脚本，一键启动服务端所有程序，包括 gameserver 核心服务、登录服务、支付服务、管理后台服务等。

2. 等待服务启动完成，启动过程中，可查看启动日志，检查是否有报错信息，如果没有报错，服务正常启动，即可在浏览器中输入服务器 IP 地址 + 管理后台端口，访问运营管理后台，输入默认的管理员账号和密码，登录后台，查看服务运行状态。

3. 打开客户端，输入服务器 IP 地址，测试登录、注册、进入游戏、创建房间等基础功能，确保客户端能正常连接服务端，所有功能正常运行。

新手避坑提示：服务启动失败，90% 的原因是环境配置错误、数据库连接信息错误、端口被占用、配置文件格式错误，可根据启动日志中的报错信息，逐一排查解决，源码包内一般都附带了常见报错的解决方案，新手可对照排查。