本文主要介绍在各个平台游玩原神私服, 目前linux, windows, 安卓, iPhone都可以运行, 本文还处于更新当中肯定有很多问题

本文使用的原神版本为7.0, 低版本或高版本可能不适用

https://shop.mhdy.net

1. 服务端

服务端使用普通的https://github.com/Merprose2/LunaGC-Renewed 目前服务端的资源有一定的缺失, 不确定后续会不会补全

1. 请求流程和相关问题

原神客户端接入 LunaGC 时,需要依次完成启动初始化、账号登录、区服查询、资源初始化和游戏网关连接(PC还需要请求安全文件)。本项目先后处理了移动端资源页面显示 0 GB、iOS 收到错误平台资源信息,以及 PC 7.0 启动安全文件返回空正文的问题。后者通过独立插件提供已验证的原包,再由客户端启动代理回放.

flowchart TD PCInit[PC 启动早期安全文件请求] --> Replay[独立插件提供原包,客户端代理回放] Replay --> Client Client[Android / iOS / PC 客户端] --> SDK[SDK 账号登录与 Combo] Client --> Dispatch[HTTP Dispatch 服务 · 22100] SDK --> HTTP[LunaGC HTTP 认证接口] Dispatch --> QRL[query_region_list] Dispatch --> QCR[query_cur_region/os_usa] QCR --> Plugin[按平台合并资源 metadata] Plugin --> Crypto[响应加密与签名] Crypto --> Client Client --> CDN[官方资源 CDN] Client --> Gate[游戏网关 · UDP 22101] HTTP --> Mongo[MongoDB] Gate --> Mongo

/status/server 返回版本,只说明 HTTP 服务可达。SDK 返回登录成功后,客户端还要接受 Dispatch 响应、初始化资源,再与 UDP 网关握手。

PC额外需要请求安全文件, 官方的安全文件会随着版本更新而移除低版本的响应所以服务端需要自己处理. 并且请求早于SDK/Dispatch 私服重定向, 所以没有处理的话会登录失败.

2. 资源包处理

安卓/ios需要请求服务端以下载资源, lunagc默认没有返回官方的资源地址所以请求时会空回导致客户端显示资源大小为0GB

这里通过设计了一个 AndroidDispatchResources 插件来解决这一问题,在 QueryCurrentRegionEvent 中取得尚未加密签名的 protobuf 响应,合并官方资源字段,再交回服务端原有处理链。

当前实现按版本选择独立模板:

请求 version

资源模板

OSRELAndroid7.0.0

metadata.json

OSRELiOS7.0.0

存在且有效时使用 metadata-ios.json

PC 或其它版本

保持原响应

插件在 /query_cur_region/{region} 的 before filter 中选择模板,用 ThreadLocal<RegionInfo> 把它传给同一请求线程中的事件处理器;事件处理后和 after filter 都清除标记。这个实现依赖现有同步请求链.

合并过程只处理 retcode=0 且存在 RegionInfo 的响应。资源模板允许的字段为:

resource_url                  resource_url_bak
data_url                      data_url_bak
client_data_version           client_silence_data_version
client_data_md5               client_silence_data_md5
client_version_suffix         client_silence_version_suffix
res_version_config

模板限制为 256 KiB,主资源 URL 必须是有效 HTTPS 地址。模板里的额外字段和 protobuf unknown fields 会被拒绝;原响应中的 gate、密钥和 unknown fields 则通过 builder 保留。正数 client_data_version 需要配套的 data_url,未提供的基版 data/silence 字段沿用原响应。

这一区分很实用:资源插件只需要补齐已知缺失的数据,不必复制一份完整 Dispatch 响应并承担所有字段的维护。

本项目开发研究时原神国际版为7.1.0, 所以直接请求官方无法得到相应资源, Android 7.0 的官方目录是从 7.1 的 patch_node_versions 回溯得到的:

branch:   7.0_live
revision: 47194594
suffix:   487f173a4b

https://autopatchhk.yuanshen.com/client_game_res/7.0_live/
output_47194594_487f173a4b/client/Android/

resVersionConfig.md5 在这套协议中采用三个 CRLF 分隔的 JSON 对象,依次描述 external、medium、streaming manifest。每个对象的 MD5 和文件大小都从下载到的真实清单计算,组合逻辑类似:

String md5Field = String.join("\r\n", manifestJsonObjects);

