传奇类手游本地搭建技术流程：自研授权服务端部署与排错

只做自研或已获书面授权的三职业框架学习、内网测试。直接复制他人热血传奇客户端、地图、怪物、技能、UI去部署并对外收费，属于侵权高风险；司法案例里未经许可架设并收取充值，已有缓刑、实刑及罚金判决，部分案件文件相似度鉴定、非法经营额或违法所得达到刑事追诉标准。 下面流程按“合法素材+本地单机/内网”写。

一、环境与目录

Windows学习机用10/11专业版或Server 2016起；小团队用云主机2核4G起步，纯单机1核2G也能跑轻量端。建纯英文目录，如D:\MirMobile\Server，不放桌面、不用中文路径。装运行库合集、Notepad++、7-Zip；若服务端用MySQL装5.7/8.0，用MongoDB按包装，用DBC老框架装对应数据库驱动。安卓测试用雷电/夜神模拟器或真机；iOS测试用自有开发者证书和Xcode，不借助他人企业签绕过审核。

二、服务端文件核对

完整包至少含数据库服务、登录网关、游戏网关、主引擎、角色/世界服务、脚本与地图资源、移动端配置、后台接口。重点目录按引擎不同会变，通用看：

DBServer或等价数据库服务：负责账号、角色、物品落地。
LoginGate登录网关：负责客户端握手、区服列表、账号校验。
GameGate/RunGate游戏网关：转发地图、战斗、移动包到主引擎。
M2Server/GameCore主引擎：加载地图、怪物、技能、NPC、爆率、行会、沙城。
Mobile/LoginCenter移动端配置：serverlist.json、server.json、project.manifest、gateway配置。
Web后台：注册、GM、区服状态、热更资源，常用Nginx/Apache+PHP或引擎自带网站。

缺主引擎、缺网关、缺数据库初始化脚本的包不继续，先换完整工程。

三、数据库初始化

MySQL路线：新建库，如mir_mobile，字符集按工程要求，老工程常用gbk、新工程用utf8mb4；导入包内SQL，确认accounts、characters、items、guild、config表存在。Navicat连127.0.0.1:3306，账号用独立强密码，不开root远程。配置文件填库名、用户名、密码、端口，启动前测试连接。

DBC类老框架：建BDE别名指向DB目录，主引擎数据库设置选DBC，确认数据文件可写。Mongo类按包建库并起mongod，DBServer读连接串，不手动建表时用包内init脚本。

外网正式环境数据库不对外放3306，只让网关和内网应用连。

四、改IP与端口

单机本机：所有配置写127.0.0.1。
局域网多手机：写主机内网IPv4，如192.168.1.105；手机和主机同Wi-Fi。
外网授权发布：写云主机公网IP或绑定域名；动态公网用DDNS，不用写死局域网地址。

常改位置：
主配置Setup/GameCenter/ServerConfig：区名、主IP、游戏端口、数据库。
LoginGate配置：监听IP、列表端口，常见7000类。
GameGate/RunGate配置：转发到主引擎，常见7001/7100/7200类，具体看包。
移动端列表serverlist.json/server.json：区名、IP、端口、资源地址。
安卓热更project.manifest/version.manifest：资源服务器IP、端口、文件清单。
战神类部分包改gateway_cfg.lua、session_cfg.lua、mir2.def.ini；其他引擎看MobileGate.ini或等效文件。

端口规划避免冲突：登录7000、游戏7100至7200、热更/微端8000类、后台按包、数据库按库类型。Windows防火墙、云安全组都要放行；本机测可用127.0.0.1，局域网必须换内网IP，否则手机不显示区服。

五、启动顺序

1. 起数据库服务，确认监听、无认证报错。
2. 起网站/后台，确认区服状态接口可访问。
3. 起DBServer，看数据库连接成功。
4. 起LoginGate，看列表与登录监听。
5. 起GameGate/RunGate，看转发就绪。
6. 起SelGate/角色服务（有则起）。
7. 起M2Server/主引擎，看地图、怪物、技能、NPC、脚本加载完，无红色报错。
8. 起热更/微端，确认资源可下载。

报错优先看：LoadMapFail是地图文件缺；ScriptError是NPC/任务脚本语法错；Port occupied是端口被占，用netstat -ano查PID；DB connect fail是库名、账号、密码、权限或防火墙问题。

六、PC测试客户端

