准备阶段：这些工具和环境选对了，少走90%弯路
很多人刚上手就急着上传源码，结果环境不对全白搭。就像做饭得先准备好锅碗瓢盆，搭服务器也得先把”灶台”和”工具”配齐。我 了三个最关键的准备工作，每个都踩过坑才敢推荐。
先说服务器系统怎么选。现在主流的服务器系统就两种：Linux和Windows Server。你可能觉得Windows界面熟悉好操作，但我真不 新手用——去年那个朋友一开始就选了Windows Server 2019，结果装个PHP环境就花了一下午，还老提示”端口被占用”，后来换成Linux系统（具体是CentOS 7，现在很多云厂商都有这个版本），用命令行半小时就把环境配好了。为啥？因为H5游戏源码大多基于PHP+MySQL开发，而Linux对这些开源技术的兼容性更好，而且服务器长期运行的话，Linux比Windows更稳定，资源占用也低。当然如果你实在怕命令行，也可以选Linux系统+宝塔面板（后面会说），图形化界面操作，和用Windows差不多。
然后是必备工具，这三个你一定要装，都是免费的：
最后是源码检查，这步90%的新手都会漏！你拿到源码后，先别急着上传，打开文件夹看看有没有这几个文件：
为了帮你更直观选系统，我整理了个对比表，你可以照着挑：
| 系统类型 | 优点 | 缺点 | 适合人群 |
|---|---|---|---|
| Linux（CentOS/Ubuntu） | 稳定、资源占用低、开源免费、兼容性好 | 纯命令行操作门槛高（可配宝塔面板解决） | 想长期运行、追求稳定性的用户 |
| Windows Server | 图形界面熟悉、操作简单 | 资源占用高、稳定性差、部分源码不兼容 | 只短期测试、完全不懂命令行的新手 |
小提醒
：如果你用云服务器（比如阿里云、腾讯云），买的时候直接选”预装宝塔面板的Linux系统”，能省掉后面装面板的步骤，对新手特别友好。像阿里云的轻量应用服务器，现在还有学生机，一年才一百多，性价比很高。
部署实战：7步从源码到可玩，每个步骤都踩过坑
准备工作做好了，接下来就是实际操作。我把整个过程拆成7步，每步都标了”避坑点”，都是我和朋友踩过的雷，照着做基本不会出错。
拿到服务器后，第一步不是传源码，而是把系统更新一下，装些必备的依赖。就像新房入住前要打扫卫生、装水电，服务器也得先”收拾干净”。
如果你用的是Linux系统+Xshell，连接服务器后，先输入这两条命令（复制粘贴就行，#后面是注释不用输）：
yum update -y # 更新系统软件，大概要1-2分钟
yum install -y wget vim # 安装下载工具和文本编辑器
为什么要更新？因为很多云服务器默认系统版本比较旧，可能缺少H5游戏需要的依赖库。我之前帮人搭服时跳过这步，结果装PHP的时候提示”缺少libpng库”，又回头补更新，浪费时间。
如果装了宝塔面板（前面说的预装系统直接登录就行，自己装的话输入面板地址和账号密码），就更简单了——面板首页会提示”推荐安装套件”，选”LNMP”（Linux+Nginx+MySQL+PHP），PHP版本根据你源码的README选（大多是5.6-7.3之间），MySQL选5.7（兼容性最好），然后点”一键安装”，等20分钟左右就行，面板会自动帮你搞定环境。
环境准备好了，就该把本地的H5游戏源码传到服务器上。打开FileZilla，用SFTP协议连接服务器（主机填服务器IP，用户名root，密码是你服务器的登录密码），左边选本地源码文件夹，右边选服务器上的网站目录（宝塔面板的话，一般是/www/wwwroot/你的域名，没有域名就直接放/www/wwwroot下），然后把源码文件夹拖过去就行。
这里有个超级大坑：千万别用中文文件夹名！去年朋友传源码时，本地文件夹叫”捕鱼游戏源码”，传到服务器后，游戏一直提示”找不到资源文件”，排查了半天才发现是中文路径导致Linux系统识别不了，改成英文”fishgame”就好了。 源码里的文件名也别用中文，图片、JS文件都改成英文或拼音，不然玩家可能加载不出资源。
H5游戏需要数据库存用户数据、游戏配置，所以得先建个数据库。用Navicat连接服务器的MySQL（主机填服务器IP，端口3306，用户名root，密码是你装MySQL时设的密码），然后右键”新建数据库”，数据库名随便取（比如game_db），字符集选utf8mb4（支持表情符号，玩家昵称用表情也不会乱码），排序规则选utf8mb4_general_ci。
建完数据库，还要导入源码里的SQL文件（一般叫sql.sql或database.sql），右键数据库名点”运行SQL文件”，选本地的SQL文件导入就行。重点来了：导入后一定要给数据库授权！很多人只建了数据库，没授权用户访问，游戏就会提示”数据库连接失败”。在Navicat里，双击数据库，点”用户”，新建用户，主机填”%”（允许所有IP访问），用户名和密码随便设（比如user1/123456），然后勾选”所有权限”，点”保存”。
打开服务器上的config.php文件（用宝塔面板的话，在文件管理里找到这个文件，右键”编辑”），把里面的数据库参数改成你刚设置的：
$dbhost = 'localhost'; // 数据库主机，本地服务器填localhost就行
$dbuser = 'user1'; // 刚建的用户名
$dbpass = '123456'; // 刚设的密码
$dbname = 'game_db'; // 数据库名
保存后，数据库这步就搞定了。
有时候源码上传、数据库也连好了，但游戏还是打不开，很可能是PHP或Nginx的配置不对。宝塔面板里，点”网站”，找到你刚建的网站，点”设置”，然后：
这步是最容易被忽略的！很多人服务器、源码、数据库都弄好了，结果在浏览器输入服务器IP，提示”无法访问”，就是因为端口没开放。服务器的端口就像家里的门，不开门别人进不来。
H5游戏默认用80端口（HTTP）或443端口（HTTPS），如果用了其他端口（比如8080），也得开放。操作分两步：
bash
firewall-cmd zone=public add-port=80/tcp permanent # 永久开放80端口
firewall-cmd reload # 重启防火墙生效
宝塔面板的话，在”安全”里直接添加端口规则就行，更方便。
文件权限不对，游戏可能会提示”无法写入配置文件”或”上传图片失败”。服务器上的文件权限就像家里的钥匙，权限太高不安全，太低又用不了。宝塔面板里，找到网站根目录，右键”权限”，所有者选www，分组选www，权限设为755（文件夹）和644（文件）——这是行业通用的安全权限，既能保证游戏正常运行，又能防止恶意攻击。
别图省事设777权限（所有用户都能读写执行），之前有个客户这么做，结果服务器被植入了挖矿程序，流量费涨了十倍。如果某个文件需要写入权限（比如上传头像的uploads文件夹），单独给这个文件夹设755权限就行，别给整个目录开777。
都弄好后，先在服务器本地测试：用Xshell输入curl http://localhost，如果返回HTML代码，说明服务器本地能访问；然后在自己电脑浏览器输入服务器IP（比如http://123.45.67.89），看能不能打开游戏。
如果打不开，按这个顺序排查：
我之前帮朋友搭那个捕鱼游戏时，遇到的是白屏问题，F12打开浏览器控制台，发现提示”Failed to load resource: net::ERR_FILE_NOT_FOUND”，顺着路径找，发现是一个图片文件名有空格，改成下划线就好了。所以遇到问题别慌，按F12看控制台报错信息，基本都能定位问题。
对了，如果你想让别人也能玩你的游戏，还可以买个域名（几十块一年），解析到服务器IP，再在宝塔面板绑定域名，这样别人就能用域名访问了，比记IP方便多了。腾讯云开发者社区有篇文章提到，”H5游戏的传播性很大程度依赖访问便捷性，绑定域名能提升用户体验”，你可以参考下（链接：https://cloud.tencent.com/developer/article/1832456，nofollow）。
按照这些步骤搭下来，基本上两小时就能搞定。我那个朋友后来用这套方法，自己搭了三个H5小游戏服务器，现在还在朋友圈炫耀呢。你要是搭的时候遇到问题，随时在评论区告诉我具体报错信息，我帮你看看怎么解决——毕竟踩过的坑多了，这点小问题还是能搞定的。
选系统这事儿，新手真的很容易踩坑。我见过好几个刚开始搭H5游戏服务器的朋友，上来就选Windows Server，理由特简单：“界面跟我电脑一样，看着亲切”。结果呢？去年帮一个做消消乐小游戏的朋友搭服，他就死活要选Windows Server 2019，觉得点鼠标操作肯定比敲命令行简单。结果装个PHP环境，从下午两点弄到晚上七点，不是提示“VC运行库缺失”，就是“Apache端口被系统进程占用”，气得他差点把鼠标摔了。后来我让他换成Linux的CentOS 7系统，再装个宝塔面板，半小时不到，PHP、MySQL、Nginx全搞定了——面板里点几下鼠标，环境套件直接一键安装，比Windows里手动找安装包、配环境变量省心多了。
其实要说为啥推荐Linux，核心还是兼容性和稳定性。你想啊，现在市面上90%的H5游戏源码都是基于PHP+MySQL开发的，这些技术本来就是在Linux环境里跑起来的，兼容性肯定比Windows好。就像你穿鞋子，合脚的鞋走路才舒服，系统跟源码匹配，出问题的概率才低。而且Linux服务器长期开着也稳定，我之前有个客户用CentOS搭的H5棋牌服务器，连续跑了半年没重启过，资源占用也低，512M内存的小鸡就能带动十来个人同时玩。当然了，如果你实在对命令行有心理障碍，短期测试用Windows也行，但记得提前看源码说明——有些老源码只支持PHP 5.6，Windows下装这个版本特别麻烦，还不如直接用Linux+宝塔，图形化界面操作，跟用Windows文件夹没区别，还不用担心跑久了系统卡顿。
H5游戏服务器搭建选Linux还是Windows系统更适合新手？
新手 优先选择Linux系统（如CentOS 7）+宝塔面板组合。Linux对H5游戏常用的PHP+MySQL环境兼容性更好，长期运行更稳定且资源占用低，而宝塔面板提供图形化界面，能避免直接使用命令行的门槛。如果完全无法适应命令行，短期测试可考虑Windows Server，但需注意部分源码可能存在兼容性问题，且长期运行稳定性不如Linux。
搭建服务器必须安装Xshell、FileZilla这些工具吗？
推荐安装但非绝对必须。Xshell用于远程连接服务器，替代工具可选用Putty（轻量免费）或服务器厂商自带的远程控制台；FileZilla是文件传输工具，也可用FlashFXP或宝塔面板的“文件管理”功能替代；Navicat（数据库管理）可替换为phpMyAdmin（网页版，宝塔面板可一键安装）。不过新手 优先使用推荐工具，操作更直观，能减少出错概率。
数据库连接失败提示“无法连接到MySQL”，可能是什么原因？
常见原因有三个：① config.php文件中数据库参数错误，需核对$dbuser（用户名）、$dbpass（密码）、$dbname（数据库名）是否与创建的一致；② 未给数据库用户授权，需在Navicat或phpMyAdmin中为用户勾选“所有权限”并保存；③ MySQL服务未启动，可在宝塔面板“软件商店”找到MySQL，点击“重启”尝试恢复。排查时 先检查参数，这是新手最容易出错的环节。
服务器IP输入后无法访问游戏，可能哪里出了问题？
优先检查三个关键点：① 端口是否开放，H5游戏默认用80/443端口，需在服务器防火墙（如Linux的firewall-cmd命令）和云平台安全组（如阿里云、腾讯云控制台）中同时添加对应端口的入站规则；② 网站根目录是否正确，确认源码上传到了服务器的网站目录（如宝塔面板的/www/wwwroot/域名路径）；③ 入口文件是否存在，检查目录下是否有index.html或index.php，这是浏览器访问的默认入口文件，缺失会导致403/404错误。
不同H5游戏源码对服务器环境要求有差异吗？如何适配？
有差异，主要体现在PHP版本和扩展上。拿到源码后，务必先查看根目录的README.md或说明文件，里面通常会标注所需环境（如“PHP 5.6-7.3”“MySQL 5.5+”“需开启fileinfo扩展”）。若未标注，可通过以下方法适配：先安装PHP 7.0（兼容性较广），开启mysqli、fileinfo、gd2扩展；若游戏加载异常，尝试切换PHP 5.6或7.3版本（宝塔面板支持一键切换）；同时检查源码中是否有中文文件名/路径， 统一改为英文或拼音，避免Linux系统识别异常。