生成时保留逐行 JSON 编码,releaseTotalSize 保留官方文件里的字符串 0。资源目录与设计 Data 目录各有自己的 suffix,需要分别确定来源。

最初的 HTTP 对照得到:

  • Android 7.0 增加 resource_url 和 res_version_config。

  • PC 7.0 的其它字段,包括 gate 和 keys,保持一致。

  • Android 7.1 仍返回原来的不支持结果 retcode=11。

3. 登录时欢迎等字段异常

SDK 的一个中文语言 URL 落入 LunaGC catchall,HTTP 返回 200,但内容为空,界面显示 tips_enter_game 字面量。通过 Nginx 精确 location 提供客户端自带的 548 项中文语言表后,欢迎文案恢复.

不经过Nginx代理这里可能无法处理, 小问题不影响流程进行未对lunagc做修改

4. SDK 登录和游戏握手使用不同密钥

需要明确区分以下角色:

角色

服务端来源

用途

SDK 登录

keys/private_key.der

解密 SDK 账号/密码字段,本实例为 RSA 1024 位

auth fallback

keys/auth_private-key.der

备用或兼容认证解密,本实例为 RSA 1024 位

SigningKey

keys/SigningKey.der

签名 QCR 明文,也用于游戏 Token 请求的随机种子解密,本实例为 RSA 2048 位

game key 2–5

keys/game_keys/

按 key_id 选择公钥加密响应内容,客户端用配对私钥解密

QCR 的 sign 与 content 走两条不同的密码学路径。SDK 公钥已经配对,仍可能在 QCR 验签或 Token 握手处失败。iOS 测试时正好依次遇到了这些问题.

5. PC安全文件

测试时刚好经历了原神从7.1更新到7.2, 然后PC无法登录LunaGC因此发现了PC需要请求得到安全文件后才能继续执行登录等流程.

官方只保留了当前版本和上一版本的完全文件所以7.1时期可以登录而到了7.2无法登录.

PC 在进入 SDK 登录之前会访问官方 /query_security_file?file_key=OSRELWin7.0.0 LunaGC对这一路径的响应默认为空.

实测发现对7.0返回7.1的安全文件也能通过验证所以通过新增 SecurityFileReplay 插件,用现有 Javalin 注册 GET。插件数据目录存放官方 OS 7.1 原始响应,启动时核对长度和 SHA256;仅当 file_key=OSRELWin7.0.0 时返回 24,424 字节原文,其余请求保持空正文。

plugins/SecurityFileReplay.jar
plugins/SecurityFileReplay/OSRELWin7.1.0.bin

回复不包装 JSON,也不使用离线分析产生的 decoded 二进制。

2. 客户端

1. 安卓

安卓端的修改是基于https://github.com/Xuoos/AnimeGamesProxy

项目做的修改, 主要修改为内嵌进apkm安装包, 增加gm工具, 增加帧率解锁, 增加mod管理器

1. APKM 的分包结构

修改源是通过第三方下载的官方国际版7.0.0 APKM

APKM 外层有六个成员:

APKM_installer.url
base.apk
icon.png
info.json
split_AssetBundles.apk
split_config.arm64_v8a.apk

base.apk 承载应用入口、SDK 和 NPatch 模块;split_AssetBundles.apk 承载内置资源;arm64 split 保存原生库。后续每个版本都围绕一个确定的修改点构建,例如 v9 改资源 split,v10 只换 base 里的 runtimefix 模块。

NPatch 内嵌两个模块:AGP 4.6 和本项目自己的 org.lunagc.runtimefix。AGP 负责私服转发与游戏 RSA;runtimefix 补充 SDK URL、账号公钥、私服 CA,并逐步加入 GM、帧率和分辨率功能。

本项目已对代理, 帧率解锁, mod管理器进行了合并并重新设计了界面, 安卓和ios默认资源贴图像素较低分辨率解锁没有实际意义暂时先放弃并移除了.

三份安装 APK 必须使用同一证书。NPatch 默认签名输出、官方 split 和工作包不能随意混装。外层 APKM metadata 保留原始字节,安装器没有要求的 hash/size 字段不自行添加。

2. SDK 账号 RSA 与服务端不匹配

安卓默认的RSA公钥是2048位, 而服务端认证使用的对应密钥不同会导致4214报错, 通过插件来进行RSA修补/替换解决.

单独替换过于麻烦后续把 SDK 修复迁入独立模块,同时恢复完整官方 origin。账号 hook 精确接入RSAUtils.encryptByPublicKey(byte[], byte[])

