企业官网建设流程全解析

简介：面向手游开发爱好者与私服架设者的Q萌仙侠题材Linux手工服务端资源包，围绕“契约轮回”项目提供服务端、客户端与运营后台的配套文件，适合有一定Linux基础、希望自主搭建仙侠手游环境或研究服务端部署逻辑的读者。包内共8个文件，以zip压缩包为主（含客户端与服务端两个zip），另有安装教程、必看说明、免责声明等txt文档，以及2个html页面和1个url快捷链接，可用于跳转源码来源页面，整体大小约785.57MB。目前已有353人浏览学习。通过该包可获取Linux手工搭建服务端的完整思路，服务端与客户端压缩包便于对照部署，安装教程与说明文件则能提供基础操作指引，帮助读者少走弯路，快速跑通游戏环境并理解运营后台的组成。注意资源内附免责声明，使用时应遵守相关协议与法律法规。

1. 为什么仙侠手游服务端要单独放在 Linux 上跑

拿到一套带运营后台的手游服务端压缩包，第一反应别急着在 Windows 上双击 exe，先想想生产环境要放在哪。像《契约轮回》这类 Q 萌仙侠手游，Linux 手工服务端的基本盘其实很固定：一个负责网关和逻辑的 Java 进程、一个存玩家数据的 MySQL、一个给运营查数据发奖励的 PHP 后台。把这三样在 Linux 上手工拉起来，比想象中麻烦，但也比想象中值得——因为它不依赖可视化界面，占内存小，还能直接用 systemd、crontab 这些工具管生命周期。这篇文章就按“手工服务端 + 运营后台”这条线，从压缩包拆解开始，走到数据库导入、进程启动、后台对接，把每一步的参数和坑位都摆出来。适合游戏公司运维、测试工程师，以及想搞明白服务端部署逻辑的后端开发。

2. 拆解一套仙侠手游服务端的进程与依赖

2.1 服务端通常由哪几类程序组成

很多新手拿到 Linux 手工服务端后容易懵，是因为压缩包里既有 java 目录、又有 mysql 目录、还有 admin 目录，不知道先跑哪个。按我拆过的手游端来看，只要项目命名正常，一般可以分成四类：

第一是网关与登录进程，负责维护客户端的长连接，处理登录验证、消息路由，通常是GatewayServer或者LoginServer这种名字。第二是逻辑服，也就是GameServer/WorldServer，核心玩法的计算都在这，像副本、任务、战斗结算，它往往连接着多个缓存和数据库实例。第三是跨服进程，处理跨服活动、排行榜这些数据需要在服务器之间同步的逻辑。第四就是运营后台，常见实现是 PHP + Nginx，也有用 Java 后台的，但 PHP 在后台管理场景里出现频率非常高。

这些进程缺了任何一个都跑不完整：没有网关，客户端连不上；没有逻辑服，登录进去也是黑屏；没有后台，运营无法在游戏外发道具、查玩家日志。理解了这套结构，再看压缩包里的目录就不会瞎猜了。

2.2 解压前先看压缩包里有什么

手工部署最忌讳的事情是看到一个.zip就直接unzip扔进当前目录，结果几千个文件散落一地。正确做法是先列出压缩包内容，确认根目录结构，再决定解压位置。

unzip -l Q萌仙侠手游【契约轮回】Linux手工服务端+运营后台.zip

-l参数只显示文件清单，不会真正释放文件。这个步骤能让你看到里面大致有哪几个顶层目录，比如server、sql、admin之类的。第一次接触的包，建议先看目录层级再动手，避免把配置文件和启动脚本覆盖掉。

如果压缩包里的文件名出现乱码，原因通常是压缩时用了 GBK/GB18030 编码，而 Linux 默认把文件名按 UTF-8 解析。解决思路是用指定编码方式解压：

unzip -O CP936 Q萌仙侠手游【契约轮回】Linux手工服务端+运营后台.zip -d /data/game

-O CP936让 unzip 按中文 Windows 编码解析文件名，-d指定释放到/data/game下。需要注意-O参数不是所有发行版自带的 unzip 都支持，如果报错，可以改成7z x方式：

7z x Q萌仙侠手游【契约轮回】Linux手工服务端+运营后台.zip -o/data/game

这里-o后面直接跟目标目录，没有空格。解压完先看目录结构是不是符合预期，再去研究配置文件。

