湘情盾手机APP游戏接入
适用：所有手机端游戏APP、封装打包前接入湘情游戏盾
核心一句话：APP全部改本地127.0.0.1，盾后台开转发，服务端绑定127.0.0.1即可正常联网
重要前提：必须 打包/封装之前 修改！打包后修改无效！
整体流程总览（3步搞定）
✅ 第一步：湘情盾控制台 添加游戏端口转发
✅ 第二步：APP包内所有IP/域名 全部改成 127.0.0.1
✅ 第三步：游戏服务端配置 盾IP改为 127.0.0.1 重启生效
第一步：盾控制台配置（操作）
操作页面：湘情盾后台控制台
操作步骤：
1、登录控制台，找到【端口转发/游戏转发】页面
2、新增转发端口，严格按规范填写：
• 游戏主端口：3000端口以上
• 游戏热更端口：10000端口以上
硬性限制（手机限制）：热更端口必须大于10000，低于10000手机端不生效、无法热更、端口转发失效
3、避开热门端口、常用端口，防止冲突
4、保存并开启转发，确认转发状态正常运行
配图提示：截图控制台端口转发列表，核对端口号、运行状态
第二步：修改APP安装包（最关键）
操作对象：未封装、未打包的原始APP包
统一修改规则：
1、包内所有外网服务器IP → 全部替换为 127.0.0.1
2、包内如果是域名地址 → 全部强制解析指向 127.0.0.1
检查范围：游戏连接配置、热更配置、接口配置、所有外网访问文件，一个都不能漏
正确顺序：先改完APP所有IP → 再发给湘情技术编辑接入
错误后果：先发包再改IP → 直接SDK损坏、接入异常
配图提示：截图APP配置文件修改前后对比，确认全部为127.0.0.1
第三步：游戏服务端配置修改
操作对象：游戏服务器引擎、服务端核心配置文件
操作步骤：
1、打开服务端配置、引擎配置文件
2、找到【盾IP/对接IP/外网IP】配置项
3、原有IP删除，填写：127.0.0.1
4、保存配置，重启游戏服务端、引擎服务
配图提示：截图服务端配置文件IP位置，确认已改为127.0.0.1
第四步：提交对接 & 打包上线
1、自查：端口合规、APP全改127.0.0.1、服务端IP正确、控制台转发开启
2、将修改好的原始APP包发送给湘情技术
3、技术编辑完成后，再进行APP封装、打包、测试、上线
常见问题图文排查表（100%解决）
问题1：APP连不上服务器
排查：①控制台端口转发是否添加正确、是否开启 ②服务端盾IP是否正确填写127.0.0.1
问题2：端口不生效、热更失败
排查：手机限制！热更端口必须大于10000，更换非热门端口重试
问题3：SDK损坏、接入报错
排查：操作顺序颠倒！必须先改APP IP，再发包给技术
问题4：一直连接失败
排查：服务端配置残留旧外网IP，彻底清空替换为127.0.0.1
最终重点总结（必看）
1、手机限制：热更端口 >10000，游戏端口 >3000
2、三处统一：APP、服务端、盾转发 全部对应
3、顺序不能乱：先后台转发 → 改APP → 改服务端 → 发包对接 → 打包