第二个参数只有在 DER SHA-256 命中官方固定公钥时才替换。这里有一个容易写错的角色关系:Android 模块内的替换公钥匹配的是服务端 auth fallback,不是 SDK private_key.der。(这里属于历史包袱, 通过修改应该是可以直接匹配SDK默认私钥)

材料

用途

account_rsa_public.der,162-byte SPKI、RSA 1024 位

SDK 账号字段加密,匹配服务端 auth fallback

AGP gs_default_pub.xml,RSA 2048 位

默认游戏 SigningKey 公钥

固定私服 CA

TLS 信任

APK 签名证书

Android 安装和包身份

四者需要分别核对。用某一把公钥或证书“全部替换”,会混淆本来独立的流程。

私服 TLS 支持采用 CompositeTrustManager:先调用系统验证,仅在 CertificateException 后尝试固定 CA 的独立 store,保留 hostname 传递。SDK URL 修复也限定到 area=os / env=2 的 25 个固定字段,并要求当前值仍与官方原值一致。只在通过域名并开启HTTPS时需要, HTTP ip+端口不需要, 并且本项目没有对这里做处理.

3. 资源校验问题

服务端补齐资源 metadata 后,用户完成了约 28.7 GB 的基础资源下载。下载日志显示:

File num to verify = 801
CheckAllFinish return true

但客户端没有进入门界面,而是再次校验(这里的现象是游戏循环登录)。复测中游戏 PID 和 Activity token 保持不变,说明观察到的是同一进程内的初始化复位。

独立 runtime probe 和临时 Unity 日志采样进一步暴露了 native 错误:

Block can't find path = 01/25863747.blk
ReadBlockInfo_B Error!
LoadDataIndex Error! LoadAppendIndex return false
External Asset Index Load Error,Read Streaming Instead

错误发生在 CheckAllFinish 之后。因此,下载校验通过只能说明它检查的文件集合通过,后续设计数据索引初始化仍可能失败。

这里做的修复是将设计data写入了APK

PC 和 Android 的特定设计 Data 集合可以共享,依据是相同 revision 和逐项内容,而不是“都是同一个游戏”。项目核对了以下数据:

集合

文件数

总字节数

完整共享设计 Data

533

1,243,787,170

Android 原 APK 内置子集

20

150,999,441

缺少的设计块

513

1,092,787,729

两端 data_revision 均为 47194594,Android 内置 20 条记录与 PC 对应记录完全相等,包含原始 hash、isPatch、大小和 MD5。索引 31049741.blk 的内容也相同。这份设计清单与 res_versions_external 的文件名集合没有交集。

外部复制是一次有价值的失败对照

先把 533 个设计块与真实 data_versions_remote 复制到应用外部 files,共 534 个文件,逐项 MD5 全部通过。启动后,额外的 513 个设计块和 remote 清单消失,只剩与原 APK 内置名单相同的 20 项,原错误继续出现。

采样没有捕获 unlink,所以可以确认外部复制方案没有持久生效,但不能认定具体是谁执行了删除。下一份构建改为直接修补 APK 内置资源。

后续只重建 split_AssetBundles.apk:

  1. 将 assets/data_versions_streaming 替换为完整 533 项原始清单。

  2. 添加缺少的 513 个 assets/AssetBundles/blocks/... 文件。

  3. 原有 20 个设计块和其它 11 个块保留,最终共 544 个 .blk。

  4. 清单与设计块使用 ZIP_STORED,重签并对齐;base 和 arm64 split 原样复用。

完整清单为 71,416 bytes,MD5 为 f980885e0ef0d364a1a896baf8b92e5a。asb_settings.json 的 package_type=less、revision、res/silence 清单和原字段都保持原值,没有伪造下载完成标记。

后续测试可以正确出现进入游戏了.

4. SDK 在代理之后又改了一次 host

通过使用http代理服务端到lunagc后登录报错http_unknow_host 而通过外置代理或dns或host修改指向时可以正确登录.

实际定位到 ServerRegionInterceptor.replaceHostInUrl:AGP 先把请求改到私服 IP,SDK 随后又把 host 改回 dispatchosglobal.yuanshen.com,但 scheme 和端口仍保留。

后续在 after hook 中采用很窄的恢复条件。下面是逻辑示意,privateHost 对应本项目构建时固定的私服 IP:

if (!hasThrowable
        && beforeHost.equals(privateHost)
        && afterHost.equals(dispatchHost)
        && original.newBuilder().host(afterHost).build().equals(result)) {
    return original;
}
return result;

