hactool 完整指南：快速解析、解密并提取 Switch 游戏文件

hactool 完整指南：快速解析、解密并提取 Switch 游戏文件

【免费下载链接】hactoolhactool is a tool to view information about, decrypt, and extract common file formats for the Nintendo Switch, especially Nintendo Content Archives.项目地址: https://gitcode.com/gh_mirrors/ha/hactool

想看懂 Switch 游戏包里的内容？hactool 是一款开源的 Switch 文件解析工具，能查看、解密并提取 XCI、NCA、NSP 等格式，把加密的游戏数据变成你能直接读的文件。

它到底能帮你做什么

• 🔍 帮你一眼看清文件结构：一个 NCA 里有哪些分区、用的什么加密，跑一下就有答案
• 🔧 帮你解密受保护的内容：配合密钥文件，把加密 NCA 转成明文副本
• 📦 帮你把资源完整提取出来：XCI 卡带、NSP 安装包里的 RomFS、ExeFS 都能拆开
• ✅ 帮你验证完整性：校验哈希与签名，判断文件有没有被改动

第一次上手：从克隆到跑通第一个文件

环境只需 Git、Make 和 C 编译链。克隆仓库并编译：

git clone https://gitcode.com/gh_mirrors/ha/hactool && cd hactool cp config.mk.template config.mk && make

如果 make 不是 GNU make（BSD 系），把make换成gmake即可。

编译完生成hactool可执行文件，找个 .nca 文件验证一下：

./hactool -i game.nca

能打印出文件头信息，说明工具已经跑通。

hactool 使用方法：三件最常用的事

1. 查看文件信息

./hactool -i game.nca

-i是默认动作，会显示魔数、分区布局和加密类型。什么都不传也会执行它。

2. 如何解密 NCA

./hactool -k prod.keys --plaintext game_plain.nca game.nca

-k指定密钥文件，--plaintext把整个 NCA 解密后另存一份。对 Rights ID 加密的内容，把标题密钥放进~/.switch/title.keys即可被自动读取。

3. 提取 XCI / NSP 资源

./hactool -k prod.keys -x game.xci --outdir extracted

-x也是默认动作，NCA 会按分区拆成文件落盘。NSP 这类 PFS0 封装的包，加-t pfs0指定类型就能处理。

Switch 文件结构：项目里藏着什么

• 根目录按格式拆分：nca.c、xci.c、nso.c、pfs0.c、hfs0.c各管一种文件
• mbedtls/ 是内置加密库，AES、RSA、SHA 都靠它，mbedtls/programs/ 还有配套示例程序
• mbedtls/tests/ 放了完整测试用例，改代码前可以跑一遍
• KEYS.md 列出工具认识的所有密钥名，排错时很实用

hactool 参数：效率玩法

• -i、-x本来就是默认动作，不加也能跑
• 加-y顺手校验哈希与签名，提取和验签一次完成
• --xcontenttype=program只提取程序内容，跳过手册和元数据
• 批量处理写个 for 循环，对目录里的*.nsp逐个加-t pfs0 -x --outdir

卡住了怎么办

症状：报unable to open ...打不开文件原因：路径含空格，或文件名写错解法：路径加引号，先ls确认文件名

症状：警告prod.keys does not exist，解密失败原因：没带-k，或默认目录里没有密钥解法：用-k显式指定，或把密钥放到~/.switch/prod.keys

症状：make报错找不到config.mk原因：漏了复制模板这一步解法：先执行cp config.mk.template config.mk再编译

写在最后

hactool 把 Switch 文件解析压缩成了三件事：看信息、解密、提取。建议从手头某个 .nca 文件开始，跑通-i再试-x，对照 KEYS.md 逐个认识密钥，你会对 Switch 的文件结构越看越明白。

（仅用于学习与研究，请遵守当地法规，妥善保管密钥文件。）

【免费下载链接】hactoolhactool is a tool to view information about, decrypt, and extract common file formats for the Nintendo Switch, especially Nintendo Content Archives.项目地址: https://gitcode.com/gh_mirrors/ha/hactool