8000 GitHub - Adnini983/DecryptCTRNand: 3DS NAND Dump 离线解密工具(PC 端,Windows 原生)。 · GitHub
[go: up one dir, main page]

Skip to content

About

3DS NAND Dump 离线解密工具(PC 端,Windows 原生)。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

18 Commits

Folders and files

Repository files navigation

DecryptCTRNand

简介

3DS NAND Dump 离线解密工具(PC 端,Windows 原生;另附纯 JDK 11 GUI 实现)。

  • 本工具由豆包 AI 和 DeepSeek AI 创作(分析、拆解、验算、脚本与文档撰写均由 AI 完成);用户提供提示词、测试环境与实机 dump 材料配合验证。
  • 命名动机:GodMode9 对开发机(dev)NAND 仍无法完全解密,本工具提供 PC 端离线解密替代方案。
  • 当前版本:2.1.1(已发布,tag 2.1.1)。2.1.1 为并发输出安全与提交语义加固;2.0 起新增 TWL 分区解密(dev 开发机必须使用 raw OTP)。版本历史与详细变更见 DEVELOPMENT.md。

主交付形态:

  • 主交付 = Windows 原生 PowerShell(DecryptCTRNand.ps1):仅用 .NET Framework 内置 Aes / SHA256 / BigInteger,零外部依赖、无需 Python / pip / OpenSSL。
  • Python 参考实现(DecryptCTRNand.py):与主交付逐字节等价的交叉验证实现,仅需 pycryptodome。
  • Java 11 GUI(java/DecryptCTRNandGUI.java → 本地构建 java\DecryptCTRNandGUI.jar):纯 JDK(Swing + javax.crypto + BigInteger),零外部依赖;双击 .jar 即 GUI,同一 jar 也支持与 PS1 参数完全一致的 CLI 无头模式。

功能概述:

  • 从明文 boot9 + OTP + eMMC CID 派生 console-unique normalKey(slot 0x03 TWL + 0x04–0x07)
  • 自动解密 OTP(dev / retail 双模式,统一校验:DEADB00F + SHA256 + dev flag 与模式一致性)
  • 解析 NCSD 头与分区表(边界/重叠检查;TWL 分区强制唯一、索引 0、绝对偏移 0;未知 crypt/fs 组合拒绝解密、不猜 AES slot)
  • 逐分区解密:CTRNAND / firm0 / firm1 / AGB save 走 AES-CTR(SHA256(CID)[:16] nonce);TWL 分区(slot 0x03)走 DSi 专用方案(SHA1(CID)[:16] 反转 nonce + TWL keyscrambler + 每 16 字节块 keystream 反转 XOR;dev 必须用 raw OTP 派生 CustId)
  • 输出结构校验:CTRNAND MBR 55AA、FIRM magic、TWL blk0x1D 锚点 + MBR 55AA + twln FAT boot 55AA + OEM TWL ;核对实际写入字节数、记录每分区 SHA-256
  • 输出安全:先写随机唯一命名的 .tmp,全量校验通过后才提交(失败保留旧文件、不残留 .tmp);只有 -Force 才替换已有输出,否则不覆盖(两个任务写同一目录也不会互相污染);密钥/CID 默认隐藏(-ShowKeys 显示)

使用

启动方式(三端参数名完全一致,大小写不敏感):

REM 方式一:PowerShell(主交付,推荐)
.\DecryptCTRNand.ps1 -NandFile sysnand.bin -Boot9File boot9.bin -OtpFile otp.mem -CidFile nand_cid.mem -Mode dev -OutDir out

REM 方式二:Python 参考实现
python DecryptCTRNand.py -NandFile sysnand.bin -Boot9File boot9.bin -OtpFile otp.mem -CidFile nand_cid.mem -Mode dev -OutDir out