最后一个条件证明 SDK 只改了 host,返回完整原 HttpUrl 就能保留 scheme、port、path、query、userinfo 和 fragment。其它 URL 变化和原异常继续沿用原行为。

两次真机日志都实际命中 shapeMatch=true / preserved=true,before/after scheme 为 HTTP、端口均为 22100。关闭外置代理可以正确进入游戏了.

这次成功把一个模糊的错误文案收窄成了具体的 URL 改写顺序。ErrorTranslator 的 http_unknow_host 是泛化默认错误,单看它无法确定错误来源。

只替换 base 内的 assets/npatch/modules/org.lunagc.runtimefix.apk,其余 1,028 个非签名条目和两个 split 保持不变。NPatch 用模块 ZIP CRC 派生缓存路径,因此保留数据、同 versionCode 的更新也能刷新模块,不需要清理游戏资源。

5. 帧率请求、Surface 尺寸和原生指令是三层问题

v12 定位了该版 libyuanshen.so 的 Unity targetFrameRate 入口:

对象

模块内偏移

getter

0x0f42b888

setter

0x0f42b894

目标帧率变量

0x149753e4

实现先比较 getter/setter 的预期指令,再通过 Unsafe 访问目标变量,每 500 ms 同步目标值,并请求 Android 高刷新率显示模式。这里设置的是目标值,实际 FPS 还受屏幕刷新、场景负载和设备状态影响。

v13 增加 SurfaceHolder 尺寸拦截。当前源码还包含对 ScreenManager::SetResolution 两处指令的运行时修改尝试,偏移为 0x8966950 / 0x8966974,需要通过 mprotect 改页权限。

v14 的记录改为离线修改 arm64 原生库,把两处分辨率初始参数、两处 SetResolution 参数、getter 两条指令、setter 和帧率变量固定为目标尺寸及 120。这是作用于游戏软件的 ARM64 指令与数据补丁。

帧率解锁实测有效, 但画质解锁后看起来并没有变化, 对比PC资源发现安卓贴图资源只有1024x1024而PC有2048x2048, 修改分辨率没有价值所以后续放弃了.

2. PC

此处的PC更多指的是Linux, Windows默认兼容足够, 几乎不需要修改什么.

mod加载器使用xxmi而非原生3dmigoto, Linux兼容层使用DWProton

1. 安全文件请求

前一天使用TwinTailLauncher通过了所有测试, 而第二天想要脱离TwinTailLauncher时发生了错误, 现象为启动后静默退出, 错误只有initDriver Failed: Error [4,643,0]

转折来自一条启动早期请求:客户端向官方查询 7.0 安全文件,收到 HTTP 200,却没有正文。保持同一客户端、DWProton 16 和独立前缀,只将这个空回复替换为通过 7.0 公钥外层校验的官方 7.1 原包后,游戏进入登录流程并成功加载世界。随后用日常 GIMI 入口重测,也没有问题.

本文记录这条证据链、之前没有解决故障的维护尝试,以及最终可用的运行流程。结论适用于本项目的国际服 Windows 7.0 客户端和 LunaGC 环境;没有找回原始 7.0 安全文件,也没有确定官方回复变空的日期。\推测为官方更新导致, 因为可以返回的是7.1和7.2, 其他版本均无返回.

2. 修改补丁以兼容Linux

lunagc提供的Astrolabe.dll补丁默认只兼容Windows, Linux使用时出现错误, 后续通过修改解决. 不确定通过其他方法是否可以不修改, 本文使用修改过的为例子.

DLL 仅文件偏移 14975 处一字节不同(.text 段,RVA 0x467f):

- 上游:48 85 C0 74 20 → test rax,rax; je +0x20(条件跳转)

- 修改版:48 85 C0 EB 20 → test rax,rax; jmp +0x20(无条件跳转)

3. 使用脚本代替

脚本启动临时回放代理,再调用 start-gimi.sh,由 DWProton 16 启动 XXMI loader 和游戏。Steam 客户端无需启动,Proton 仍读取本机 Steam 的部分兼容文件。对steam有一定的依赖, 可以通过修改解除依赖.