用与服务端版本号一致的合法客户端。把工程自有Data、Map、音效、UI补丁解到客户端根目录，不混用其他版本资源。登录器配置器填IP、端口、区名、资源列表，生成PC登录器；单机用127.0.0.1，局域网用内网IP，外网用公网IP或域名。多版本分开文件夹，不共用一个客户端根目录，避免补丁互相覆盖黑屏。

七、安卓APK改列表与签名

仅对自有或授权工程生成的APK操作。用Android Studio或合规反编译/压缩工具打开，优先改：
assets/res/project.manifest
assets/version.manifest
assets/config.xml
assets/serverlist.json
assets/kuniu/defServerList.json（部分包）
netconfig.lua、mir2.def.ini（部分包）
gateway/session配置引用的资源地址

把里面127.0.0.1或旧IP换成测试机对应IP，端口与服务端GameGate、列表服务一致。若工程用热更包mir2.zip，改完重算manifest的MD5和文件大小，否则手机会黑屏或资源不更新。

保存后重签：Android可用apksigner配合自有keystore，或MT/改之理等工具自签；未签名APK在安卓不允许安装。模拟器装签名包，真机同网络装包；先建号、建角色、打怪、捡物、放技能、开NPC、交易、传送各测一遍。

八、iOS IPA改配置与签名

用解压工具开IPA，进Payload/游戏.app/res或工程指定目录，改project.manifest、serverlist、netconfig里的IP和端口；若资源在bundle内zip，同步改zip内配置。回包后用自有开发者证书签名：开发测试用个人/公司证书加设备UDID，分发用企业资质或TestFlight，不借来路企业签绕过审核。手机系统“设备管理”信任证书后安装；连不上先查清单IP、端口、HTTPS证书、工程bundle资源路径。

九、三端互通校验

主引擎开移动端和PC接入，账号库、角色库、物品库共用。PC建角色打怪掉装，安卓同账号登录看等级、背包、行会、邮件一致；iOS再登一遍验证。不一致查三处：各端manifestIP、网关转发、数据库读写。互通不是简单改IP，要确认主引擎的移动会话、PC会话、资源版本号统一。

十、GM与参数

网页后台按包访问，如http://内网IP/admin或工程指定路径，首次改默认管理员密码，不用出厂弱口令。主引擎管理员列表加角色名和权限等级，仅内部测试用；爆率、经验、金币、刷新、转生/合击/内功按你自研需求开，纯复古不勾额外系统。外网正式服关调试指令、限制GM访问IP、定期备份数据库和Mir/Server资源目录。

十一、常见故障

点登录器没反应：运行库缺、未管理员、杀毒删主程序、登录器与引擎版本不匹配。
手机不显示区服：serverlist.json IP仍127.0.0.1、局域网未写内网IP、后台列表接口未起、安全组未放端口。
连接失败/不开门：LoginGate或GameGate未起、主引擎IP端口写错、防火墙拦7000至7200、云安全组未放、路由器未做端口映射。
黑屏不下载资源：project.manifest热更IP错、微端8000未起、资源zip未传、APK未重签、补丁路径盘符错。
创建角色失败：数据库无写权限、角色表字段缺失、DBC别名路径错、MySQL账号权限不足。
闪退：模拟器内存不够、APK未签名、iOS证书不信任、主引擎加载地图脚本红错。
延迟高掉线：网关线程不够、主机CPU满、数据库慢查询、移动网络走代理VPN；内网测试关代理最稳。

十二、合规与安全

只用自研代码、自有美术、已购正版素材，或取得著作权人书面授权后再部署。不下载他人“热血传奇”服务端、不提取正版客户端地图怪物技能、不把未授权资源换名发布。以收费充值为目的私自架设，司法实践按侵犯著作权处理：云南案未经许可运营获利13万余，判缓并处罚金； 安徽宁国案改名“九星神宠”“小米暗黑”收费11万余，最终追到授权前仍被诉； 上海谢某某引擎+素材私服分成，非法经营237万余、违法所得104万余，判三年六个月； 虹口邓某买“武力雷霆”“火龙冰雪”等程序运营充值18万余，判一年六个月缓执并处罚金； 合肥张某某改“凤凰传奇”收费20万余，构成侵犯著作权； 其他改头换面案同样按实质性相似认定。

技术安全补充：云主机只开必要端口，数据库绑定内网，GM后台限VPN或内网，登录器校验资源MD5防列表劫持，APK用自有签名证书，定期更系统补丁，不装来路“一键端”和未知补丁。个人学习用127.0.0.1和模拟器最省事；要真机内网联机写内网IP；要外网发布必须先有授权合同、版号/运营资质和正版资源证明。