2.3 手工部署前的依赖环境清单

手工服务端和 Docker 镜像部署最大的区别是：Docker 把依赖都封装好了，手工部署需要自己确认 Java、MySQL、Redis、PHP 版本是否匹配。下表是一套比较常见的仙侠手游依赖组合，适合拿来当对照基线：

JDK 版本要特别留意，很多商业手游源码是基于 JDK 8 编译的，如果系统装的是 JDK 17，启动时会抛UnsupportedClassVersionError。MySQL 和 Redis 版本不用太激进，稳定优先。检查这些环境是否满足，可以用下面几条命令：

java -version mysql --version redis-cli --version php -v

如果某个命令提示未找到，先用包管理器安装对应软件，再回头继续部署。手工部署时宁可多花十分钟把环境确认清楚，也不要等服务端日志报错再回头排查。

3. 在 Linux 上手工拉起服务端的最小步骤

3.1 两步完成解压并解决中文目录乱码

这一章的目标是用 Linux 常用命令把一个带完整数据的手工服务端跑起来。前提是已经安装了解压工具，没有的话先装：

yum install -y unzip p7zip # CentOS / RHEL 系 apt install -y unzip p7zip-full # Debian / Ubuntu 系

然后执行解压。如果压缩包内部路径本身是中文，解压后终端显示\uXXXX或者?，多半是编码问题，按第 2 章的-O CP936方式处理。解压完把整个项目移动到统一目录：

mkdir -p /data/game unzip -O CP936 Q萌仙侠手游【契约轮回】Linux手工服务端+运营后台.zip -d /data/game cd /data/game ls -la

ls -la会显示隐藏文件，手工服务端里经常有.env或者.my.cnf这类隐藏配置，不显示容易漏看。这里要注意，有些压缩包会自带server/bin下的可执行文件，解压后默认没有执行权限，后续需要统一补上。

find /data/game -type f -name "*.sh" -exec chmod +x {} \;

这条命令把项目里所有.sh脚本加上执行权限。find的-exec对找到的每个文件执行chmod，\;是结束符，不能漏。

3.2 安装 JDK 并用参数区分日志位置

JDK 的安装有很多种方式，我一般直接用发行版自带的 OpenJDK：

yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel java -version

注意java -version输出里如果看到1.8.0_xxx，说明是 JDK 8。有些服务端脚本会显式指定JAVA_HOME，比如JAVA_HOME=/usr/lib/jvm/java-1.8.0，安装完成后可以用以下命令找到确切路径：

readlink -f $(which java)

拿到真实路径后，如果启动脚本里的JAVA_HOME对不上，需要手动改。这一处是新手最容易栽的坑：明明java -version能跑，但./start.sh报JAVA_HOME not found。另外，Java 进程在游戏里通常以后台方式启动，日志输出也要在脚本里区分开，例如：

nohup java -server -Xms2g -Xmx2g -jar /data/game/server/gateway.jar > /data/game/logs/gateway.log 2>&1 &

nohup保证关闭终端后进程不退出，> /data/game/logs/gateway.log把标准输出重定向到独立日志，2>&1把错误输出也塞进同一文件。用&放到后台执行。分开写日志的价值在于，网关和逻辑服混在一起排错时很难定位，拆开后谁崩了直接看谁的日志。

3.3 创建 MySQL 数据库并导入 SQL

游戏服务端的数据初始化几乎都是通过 SQL 文件完成的。先启动 MySQL 服务，再建库：

systemctl start mysqld mysql -uroot -p

进入 MySQL 交互界面后执行：

CREATE DATABASE IF NOT EXISTS game_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

utf8mb4比utf8多了表情支持，仙侠手游的聊天和角色名里常有特殊字符，统一用utf8mb4能减少后续乱码问题。COLLATE utf8mb4_general_ci是排序规则，_ci表示大小写不敏感。

建完库后退出交互模式，用命令行方式导入服务端自带的 SQL：

mysql -uroot -p game_db < /data/game/sql/game_db.sql

如果 SQL 文件比较大，导入时间较长，可以加--default-character-set=utf8mb4避免字符集覆盖问题：

mysql --default-character-set=utf8mb4 -uroot -p game_db < /data/game/sql/game_db.sql

导入完检查表数量，确认数据是否完整落盘：

mysql -uroot -p -e "USE game_db; SHOW TABLES;" | wc -l

