湘情盾（游戏盾）手机端APP接入完整教程
适用场景：手机端APP封装打包前，湘情游戏盾接入配置
核心原理：APP本地请求转发，将APP内所有外网访问地址强制本地回环，通过盾控制台转发真实游戏服务器流量，实现防盾接入效果
前置要求：必须在APP打包、封装、上架之前完成所有配置，打包后修改无效
一、前期准备工作
1、准备待封装打包的APP原始安装包/源码包（未编译、未封装的原始包文件）
2、确认自身游戏服务端端口、热更新端口（提前记录备用）
3、登录湘情盾后台控制台账号，拥有端口转发配置权限
二、APP包核心修改（最关键步骤）
打开需要封装的手机APP原始包，批量修改包内所有对外访问地址，不分接口、游戏连接、热更地址，统一修改，具体规则如下：
1、IP地址修改规则
APP包内所有原本的外网服务器IP、对外连接IP，全部替换为本地回环IP：127.0.0.1
2、域名解析修改规则
如果APP包内没有IP、全部是域名访问，需要将所有对外域名强制解析指向127.0.0.1，彻底屏蔽外网直接访问
重点提醒：必须检查完整包内所有配置文件、接口文件、游戏连接配置、热更配置，不能遗漏任何一个外网地址，遗漏会导致接入失败、游戏闪退、连接异常。
三、游戏端口规范设置（硬性要求）
为保证湘情盾正常转发、避免端口冲突、保障游戏稳定运行，端口必须严格按照以下标准设置：
1、游戏主端口：建议设置为 3000以上 端口
2、游戏热更新端口：建议设置为 10000以上 端口
3、禁止使用低端口、系统占用端口，防止转发失效、热更失败、游戏掉线
四、提交湘情技术对接接入
1、确认APP包内所有IP/域名已全部修改为127.0.0.1，端口设置符合规范，自查无遗漏、无错误
2、将修改完成的APP原始包，直接发送给湘情盾技术工作人员
3、告知技术人员：已完成本地IP改造，需要协助编辑配置、开通游戏盾接入权限
五、湘情盾控制台配置（用户自行操作）
在湘情盾官方控制台后台，完成游戏端口转发配置，步骤如下：
1、登录湘情盾控制台后台
2、找到【端口转发/游戏转发】功能模块
3、添加对应游戏端口：填写你刚刚设置好的游戏主端口、热更端口
4、保存转发配置，开启端口转发功能，确保转发状态为正常运行
六、服务器服务端最终配置
登录你的游戏服务器，修改引擎版本、服务端核心配置，完成最终对接：
1、进入游戏服务器后台，打开引擎配置文件、服务端核心配置
2、找到盾IP/对接IP配置项，将原有IP修改为 127.0.0.1
3、保存所有配置，重启游戏服务端、引擎服务，让配置生效
七、核心极简接入流程（最终正确顺序）
最简三步流程（按顺序操作，不可颠倒）
1、盾控制台配置：登录湘情盾控制台，正确添加游戏主端口、热更端口转发，开启转发功能
2、修改APP安装包：APP封装打包前，将包内所有外网IP、域名全部替换为 127.0.0.1，端口严格遵循规范（游戏端口≥3000，热更端口≥10000），修改完成后再提交给湘情技术处理
3、修改游戏服务端：打开服务器引擎、服务端配置文件，将盾对接IP修改为127.0.0.1，保存配置并重启服务端生效
八、常见报错精准排查（专项问题解决）
问题1：APP连不上服务器 排查方案：①检查湘情盾控制台的游戏端口转发是否添加正确、状态是否正常；②核对游戏服务端配置文件内的盾IP是否准确填写为127.0.0.1
问题2：端口不生效、热更失败 排查方案：手机端存在端口限制，必须确认热更端口严格大于10000，同时避开常用热门端口、系统占用端口，避免端口冲突导致转发失效
问题3：SDK损坏、接入异常 排查方案：严格遵循操作顺序，必须先修改APP包内所有IP为127.0.0.1，完成自查无误后，再提交给湘情技术编辑处理，禁止颠倒操作顺序
问题4：持续连接失败 排查方案：重点复核服务端核心配置文件，确认对接盾IP已完整修改为127.0.0.1，未残留原有外网IP地址
补充提醒：所有配置修改、对接操作均需在APP封装打包前完成，打包后修改配置无效，需重新改包、对接接入