REM 方式三:Java 11 GUI / CLI(jar 双击即用)
DecryptCTRNandGUI.jar                    REM 双击 .jar:直接打开 Swing GUI(无需任何启动器)
java -jar DecryptCTRNandGUI.jar          REM 同上(命令行方式)
java -jar DecryptCTRNandGUI.jar -NandFile sysnand.bin -Boot9File boot9.bin -OtpFile otp.mem -CidFile nand_cid.mem -Mode dev -OutDir out

说明:早期曾提供 DecryptCTRNand.bat 启动器(仅转发参数给 PS1),因无额外价值已移除;Windows 用户直接调用 DecryptCTRNand.ps1 即可(或右键 → 使用 PowerShell 运行)。

命令行参数(PowerShell、Python、Java CLI 三端统一):

参数 说明
-NandFile NAND dump 文件路径(必填)
-Boot9File 明文 boot9.bin(必填,64KB 或 32KB 均可)
-OtpFile OTP 文件(必填,加密或解密均可)
-OtpDecrypted OTP 已是解密明文(仍会统一校验)
-CidHex eMMC CID,32 个 hex 字符
-CidFile nand_cid.mem(16 字节)
-OutDir 解密分区输出目录
-Mode dev(默认)或 retail
-Force 允许覆盖已存在的输出文件(默认拒绝)
-ShowKeys 显示派生的 normalKey(默认隐藏)

输入文件说明:

文件 大小 说明
sysnand.bin ~950MB 完整 NAND dump(GodMode9 格式)
boot9.bin 64KB / 32KB 明文 boot9(64KB GM9 dump:前 32KB prot + 后 32KB boot9;或 32KB prot-only)
otp.mem 256B 加密 OTP(GM9 dump 格式)
otp_dec.mem 256B 解密后 OTP(可选,-OtpDecrypted 时使用,仍会校验)
nand_cid.mem 16B eMMC CID(NAND 芯片出厂值)

输出说明:

  • 默认仅输出状态行;-ShowKeys 时才显示 slot 0x03(TWL)与 0x04–0x07 normalKey 与 CID(敏感,默认隐藏)
  • 解密分区文件 partition_N_slotNN.bin(需 -OutDir):先写唯一命名的 .tmp,通过结构校验 + 字节数核对 + SHA-256 后提交;未加 -Force 时不覆盖已存在的文件(提交阶段再次校验,避免并发覆盖),-Force 覆盖时旧文件仅在新文件验证通过后才被替换;每分区打印 SHA-256
  • 未知 crypt/fs 类型的分区会明确跳过并提示,不会擅自套用某个 AES slot

GUI 提示:路径输入框支持从资源管理器直接拖放文件/文件夹;每个标签页是一个独立解密任务,可同时运行(每任务独立日志与取消);同一输出目录不允许被两个运行中的任务同时使用(启动时即拒绝并提示);工具栏「批量解密」一键启动所有已配置(NAND 路径非空)且未在运行的标签页任务;语言内置「简体中文(默认)/ English」,切换即时生效。

编译

Java 11(jar 为本地构建产物,不随仓库提交——.gitignore 已排除 *.jar):

java\build.bat

产物:java\DecryptCTRNandGUI.jar(javac --release 11 编译,Java 11 字节码;Main-Class manifest)。克隆仓库后先本地构建再使用;分发/使用只需这一个 jar——双击即 GUI、java -jar ... -NandFile ... 即 CLI,无需任何启动器。

运行环境要求:Windows PowerShell 5.1 + .NET Framework 4.5+(推荐 4.8);Java 版需 JRE/JDK 11+。完整要求表见 DEVELOPMENT.md。

许可

本工具以 MIT License 发布(见 LICENSE)。

实现参考:

  • 3dbrew: CTR_NAND, OTP_Registers, AES_Registers
  • pyctr (github.com/ihaveamac/pyctr) — crypto/engine.py(MIT License)
  • decrypt9 / GodMode9 源码

About

3DS NAND Dump 离线解密工具(PC 端,Windows 原生)。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0