wc -l统计行数，如果得到的数据和SHOW TABLES里看到的明显偏少，多半是导入过程中断，需要重新执行一次。

3.4 修改数据库连接配置并启动服务端进程

数据库建好后，要让服务端进程知道“连哪个库、用什么账号密码”。常见做法是找到服务端目录下的config或conf子目录里的db.properties文件：

vim /data/game/server/conf/db.properties

里面通常有这几项需要核对：

注意jdbc.url里的characterEncoding=utf8不是utf8mb4，这是 MySQL 驱动识别的写法，数据库本身的字符集才是utf8mb4。如果这里写错，可能出现表情符写入报错。

全部改完后，启动顺序通常是从网关到逻辑服。直接执行启动脚本：

cd /data/game/server ./start.sh

启动后别急着登游戏，先确认进程真的起来了：

jps -l ps aux | grep java | grep -v grep

jps -l只显示 Java 进程，能看到进程的完整主类名或 jar 名。如果进程列表为空，立刻看网关日志：

tail -n 50 /data/game/logs/gateway.log

常见的启动失败场景有端口被占用、MySQL 密码不对、JAVA_HOME指向错误。端口占用可以用netstat -tlnp查：

netstat -tlnp | grep 8080

这里8080只是示例，实际看服务端配置里定义的端口。验证服务端是否监听在预期端口：

telnet 127.0.0.1 8080

能连上说明网关对客户端连接是开放的。如果 telnet 连不通，先确认防火墙是否拦截：

firewall-cmd --list-ports # CentOS ufw status # Debian/Ubuntu

手工部署最常见的误区是进程一直在重启，看日志却只看到异常堆栈最后几行，不肯往前翻。正确做法是从tail -n 200开始看，定位到第一行报错，而不是只看最后的堆栈。

4. 运营后台的对接与配置

4.1 后台跟服务端共享哪些数据

运营后台和游戏服务端不是两套独立系统，而是共用同一个业务数据库，只是访问角度不同。服务端写玩家数据，后台读玩家数据，必要时通过写库方式改数据。最常见的后台功能是查玩家角色、查充值记录、发放邮件附件、封禁账号，这些操作都落在game_db的玩家表、订单表、邮件表上。

所以后台配置的核心不是复杂逻辑，而是三点：能不能连上同一个 MySQL；能不能正确读写utf8mb4字符集；后台页面用的账号和密码存在哪张表里。理清这三个问题，后台就成功了一半。

4.2 用 Nginx 配置后台站点并指向 PHP

运营后台多数情况是 PHP 项目，需要 Nginx 把请求转给 PHP-FPM 处理。先安装必需组件：

yum install -y nginx php-fpm php-mysqlnd systemctl start nginx systemctl start php-fpm

然后写一个 Nginx 站点配置，把后台目录指过去：

server { listen 8080; root /data/game/admin; index index.php; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } }

listen 8080避开 80 端口的系统服务冲突，也减少和游戏端口混淆。try_files的作用是让 HTML5 路由或者没有实际文件的 URL 落到index.php上，后台管理系统的页面跳转依赖这个配置。fastcgi_pass必须和php-fpm监听地址一致，通常是127.0.0.1:9000。配置文件写好后重载：

nginx -t systemctl reload nginx

nginx -t会先检查语法，如果直接 reload 发现配置写错，Nginx 可能直接退出。访问后台之前，先确认本机 curl 能返回页面：

curl -I http://127.0.0.1:8080/

返回200 OK说明 Nginx 和 PHP 都通了。

4.3 后台数据库连接与登录鉴权的关键参数

后台的数据库连接配置一般在config/database.php或.env文件里。结构大概长这样：

<?php return [ 'host' => '127.0.0.1', 'port' => 3306, 'database' => 'game_db', 'username' => 'game_user', 'password' => '你的数据库密码', 'charset' => 'utf8mb4', ];

这里有个容易踩的坑：后台代码用utf8mb4连接，但如果 MySQL 的init_connect设置了别的字符集，执行查询时仍然可能乱码。保险做法是在 MySQL 里执行一次：

SET GLOBAL character_set_server = utf8mb4; SET GLOBAL character_set_client = utf8mb4;

游戏后台登录鉴权相对简单，多数时候直接读数据库里的admin_user表或类似的管理员表。可以用下面命令确认管理员账号表的位置：