flowchart TD Start[独立回放启动脚本] --> Prepare[从服务端插件取包并校验] Prepare --> Script[start-gimi.sh] Script --> Loader[DWProton 16 启动 XXMI loader] Loader --> Game[同一独立 prefix 启动游戏] Game --> Early[早期安全文件请求] Early --> Relay[本次进程的临时代理] Relay --> Official[经已有上游代理完成官方 TLS 握手] Official --> Empty[官方 7.0 空回复] Empty --> Replay[原样回放已验证的 OS 7.1 文件] Replay --> Continue[继续初始化与 GIMI 加载] Continue --> Private[Astrolabe 重定向 SDK 和 Dispatch] Private --> World[登录、资源初始化、UDP 网关、进入世界]

需要注意的是Astrolabe.dll将代理写死为了127.0.0.1:8088, 如果你的服务端在远端则需要转发127.0.0.1:8088到Dispatch地址, Linux和Windows都需要

3. 其他问题

直接通过steam添加第三方游戏来启动也是可行的.

遇到的无法启动问题, 挺说steam可以禁用掉安全补丁, 但实测没有解决问题, 后面通过服务端返回安全文件解决, 详情看服务端PC安全文件

3. ios

iOS主要为通过dylib作为模块来实现代理, RSA修补等操作, 可以通过https://github.com/LiveContainer/LiveContainer 来直接为7.0.0解密客户端直接注入dylib来使用.

F系列为早期测试失败版本
R系列为成功版本

1. 失败测试

SDK 明文公钥与游戏原生 RSA 的不同入口

原版主程序 __TEXT,__cstring 中发现六个 PEM 槽,归并为五把独立公钥:三个 SDK 环境槽、一把出现两次的 auth 公钥,以及公告 Cookie 公钥。

主程序文件偏移

已建立的用途

后续映射

0x129DE427

公告 Cookie

保留

0x129E1209、0x12A745A0

同一 auth 公钥

服务端 auth fallback,1024 位

0x129EB8B0、0x129EBA80、0x129EBC50

三个 SDK 环境公钥

服务端 SDK 登录公钥,1024 位

三份 Mach-O 的代码签名区还包含 Apple 签名链相关 RSA 公钥,它们属于代码签名,不是游戏协议密钥。

早期曾把部分 SDK 槽当成游戏签名槽,进而误以为静态公钥都已经对齐。后来的 native 调查发现,游戏 QCR 和 Token 路径把公钥用 ARM64 指令逐段构造出来,根本不依赖这几处明文 PEM。

因此,扫描到哪些公钥和运行时究竟调用哪套 RSA,需要分别回答。

F 系列尝试过 SDK 静态改写、网络转发、Security.framework hook 和 native memcpy 观察。它积累了几类值得保留的失败经验。

单库替换后没有重新签名

一次独立 dylib 替换被 dyld 以 code signature invalid 拒载。CodeDirectory 页摘要正确,仍不足以满足实际安装环境的签名要求。后来按用户原有 LiveContainer 流程替换旧库并强制签名,F5 才确认执行。

追加一个新注入项也不会自动删除旧库。更新需要明确旧库的加载来源,否则多个版本可能同时存在。

LiveContainer 中的 image 0 不一定是游戏

早期 native caller 范围判断直接把 _dyld_get_image_header(0) 当作游戏基址。一次采样所有候选都被 range 条件挡掉,后来启用 LiveContainer 的隐藏容器选项后,range 拒绝计数降为 0。

但替换计数仍然为 0,格式识别未命中,4214 继续出现。修正基址识别解决了一个诊断障碍,并没有自动解决 RSA 路径问题。

主程序不是可直接 dlopen 的动态库

旧 FILES1 交付原始 MH_EXECUTE 主程序,用户替换并强签后仍报 cannot dlopen a main executable。后续 LC2 根据 LiveContainer 的固定版本实现转换为 MH_DYLIB,调整 header flags、__PAGEZERO 并加入 LC_ID_DYLIB。

LC2 至少部分启动到了 F7 面板/登录界面,但仍有间歇性 SIGTRAP。缺少完整镜像表和调用栈时,单独一个运行地址无法确定具体故障函数。这条路线的稳定性问题没有取得最终修复结果。

2. 成功版本

总结需要修改三组公钥, 代理和路由改写

设备实测成功链路:R2 账号登录成功 → R3 私服转发命中(HTTP 200)→ R4 越过 4214/无手动选服 → R5 越过 4309,点击进入游戏到资源更新界面。R5 是文档确认的成功终点;资源下载完成和进入世界未确认。

一、修改的公钥(3 组)

1. SDK 账号解密公钥(R1→R2,运行时 hook)

原(官方)

