简介Q萌仙侠手游《契约轮回》是一套采用Linux手工部署方式的完整手游源码包包含服务端与运营后台主要面向手游私服搭建者、仙侠题材技术爱好者及Linux运维人员适合用于学习服务端环境配置、运营后台操作和客户端与服务器之间的联调尤其适合有一定Linux基础并希望从一键端进阶到手工部署的读者。包内共8个文件其中2个zip分别对应客户端和服务端组件3个txt文档覆盖安装教程、必看说明与免责声明另外2个html页面和1个url快捷方式提供原始发布方相关指引整体包体785.57MB文件归类较为清晰方便按说明顺序处理。已有353人浏览学习属于体积适中、内容聚焦的手游源码资源。整体来看借助随包安装教程和说明文档使用者可完整走通Linux手工服务端部署流程快速定位运营后台入口免去从零摸索的时间同时由于是手工端而非傻瓜式一键端也能帮助读者更深入地理解手游服务端结构与启动逻辑为后续二次开发或玩法调整打好基础。1. 从一份压缩包到能登录的仙侠世界「契约轮回」这类 Q 萌仙侠手游市面上能看到的形态几乎都是客户端加服务端的完整工程。客户端负责画面和战斗表现服务端承担登录鉴权、角色数据、战斗校验、跨服逻辑和运营数据上报。所谓「Linux 手工服务端」本质是把这套服务端从 Windows 开发环境迁移到 Linux 生产环境并且不依赖一键脚本由运维人员逐个进程拉起、逐个模块配置。这份压缩包里同时带了运营后台意味着除了游戏逻辑服务还包含一套管理界面用于发放元宝、查看在线人数、封禁账号、调整活动配置。手工部署的价值不在「手工」本身而在于每一步都可以被审计和回滚。一键脚本虽然快但出了问题很难定位——不知道装了什么依赖、改了哪些配置、启了哪些端口。手工部署则把服务端拆成数据库、缓存、网关、游戏逻辑、跨服通信、后台 Web 几大块每块独立安装、独立验证。这篇文章按「拿到压缩包之后从零搭起来」的顺序走把解压、建库、改配置、启动进程、接通后台、日常排错这几件事讲透。适合有一定 Linux 基础、想接手这类私服或测试环境搭建的运维和开发人员阅读。2. 服务端包的解压、环境检查与目录规划2.1 拿到 ZIP 后先做三件事压缩包在 Windows 上下载、传到 Linux 服务器最常见的问题是中文文件名乱码。ZIP 格式本身不强制指定编码Windows 默认用 GBKLinux 默认按 UTF-8 解压结果就是config目录里的中文路径变成一串乱码。处理方式是在解压时显式指定编码。unzip -O gbk Q萌仙侠手游【契约轮回】Linux手工服务端运营后台.zip -d /data/contract-O参数告诉 unzip 使用 GBK 解码文件名-d指定解压目标目录。如果系统里的 unzip 版本较老不支持-O需要先安装 p7zipyum install -y p7zip p7zip-plugins 7za x Q萌仙侠手游【契约轮回】Linux手工服务端运营后台.zip -o/data/contract解压完成后不要急着启动任何东西先看目录结构。一个标准的手游服务端包通常包含以下内容。目录或文件作用说明server/游戏服务端程序通常按区服编号拆分子目录sql/数据库初始化脚本含建库、建表、初始数据www/或admin/运营后台 Web 工程PHP 或 Java 项目config/全局配置数据库连接、端口、网关地址tools/辅助工具日志分析、数据修复脚本注意这个过程不要unzip -o直接覆盖解压到根目录。服务端程序通常依赖相对路径读取配置解压路径一旦变了后面要改一大堆配置文件里的绝对路径得不偿失。2.2 手工部署前必须确认的硬件与系统条件服务端对硬件的要求取决于区服预期人数。单区单服架构下4 核 8G 内存的云主机能带 300 到 500 人同时在线如果要开跨服战场或全服排行榜内存建议 16G 以上。磁盘方面游戏日志增长很快每天 1G 到 3G 很正常数据盘单独挂载比较稳妥。系统版本优先选 CentOS 7.9 或 Ubuntu 18.04 以上的 64 位系统。服务的核心依赖是 JDK 1.8而 JDK 1.8 在 CentOS 8 以上需要手动配置某些精简镜像还需要补glibc兼容库。部署前用一条命令把基础信息收集齐cat /etc/redhat-release uname -a free -h df -h nproc这会输出系统版本、内核架构、内存余量、磁盘余量和 CPU 核心数。看到Linux version 3.10.0基本可以确定是 CentOS 7内核版本太老会导致部分 Java NIO 特性异常。内存低于 4G 的话后面启动 MySQL 和多个 Java 进程会非常吃力建议直接加内存或缩减区服节点数量。2.3 目录规划路径里不要带中文和空格无论压缩包内部怎么组织外部统一放在/data/下按业务隔离成三个目录。mkdir -p /data/contract/server mkdir -p /data/contract/admin mkdir -p /data/contract/backup解压后的程序文件放进server运营后台代码放进admin数据库备份和日志归档放backup。这样做的直接好处是后续做数据迁移或服务器灾备时只需要打包/data/contract一个根目录关闭防火墙时也只需要放行这一个目录对应的端口段。服务端内网通讯用的地址建议写内网 IP不要写127.0.0.1。因为跨服节点和运营后台可能需要通过内网访问游戏服的数据库和缓存用127.0.0.1绑定会导致外部节点连不上。后面配置游戏服的server.properties时这一点是新手最容易忽略的坑。3. 环境依赖安装JDK、MySQL 与 Nginx 的版本匹配3.1 JDK 版本不对服务根本起不来「契约轮回」这类商用引擎编译的服务端几乎锁死 Java 8 语法。用 OpenJDK 11 或更高版本来跑轻则启动报UnsupportedClassVersionError重则运行期间出现内存溢出或线程挂死。手工部署时先把系统自带的 OpenJDK 卸载干净避免多个 Java 版本互相干扰。rpm -qa | grep -i jdk | xargs rpm -e --nodeps yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel安装完成后验证java -version输出里必须看到1.8.0_xxx字样。如果输出的是 11 或 17说明/usr/bin/java的软链接还没切过来手动指定update-alternatives --config java进入交互界面选择编号对应的 OpenJDK 8 即可。解压后的服务端目录里通常每个区服文件夹下有一个start.sh或run.sh。脚本里写的java -Xms512m -Xmx2048m -jar xxx.jar这行命令Java 8 能直接识别高版本 JDK 启动时则可能报模块访问错误。这也是为什么坚持要用 JDK 1.8 来跑而不是图新装 11 或 17。3.2 MySQL 5.7 与初始化脚本的坑服务端数据库初始化脚本一般按 MySQL 5.6/5.7 的语法写的。MySQL 8.0 之后的caching_sha2_password默认认证插件会导致老版本驱动连接时报Authentication plugin错误。手工安装时直接选 5.7 版本最省事。以 CentOS 7 为例用二进制包方式安装 MySQL 5.7wget https://cdn.mysql.com/archives/mysql-5.7/mysql-5.7.44-linux-glibc2.12-x86_64.tar.gz tar -zxf mysql-5.7.44-linux-glibc2.12-x86_64.tar.gz -C /usr/local/ mv /usr/local/mysql-5.7.44-linux-glibc2.12-x86_64 /usr/local/mysql groupadd mysql useradd -r -g mysql -s /bin/false mysql mkdir -p /data/mysql/data chown -R mysql:mysql /data/mysql/data cd /usr/local/mysql bin/mysqld --initialize --usermysql --basedir/usr/local/mysql --datadir/data/mysql/data--initialize会生成临时 root 密码注意看最后几行日志。拿到临时密码后启动数据库并修改密码bin/mysqld_safe --usermysql 这里有个细节初始化的临时密码在/data/mysql/data/error.log里也能找到。如果没有记录重新初始化时加--initialize-insecure参数生成一个无密码的 root 账号然后登录设置新密码。后续导入 SQL 脚本前需要先确认数据库默认字符集SHOW VARIABLES LIKE character_set%;如果字符集不是utf8mb4需要在/etc/my.cnf里加一段配置[mysqld] character-set-serverutf8mb4 collation-serverutf8mb4_unicode_ci3.3 Nginx 装好但后台网页打不开的排查路径运营后台通常是 PHP 工程或静态页面加反向代理的形式。如果是 PHP 写的后台需要安装 PHP 7.0 以上的版本并启用pdo_mysql扩展。yum install -y epel-release yum install -y nginx php php-fpm php-mysqlnd php-gd php-mbstring systemctl start nginx systemctl start php-fpmPHP-FPM 默认监听/var/run/php-fpm/php-fpm.sockNginx 配置里fastcgi_pass要与之对应。后台打不开时先看 Nginx 错误日志tail -f /var/log/nginx/error.log常见两种报错connect() failed (111: Connection refused)说明 PHP-FPM 没启动或监听地址不对Primary script unknown说明 Nginx 的root路径和fastcgi_param SCRIPT_FILENAME指向的文件不存在。服务端包自带的运营后台里index.php往往在二级目录下需要把 Nginx 的root指向实际的 Web 根目录而不是压缩包解压后的外层目录。4. 手工启动游戏服务端从配置到进程拉起4.1 服务端进程结构与启动顺序多数 Q 萌仙侠手游服务端采用多节点架构各节点独立进程。常见划分如下进程名职责默认端口段GATE / Proxy网关客户端入口8000-8005LOGIN登录鉴权9000GAME / World游戏逻辑主逻辑10000-10050CROSS跨服战、全服排行11000DB 代理数据库连接池封装12000启动顺序不能乱。先启动数据库和缓存再启动 DB 代理然后启动网关最后启动游戏逻辑与跨服。反过来的话游戏逻辑进程会因连不上数据库而反复重启。每启动完一个节点都要等日志里出现Server start successfully或bind port success之类的关键词再启动下一个。每个区服目录下都有一个start.sh手工部署不使用一键包自带的批量启动脚本而是逐个执行。以下是一个典型的单节点启动命令cd /data/contract/server/s1 nohup java -Xms512m -Xmx1024m \ -Dfile.encodingUTF-8 \ -Dlog4j.configurationfile:./conf/log4j.properties \ -jar game-server.jar \ --spring.config.location./conf/application.properties \ ./logs/start_$(date %F).log 21 -Xms和-Xmx控制了 JVM 初始堆和最大堆区服人数少时设置为 512m 和 1024m 足够人数超过 500 建议提升为 1024m 和 2048m。-Dfile.encodingUTF-8防止日志中文乱码。启动日志重定向到独立文件避免后面排查时翻不到当天的历史日志。4.2 IP、端口与内存参数的修改点解压后的配置里默认 IP 可能是127.0.0.1或内网测试地址必须全部改成当前服务器的实际内网 IP。需要检查的配置文件集中在config目录重点看三个字段# application.properties server.host192.168.1.100 server.port10000 db.urljdbc:mysql://192.168.1.100:3306/game?useUnicodetruecharacterEncodingutf8mb4 redis.host192.168.1.100 redis.port6379 data.center.host192.168.1.100 cross.host192.168.1.100db.url中数据库名称要以sql/目录下初始化脚本里的实际库名为准常见的有game、log_db、global_db三个库分别对应游戏数据、日志数据和跨服公共数据。如果初始化时只建了库而没导入数据服务端会在启动时尝试自动建表但部分引擎版本不支持自动建表会直接抛异常。Redis 在服务端里承担缓存和排行榜的职责。安装 Redis 3.2 以上版本即可不需要太多调优但有两个参数必须确认daemonize yes requirepass 你的密码如果服务端配置里写了redis.password而 Redis 没开启密码验证服务端会因权限校验失败而拒绝启动。4.3 用端口和日志双重验证服务是否正常启动完所有节点后用一条命令检查端口监听状态netstat -tlnp | grep java正常情况下会看到多个 Java 进程分别监听不同的端口。0.0.0.0:10000说明该游戏逻辑节点正常对外服务127.0.0.1:10000则说明只监听了本地环回地址外部客户端将无法连接。进程起来不代表一切正常还要查看日志里是否有异常堆栈tail -100 /data/contract/server/s1/logs/start_2024-01-01.log出现OutOfMemoryError说明堆内存设置太小按比例调大-Xmx出现Connection refused说明后置依赖服务还没就绪出现Table doesnt exist则要回到初始化脚本补导对应表。检查完这些之后再打开客户端配置文件把服务器 IP 和端口改成实际地址测试从登录到进游戏全链路是否通。5. 运营后台的部署与对接发号、公告与数据查询5.1 后台登录与数据库连接配置运营后台的代码放在admin/目录下手工部署要做的第一件事就是修改数据库连接配置。PHP 项目一般在config/database.php里return [ host 192.168.1.100, port 3306, database game, username root, password 你修改后的密码, charset utf8mb4, ];后台的登录账号密码通常存在admin_user表里默认密码为admin123的居多。为了安全登录后立刻改成强密码。后台能正常打开、能登录说明 PHP 到 MySQL 的连接没问题。如果打开页面报数据库连接失败优先检查 MySQL 是否只绑定了127.0.0.1[mysqld] bind-address0.0.0.0比较常见的坑是MySQL 安装好后默认只监听本地PHP-FPM 和 MySQL 在同一台机器时没影响但后台和游戏服分离部署时后台就连不上数据库。5.2 后台功能与服务端接口的关联方式运营后台的操作本质上是直接改数据库或调用游戏服提供的 GM 接口。以发放元宝为例前台页面填完角色名和数量后后台逻辑先查角色表拿到角色 ID再更新对应行的货币字段。这类操作可以手工用 SQL 验证SELECT role_id, role_name, gold FROM role_data WHERE role_name 测试角色; UPDATE role_data SET gold gold 10000 WHERE role_name 测试角色;有些服务端在内存里维护了角色缓存直接改数据库不会立即生效需要后台额外调用一个 HTTP 接口通知游戏服刷新缓存。这类接口地址在后台的config/gm.php里配置gm_url http://192.168.1.100:10000/gm/refreshRole部署运营后台时后台服务器到游戏服10000端口的网络连通性必须提前验证否则发号、踢人、公告推送这些操作全部无效。5.3 公告与活动配置的修改入口公告类操作一般不走数据库而是通过后台推送到 Redis 或游戏服的内存。更新公告后玩家需重新打开公告面板才会拉到新内容。活动配置则分两类一类是数据库配表直接控制活动开放时间另一类是策划配置的 JSON 文件改完上传到服务端的config/activity/目录后重载。如果后台改了活动配置玩家端看不到先确认 Redis 里的活动缓存有没有过期redis-cli keys *activity*常见问题是服务端代码里活动缓存过期时间设置为 12 小时后台改完配置后没有手动清除缓存。解决办法是在后台提供一个「清缓存」按钮或者登录 Redis 执行DEL命令删除对应 key让服务端下次读取时自然加载最新配置。6. 手工服务端的日常维护、升级与排错技巧手工部署最大的收益在排错阶段体现。哪个进程出了问题直接看对应目录下的日志文件不需要在一堆脚本输出里翻找。故障现象排查顺序常用命令区服无法登录网关→登录服→数据库netstat -tlnp | grep java后台无法打开Nginx→PHP-FPM→数据库tail -f /var/log/nginx/error.log地图卡角色游戏服日志→数据回档grep ERROR /data/contract/server/s1/logs/*.log跨服无法匹配跨服节点→Redis 连接redis-cli -h 内网IP ping游戏运行一段时间后数据量增长会导致 MySQL 查询变慢。建议每周做一次表优化和备份mysqldump -uroot -p game /data/contract/backup/game_$(date %F).sql mysqlcheck -uroot -p -o game注意mysqlcheck的表优化操作会锁表在线人数较多的时段不要执行。升级服务端时不要直接用新版覆盖旧版。把新版解压到独立目录然后把旧版的config/和sql/目录复制过去逐项对比配置文件差异。数据库结构的变更通常在sql/update/目录下的增量脚本里按文件名序号逐个导入。最后的技巧是给所有 Java 进程加上启动参数中的 GC 日志记录-Xloggc:./logs/gc_$(date %F).log -XX:PrintGCDetails -XX:PrintGCDateStamps后续出现卡顿或内存溢出的情况把 GC 日志拉出来对比 Full GC 的频率能快速判断是内存分配不足还是出现了内存泄漏。配合jmap -dump导出堆快照用 MAT 分析大对象基本能定位到具体类和方法。本文还有配套的精品资源点击获取