mysql -uroot -p -e "USE game_db; SHOW TABLES LIKE '%admin%';"

如果后台登录一直提示密码错误，优先检查管理员表的密码加密算法和后台代码是否一致。常见实现是把明文密码做一次 MD5 再入库：

$password = md5($input_password);

这种加密方式很弱，但游戏后台里仍然常见。如果你想改密码，直接通过 SQL 更新即可：

UPDATE admin_user SET password = MD5('新密码') WHERE username = 'admin';

需要注意，改了数据库里的密码之后，要刷新后台页面重新登录，不能只改数据库不观察后台日志里的登录失败原因。PHP 的日志默认在/var/log/php-fpm/error.log，从里面能看到是数据库连接失败还是密码校验失败。

4.4 后台页面打不开的三个排查顺序

后台页面打不开，按照以下顺序排查最快：

先看 Nginx 是否正确解析到后台目录，curl -I如果返回 403，多半是目录权限不够：

chmod -R 755 /data/game/admin chown -R nginx:nginx /data/game/admin

再看 PHP-FPM 是否在监听：

ss -tlnp | grep 9000

如果没有输出，重启 php-fpm：

systemctl restart php-fpm

最后看 MySQL 连接是否正常。在后台根目录写一个临时测试文件可以快速定位：

<?php $conn = new mysqli('127.0.0.1', 'game_user', '密码', 'game_db'); if ($conn->connect_error) { die('连接失败: ' . $conn->connect_error); } echo '连接成功'; ?>

测试完删掉这个文件，不要在正式环境里留后门。

5. 上线前要处理的三个细节

5.1 服务端进程用 systemd 托管

手工部署最常见的维护痛点是服务端进程挂了没人起重启。后台登录、游戏连接全都依赖 Java 进程，靠人工看日志根本不是长久之计。建议把启动脚本改成 systemd 服务，让服务异常退出时自动拉起。

先写一个启动包装脚本，把原版的start.sh和stop.sh包进去：

#!/bin/bash case "$1" in start) cd /data/game/server ./start.sh ;; stop) pkill -f gateway.jar pkill -f gameserver.jar ;; *) echo "用法: $0 {start|stop}" exit 1 ;; esac

保存为/usr/local/bin/contract-game，加执行权限。然后写 systemd 单元文件：

[Unit] Description=Contract Game Service After=mysqld.service nginx.service [Service] Type=forking ExecStart=/usr/local/bin/contract-game start ExecStop=/usr/local/bin/contract-game stop RemainAfterExit=yes [Install] WantedBy=multi-user.target

Type=forking适合启动脚本内部通过nohup派生后台进程的情况，RemainAfterExit=yes表示即使主进程退出也保持服务处于活跃状态。完成后执行：

systemctl daemon-reload systemctl enable contract-game systemctl start contract-game

5.2 用定时任务防御磁盘写满

仙侠手游服务端的日志膨胀速度超过大部分人的预期，尤其是逻辑服的战斗日志和报错日志，上线一周就能吃掉几个 GB。给日志目录加一个按天切割的 clean 任务，是运维必备动作：

0 2 * * * find /data/game/logs -name "*.log" -mtime +7 -delete

0 2 * * *表示每天凌晨两点执行，-mtime +7删除修改时间超过 7 天的文件。加日志按大小切割更稳妥的做法是配置logrotate：

cat > /etc/logrotate.d/contract-game <<EOF /data/game/logs/*.log { daily rotate 7 compress missingok copytruncate } EOF

copytruncate对 Java 进程很关键，它先复制日志再清空原文件，不让 Java 进程因为文件被 rename 而继续写旧文件句柄，这是游戏服务端日志轮转里最容易忽略的细节。

5.3 用时间同步避免活动错乱

仙侠手游的活动开服时间、登录签到、每日刷新全部依赖服务器时间。如果 Linux 服务器时间漂移了几分钟，玩家可能反映活动提前结束或者无法领取奖励。检查当前系统时间与实际时间偏差：

timedatectl

如果时间不准，开启 NTP 同步：

timedatectl set-ntp true

配置完成后不要立刻重启服务端，先观察几分钟让时间收敛，再通过date确认当前时间与北京时间一致。手工部署的最后一个动作不是重启游戏，而是把服务端日志、后台日志、数据库备份的留存周期都确定好，再交给运营使用。

本文还有配套的精品资源，点击获取