目标(服务端)

数量/位置

3 个 SDK 环境槽 0x129EB8B0/0x129EBA80/0x129EBC50

—

位宽

2048

1024

SPKI SHA256

18c89110919f8cf07a434655356c4f91bb123e3e1e7baf56c8288efde26eba50、73495c72f05ef31da08910612708e11442b9a4ac557e11061a4f0acd9401ffa6、7b3df50c6a4eb8bcedab0961f3bc37cb8e2bb009db8b5759501824cdbe2bd48c

89de0b3e01d2bbd30652357f2a8c9a158a96db89b01747e77e4f5b308b8065ce

机制

fishhook 重绑定 SecKeyEncrypt + SecKeyGetBlockSize(R2 补块长映射,防 256 字节零尾)

按公钥指纹映射

2. auth 备用/兼容认证公钥(R1→R2,同一 hook)

原(官方)

目标(服务端)

数量/位置

2 处 0x129E1209、0x12A745A0

—

位宽

1024

1024

SPKI SHA256

23f9c56d7f3a35439866c3ce609dc05be00fa32c441ba5af12eee2bccd38c4e9(两处相同)

66ce7455006cbf7ee3d28caf83f13ccddda19a81c0fbfc4521849fdeace4fd01

机制

同 SDK hook

3. 游戏 QCR/Token 签名公钥(R4→R5,静态改主程序立即数)

原:官方签名公钥 SPKI 1ffa3ca5f7911d17a095d91e08c0094bc4fddac9c572f9ffb99150e34df4da54(2048 位) 目标:服务端 SigningKey SPKI 67ad0a57380fce6355c86e7362ffb5830f040cb1a502c54c1f55e2b26038bfc8(2048 位)

阶段

修改地址

用途

块长

指令/不同字节

R4

0x103a72698、0x10461a584

QCR A/B 验签

各 952

342 / 926

R5

0x103a6e4fc

Token clientRandKey 加密

936

513 / 1389

R5

0x105f19c50、0x105f3825c

Token 回包验签实现/处理

各 952

同上

R5 后 7 处签名公钥构造中 5 处已替换,另外两处 QCR(0x103a58d44、0x103a66f0c)和全部 client game key 5 私钥保持原样。修改只动 MOV/MOVK 的 imm16 立即数,寄存器/控制流/验签逻辑不变。

4. 未修改、天然配对的密钥

  • content key 5:游戏公钥 b640dbc7907dc0588d4ea11ea9ca1c313a8ab6974f5436f6b43dad456c72d84f 与服务端一致。

  • 服务端 7 把独立公钥(SDK 89de0b3e01d2bbd30652357f2a8c9a158a96db89b01747e77e4f5b308b8065ce/auth 66ce7455006cbf7ee3d28caf83f13ccddda19a81c0fbfc4521849fdeace4fd01/SigningKey 67ad0a57380fce6355c86e7362ffb5830f040cb1a502c54c1f55e2b26038bfc8/game 2–5)全部指数 65537;game keys 2/3/4 只在服务端。

二、代理与路由改写(R3)

  • Hook 点:+[UnityWWWConnectionDelegate newRequestForHTTPMethod:url:headers:](按类名/方法名/类型编码 @40@0:8@16@24@32 匹配,非固定地址)。

  • 改写规则:/query_region_list → 私服完整 HTTP URL;官方 /query_cur_region + 已知区域后缀 → /query_cur_region/os_usa;只处理 GET 和 5 个域名(global/America/Europe/Asia/TW-HK-MO)。

  • 私服目标(来自只读单区响应):http://服务端/query_region_list、http://服务端/query_cur_region/os_usa(区名 os_usa,标题 Grasscutter,DEV_PUBLIC)。

  • 保留:query 参数和 fragment 按原字节保留(含 key_id、dispatchSeed、百分号编码);创建请求后清除旧 Host 覆盖。

  • 不改写:SDK 登录/Combo、官方资源 CDN、query_security_file、已指向私服的 URL。无新增证书放行/代理服务/空区服列表。

  • Sauce 测试网络:原 HTTP 代理、端口 18080、无认证;SDK 账号接口也经该代理接入私服。

  • ATS:原版 Info.plist NSAllowsArbitraryLoads=true 已确认,未修改(HTTP 到私服可用)。

