简介面向手游开发爱好者与私服架设者的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 版本是否匹配。下表是一套比较常见的仙侠手游依赖组合适合拿来当对照基线组件常见版本区间主要用途缺了它会怎样JDK1.8 / 11运行网关、逻辑、跨服进程服务端进程直接起不来MySQL5.7 / 8.0存储角色、物品、邮件等数据逻辑服启动时连库失败Redis3.x / 5.x缓存登录态、排行榜、实时数据登录频繁报错或排行榜为空Nginx1.16托管运营后台静态资源和 PHP 请求后台无法访问PHP7.2 / 7.4运营后台的接口与页面渲染后台首页 502 或白屏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 -lals -la会显示隐藏文件手工服务端里经常有.env或者.my.cnf这类隐藏配置不显示容易漏看。这里要注意有些压缩包会自带server/bin下的可执行文件解压后默认没有执行权限后续需要统一补上。find /data/game -type f -name *.sh -exec chmod x {} \;这条命令把项目里所有.sh脚本加上执行权限。find的-exec对找到的每个文件执行chmod\;是结束符不能漏。3.2 安装 JDK 并用参数区分日志位置JDK 的安装有很多种方式我一般直接用发行版自带的 OpenJDKyum 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 21 nohup保证关闭终端后进程不退出 /data/game/logs/gateway.log把标准输出重定向到独立日志21把错误输出也塞进同一文件。用放到后台执行。分开写日志的价值在于网关和逻辑服混在一起排错时很难定位拆开后谁崩了直接看谁的日志。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表示大小写不敏感。建完库后退出交互模式用命令行方式导入服务端自带的 SQLmysql -uroot -p game_db /data/game/sql/game_db.sql如果 SQL 文件比较大导入时间较长可以加--default-character-setutf8mb4避免字符集覆盖问题mysql --default-character-setutf8mb4 -uroot -p game_db /data/game/sql/game_db.sql导入完检查表数量确认数据是否完整落盘mysql -uroot -p -e USE game_db; SHOW TABLES; | wc -lwc -l统计行数如果得到的数据和SHOW TABLES里看到的明显偏少多半是导入过程中断需要重新执行一次。3.4 修改数据库连接配置并启动服务端进程数据库建好后要让服务端进程知道“连哪个库、用什么账号密码”。常见做法是找到服务端目录下的config或conf子目录里的db.properties文件vim /data/game/server/conf/db.properties里面通常有这几项需要核对配置项常见填写值作用jdbc.urljdbc:mysql://127.0.0.1:3306/game_db?useUnicodetruecharacterEncodingutf8数据库地址与字符集jdbc.usernameroot或独立账号连接数据库的用户名jdbc.password数据库对应密码连接数据库的密码redis.host127.0.0.1缓存服务地址注意jdbc.url里的characterEncodingutf8不是utf8mb4这是 MySQL 驱动识别的写法数据库本身的字符集才是utf8mb4。如果这里写错可能出现表情符写入报错。全部改完后启动顺序通常是从网关到逻辑服。直接执行启动脚本cd /data/game/server ./start.sh启动后别急着登游戏先确认进程真的起来了jps -l ps aux | grep java | grep -v grepjps -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 nginxnginx -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-fpmsystemctl 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] DescriptionContract Game Service Aftermysqld.service nginx.service [Service] Typeforking ExecStart/usr/local/bin/contract-game start ExecStop/usr/local/bin/contract-game stop RemainAfterExityes [Install] WantedBymulti-user.targetTypeforking适合启动脚本内部通过nohup派生后台进程的情况RemainAfterExityes表示即使主进程退出也保持服务处于活跃状态。完成后执行systemctl daemon-reload systemctl enable contract-game systemctl start contract-game5.2 用定时任务防御磁盘写满仙侠手游服务端的日志膨胀速度超过大部分人的预期尤其是逻辑服的战斗日志和报错日志上线一周就能吃掉几个 GB。给日志目录加一个按天切割的 clean 任务是运维必备动作0 2 * * * find /data/game/logs -name *.log -mtime 7 -delete0 2 * * *表示每天凌晨两点执行-mtime 7删除修改时间超过 7 天的文件。加日志按大小切割更稳妥的做法是配置logrotatecat /etc/logrotate.d/contract-game EOF /data/game/logs/*.log { daily rotate 7 compress missingok copytruncate } EOFcopytruncate对 Java 进程很关键它先复制日志再清空原文件不让 Java 进程因为文件被 rename 而继续写旧文件句柄这是游戏服务端日志轮转里最容易忽略的细节。5.3 用时间同步避免活动错乱仙侠手游的活动开服时间、登录签到、每日刷新全部依赖服务器时间。如果 Linux 服务器时间漂移了几分钟玩家可能反映活动提前结束或者无法领取奖励。检查当前系统时间与实际时间偏差timedatectl如果时间不准开启 NTP 同步timedatectl set-ntp true配置完成后不要立刻重启服务端先观察几分钟让时间收敛再通过date确认当前时间与北京时间一致。手工部署的最后一个动作不是重启游戏而是把服务端日志、后台日志、数据库备份的留存周期都确定好再交给运营使用。本文还有配套的精品资源点击获取