三、其它修改数据

  • 主程序加载项:仅追加一条 LC_LOAD_DYLIB @executable_path/Frameworks/LunaRSA.dylib(72 字节,放 header padding)。

  • Info.plist 标记:LunaQCRPatchVersion=R4-QCR-20261107.1、LunaGameTokenPatchVersion=R5-TOKEN-20261107.1;dylib 版本 R3-20261107.1。

  • 签名:整包 ad-hoc(CodeDirectory 86,722 页 + 特殊槽 1/2/3/5/7 匹配),Sauce 安装时重签;相比上一版仅主程序/Info.plist/根 CodeResources 三个文件 CRC 不同。

  • R2 dylib 细节:LunaRSAKeys.c 重新生成与 R1 字节相同(SHA256 419d3e385aa68b7601ab691ed0b040d0334a967ea2ef5630f9898706a41518ad);三把目标公钥、4 个映射、30 个保护摘要、3 个 image 标识沿用。

四、关键事实与边界

  • R1 失败根因:只换密钥不换块长(Swift 包装按 256 字节分配、实际写 128 字节、发整个数组 → 服务器拒绝;Base64 344、尾 128 字节零)。

  • 日志显示 LunaRSA R3 是预期(dylib 未变),R4/R5 变化在主程序,以 IPA 文件名/Storage ID 区分。

  • 未验证:资源下载完成、进入游戏世界、服务端日志重核;R6/R7 已交付但无真机结果。

  • 私服地址为 dispatch-target.json 原样记录(该域名隐藏真实 IP 信息)。

1. R1 到 R2:只替换公钥,为什么输出仍然错误

RSA-only R1 使用 fishhook 接管 Security.framework 的导入符号,按公钥摘要把 SDK/auth key 映射到当前服务器。它能命中映射,却仍在 SDK 账号解密阶段失败。

设备日志显示一个很有辨识度的结构:

Base64 长度:344
解码长度:256 bytes
最后 128 bytes:全部为零

主程序的 Swift 包装代码先调用 SecKeyGetBlockSize(originalKey),按官方 2048 位 key 分配 256-byte 数组。R1 只在 SecKeyEncrypt 时换成 1024 位 key,实际写入 128 bytes,而包装代码仍追加整个数组。

blockSize = SecKeyGetBlockSize(originalKey)  → 256
output = zeroFilledArray(blockSize)
written = blockSize
SecKeyEncrypt(mapped1024Key, ..., output, &written)
                                              written = 128
append(output)                             → 仍发送 256 bytes

服务端将整段密文交给 1024 位私钥解密,拒绝了这段过长的输入。这个错误发生在账号字段,尚未进入密码校验和 QCR。

R2 为 SecKeyGetBlockSize 增加与加密相同的 key 映射,使数组分配、分块和实际输出都使用 128-byte 块长。补丁内部识别原 key 时调用保存的原始函数,避免递归。

针对性回归复现了旧版的 128-byte 零尾,并确认修复后输出为 128 bytes、Base64 长度 172;用户随后确认 R2 的 SDK 登录成功。

这次问题的关键在调用方合约:更换一个密码学对象,会同时改变块长、分块上限和缓冲区分配。只拦截最后一次加密调用,可能漏掉前面的尺寸查询。

2. R2 到 R3:有代理连接,仍可能没有 HTTP 请求

SDK 登录之后,R2 仍出现官方区域列表和更新提示。最新 America 复测把同一个连接号的两种日志关联起来:

TCP 已连接现有 HTTP 代理
TLS Trust evaluation failed (-9807)
HTTP load failed -1202
收发 0/0 bytes

-1202 对应 NSURLErrorServerCertificateUntrusted。这说明对应连接已经走到代理,但在 TLS 信任阶段失败,没有形成 HTTP 请求。单看服务端缺少 QCR access log,无法区分“没经过代理”和“经过代理但 TLS 失败”。

R3 采用与 Android 类似的完整 HTTP Dispatch 转发,在:

+[UnityWWWConnectionDelegate newRequestForHTTPMethod:url:headers:]

创建请求前,把全局/当前区服 URL 改到私服公布的路径。实现保留 query 和 fragment,清除旧 Host 覆盖,SDK 账号部分继续使用 R2。

这里还有一个 Objective-C ABI 细节:方法属于 new 家族,返回对象的所有权是 retained。函数指针和替换函数都需要保留 NS_RETURNS_RETAINED,不能按普通 autoreleased 返回值包装。

R3 真机记录确认 global 转发命中,随后游戏使用私服 /query_cur_region/os_usa 并收到 HTTP 200。官方四区手动选择流程消失,但接下来出现了 4214,排查由网络阶段进入游戏层验签。

3. R3 到 R4:游戏公钥藏在 MOV/MOVK 指令中

R3 的 Security.framework 验签 hooks 没有记录到这次 QCR 的验签调用。继续沿游戏原生控制流定位,发现两条通往 4214 弹窗的路径。

路径

公钥构造起点

验签调用

QCR A

0x103a72698

0x103a72cc8

QCR B

0x10461a584

0x10461abb4

这些是该版 Mach-O 未加 ASLR 的虚拟地址。每个构造块为 952 bytes,用立即数和存储指令拼出 415-byte RSA XML。明文 PEM/DER 搜索没有覆盖这种表示。

独立对照得到:

材料

规范化 public SPKI SHA-256

游戏指令构造的官方签名公钥

1ffa3ca5f7911d17a095d91e08c0094bc4fddac9c572f9ffb99150e34df4da54

服务端 SigningKey 公钥

67ad0a57380fce6355c86e7362ffb5830f040cb1a502c54c1f55e2b26038bfc8

同一份无账号 QCR 探针响应,用官方公钥验签失败,用服务器公钥成功;content key 5 对应公钥则配对一致。

R4 只替换两处构造的立即数字段,共 342 条指令、926 个不同字节,保留寄存器、存储位置、控制流和真实验签逻辑。用户实测后确认越过 4214,接着在点击进入游戏时遇到 4309-0。

4. R4 到 R5:Token 握手还有三处公钥要配对

服务端对应错误为:

GetPlayerTokenReq RSA failed
key_id=5, clientRandKey len=256
BadPaddingException: Padding error in decryption

key_id=5 在后续回包加密中选择 game key 5;当前请求的 clientRandKey 实际由服务器 SigningKey 私钥解密。

继续定位发现,发包时的公钥构造只有 936 bytes。前面按完整 952-byte 块搜索只找到六处,漏掉了这一个存储布局不同的构造。按指令语义还原后,共识别七处签名公钥构造。

R5 补齐三处:

地址

用途

0x103a6e4fc

加密请求中的 8-byte 随机种子

0x105f19c50

Token 回包验签实现

0x105f3825c

Token 回包验签处理

服务器内使用 8-byte 人工数据做对照:官方公钥产生的密文无法被当前 SigningKey 正确解密,服务器公钥可以;签名验证也得到对应结果。R5 修改三处构造的 513 条立即数指令,共 1,389 个不同字节,保留 R4 两处 QCR 修复。

用户随后确认:点击进入游戏不再报错,弹出预期资源更新界面。这是本阶段的成功终点,资源下载完成和进入世界尚未确认。

R4/R5 的内嵌 dylib 都仍为 R3。因此,日志里显示 R3 并不说明安装错包;主程序补丁版本需要通过 IPA 身份和包内标记区分。

5. R6:把游戏公钥修改移入运行时函数表

静态定位进一步发现,七处签名公钥构造最终都使用同一个 RSA 类的参数导入入口:运行时函数表第 18 槽,ARM64 下偏移为 18×8=0x90。部分调用经过中转函数,所以不能只搜索直接的 ldr ..., #144。

参数 ABI 是一个 64-byte 结构,包含八个 managed byte-array 指针:

RSAParameters +0   Exponent
              +8   Modulus
             +16   私钥参数 1
               …
             +56   私钥参数 6

managed byte[] +24  64-bit 数组长度
               +32 字节数据

R6 在首次转发 Dispatch 请求创建前安装 hook。实现先核对完整主程序 UUID、相关函数前缀指令、类初始化状态、函数表页权限和原槽位目标;必要时调用游戏自己的加锁初始化入口,再原子替换函数指针。

替换条件同时要求:

  • 指数为 01 00 01,即 65537。

  • 模数长度为 256 bytes,全部字节精确匹配已定位官方公钥。

  • 六个私钥参数均为空。

命中时改写本次新建数组的模数,再调用原导入函数。加密、填充和验签继续由游戏执行。这条路线覆盖七处相同公钥的导入,不再依赖逐处修改主程序立即数。

验证基线也随之改变:R6 使用原公钥主程序。若继续用已经静态修好的 R5 主程序测试,即使新 hook 没生效,也可能误判成功。

R6 已通过构建、策略自检和原版代码/七处公钥保留检查并完成交付。首次 QCR 前能否及时安装、实际命中和设备结果仍待测试。