NS-USBloader 完整使用指南：一台电脑搞定 Switch 的 RCM 注入与 NSP 文件管理

【免费下载链接】ns-usbloaderAwoo Installer and GoldLeaf uploader of the NSPs (and other files), RCM payload injector, application for split/merge files.项目地址: https://gitcode.com/gh_mirrors/ns/ns-usbloader

第一次给 Switch 注入 payload 时，我在命令行里耗掉了整个晚上。hekate 的 bin 文件明明就在手边，可驱动、权限、参数，每一步都在跟我较劲。等屏幕上终于滚过一屏绿色代码，我立刻去搜"有没有更省事的方案"——然后遇到了 NS-USBloader。它把 RCM 注入、NSP 文件传输、文件分割合并三个最常用的操作，全部收进一个 Java 图形界面里。这篇 NS-USBloader 使用指南会从安装讲起，一步步带你完成第一次注入和传输。

先说清楚：这个工具到底解决什么问题

NS-USBloader 是一款运行在 PC 端的开源工具，服务对象是 Switch 破解用户。它替你把三件最琐碎的事变得可见、可点、可拖拽：

它同时支持Awoo Installer（含兼容工具）与 Goldleaf 两类安装器，USB 和网络两种传输通道，还覆盖 Windows、macOS（含 Apple Silicon）和 Linux（含树莓派）。如果你经常在这些流程里来回折腾，它值得一试。

起步篇：安装到第一次启动，5 分钟走完

项目本身是 Java 应用，分发物就是一个 jar 包，但不同系统的"前戏"略有差别。

1. 装好 Java 运行环境。macOS 和 Linux 建议直接上 JDK 17 及以上；Windows 用户双击 jar 前也先确认系统里已有 JRE。
2. 拿对 jar 包。macOS 上的 Apple Silicon（M1/M2）机器请使用文件名带-m1后缀的版本，并额外执行一次brew install libusb；其余平台用无后缀的普通包即可。
3. Windows 装驱动。首次打开软件后，点设置（齿轮）图标，选择"Download and install drivers"，按提示装完 USB 驱动，这是后面能识别到 Switch 的前提。
4. Linux 加 udev 规则（非 root 用户使用需要）。在/etc/udev/rules.d/99-NS-RCM.rules写入下面两行，然后重载规则：

SUBSYSTEM=="usb", ATTRS{idVendor}=="0955", ATTRS{idProduct}=="7321", MODE="0666" SUBSYSTEM=="usb", ATTRS{idVendor}=="057e", ATTRS{idProduct}=="3000", MODE="0666"

5. 启动。终端执行java -jar NS-USBloader.jar，或直接双击 jar。窗口顶部是主传输界面，左侧五个图标分别对应：传输、RCM 注入、分割合并、设置、日志。

到这里环境就绪。首次使用建议先到设置里把语言切到简体中文（多语言支持是项目特性之一，中文由社区贡献者长期维护），顺便把"自动检查更新"打开，保持版本跟得上协议变动。

当你想给 Switch 注入 payload 时

RCM 注入是破解流程里的高频动作，这里也是最容易出问题的环节。进入 RCM 标签页后：

1. 准备一个 payload 文件，常见的有hekate.bin、Lockpick_RCM.bin，直接拖进列表或点文件夹图标选择。
2. 界面提供5 个 payload 槽位，可以预先存好几份常用引导文件，下次直接点选，不用再翻目录。文件选择后程序会做一次内置校验，明显损坏的文件会被拦下。
3. 让 Switch 进入 RCM 模式：彻底关机 → 按住音量加不松手 → 短按电源键 → 插入 USB 数据线。屏幕保持黑屏是正常的，这代表模式进入成功。
4. 点击 "Inject payload"。

注入过程会实时打印到日志页，从设备被识别到 payload 发送完成，每一步都有状态反馈。

日志里出现类似 "RCM PASS" 的结果，hekate 的菜单就会在 Switch 屏幕上亮起来。

当你想通过 USB 把 NSP 传给 Switch 时

回到主传输界面，顶部下拉框选择你 Switch 端使用的安装器，然后：

1. 选协议：Goldleaf 走 USB，Awoo Installer 及兼容工具可选 USB 或 NET。
2. 加文件：点 "Select NSP files"，或直接把文件拖进窗口。可以多选、可以反复追加，列表里每行一个文件，勾选框决定哪些文件参与本次传输。
3. 点 Upload：勾好后点 "Upload to NS"，等待列表状态变为 Uploaded。

有个细节值得记住：列表里的 Uploaded 只代表文件完整发送到了 Switch，不代表安装成功。安装是否完成，取决于 Switch 端安装器（Awoo 或 Goldleaf）的反馈，这也是本工具的边界——它把"传文件"这一件事做到干净利落。

Goldleaf 用户传完文件后，在 Switch 上进入 "Explore content" → "Remote PC (via USB)"，会看到两个虚拟盘：HOME:/指向你的电脑目录，VIRT:/对应刚才列表里勾选的文件。

当你想通过局域网传文件时

Awoo Installer 的网络安装协议（也叫 Awoo 协议）同样被支持。切换到 NET 模式后，填上 Switch 的 IP 地址（例如 192.168.1.150），其余不用动。设置页里有个选项叫 "Don't serve requests"，它的作用是把文件地址直接告诉 Awoo、由你自建 HTTP 服务提供文件——多数人用不上，但知道它存在，遇到奇怪的网络环境时能多一条思路。

当你想拆分或合并大文件时

FAT32 格式的 SD 卡单文件不能超过 4GB，这是 Switch 玩家最常撞上的墙。分割合并标签页就是为它准备的：

1. 选Split（分割）或Merge（合并）。
2. 添加文件，分割时记得点 "Change" 设置输出目录。
3. 点 "Convert"，剩下的交给程序。

合并方向同样支持：把 Switch 端导出后被拆散的文件重新拼成一个。传输到 Switch 前先分割、拿到分片后先合并，这两个动作在同一个界面里来回切换即可。

实战篇：把三个功能串成一次完整操作

假设你刚下载了一个 6.2GB 的游戏 XCI 文件，目标是传到 Switch 安装。完整流程是这样的：

1. 打开分割合并标签页，选Split，添加 XCI，输出到桌面。
2. 点 Convert，得到一个文件夹，里面是若干小于 4GB 的分片。
3. 回到主传输界面，把分片文件夹整个拖进去（程序识别分片目录），或直接拖完整文件，勾选后点 Upload 发到 Switch。
4. 游戏装好后，需要再次进入自定义系统时，切到 RCM 标签页，注入 hekate，收工。

全程不用开一次终端、不用记任何参数——这也正是这类工具存在的意义。

进阶篇：命令行模式，把重复操作交给脚本

如果你偏好脚本化，NS-USBloader 提供与 GUI 等价的命令行接口，核心入口就是 jar 包本身：

# 注入 payload java -jar ns-usbloader-4.0.jar -r /path/to/hekate.bin # 通过 Awoo 网络模式传输文件（nsip 必填，hostip 可省略） java -jar ns-usbloader-4.0.jar -n nsip=192.168.0.1 ./game.nsp ./game.nsz # 分割目录下所有 NSP java -jar ns-usbloader-4.0.jar -s /tmp/ ~/*.nsp # 合并目录下的分片 java -jar ns-usbloader-4.0.jar -m /tmp/ ~/*.nsp # 查看所有参数 java -jar ns-usbloader-4.0.jar --help

参数以单个字母为主：-r注入、-nAwoo 网络、-tAwoo USB、-gGoldleaf（注意需带ver=指定 Goldleaf 版本）、-s分割、-m合并、-c重置设置。想了解每个子命令的完整参数，在它后面加help即可，比如-n help。

排障篇：四个高频问题一次说清

问题：电脑检测不到 RCM 设备原因多为驱动或权限。Windows 重新安装一次驱动并换一个 USB 口试试；Linux 检查 udev 规则是否生效（lsusb里应能看到0955:7321）；macOS 确认装的是-m1版本且 libusb 已安装。

问题：注入成功但 Switch 没反应先确认 payload 文件本身完整、与你机器型号匹配；再检查电池电量，电量过低时注入常会失败。最后重新进一次 RCM 模式重试。

问题：文件显示 Uploaded 但 Switch 端没安装Uploaded 只代表传输完成。此时应看 Switch 端安装器的报错信息——常见原因是文件格式不支持，或安装器版本与 PC 端协议不匹配。Goldleaf 用户请核对版本兼容性：Goldleaf v1.2.0 以上需要 NS-USBloader v6.0 及以上版本支持。

问题：从 Goldleaf 回传文件到电脑后文件损坏从 Switch 向 PC 写文件时，要先在 Goldleaf 里正常结束传输（"Stop execution"），再等待几秒确认写入完成，否则文件可能没落盘。

写在最后

NS-USBloader 的价值不在功能多，而在把三件高频的、本应繁琐的事，收拢成一个所有人都能上手的界面。源码结构也不复杂，传输逻辑在 src/main/java/nsusbloader/，RCM 注入的核心在Controllers/RcmController.java，命令行入口在cli/CommandLineInterface.java，想深入了解协议实现可以直接翻看。如果你需要动手试一把，可以用git clone https://gitcode.com/gh_mirrors/ns/ns-usbloader拉取源码自己构建，或在发行页下载现成 jar。希望这篇 NS-USBloader 使用教程能帮你少走一点弯路——就像它当年帮我省下的那个晚上。

【免费下载链接】ns-usbloaderAwoo Installer and GoldLeaf uploader of the NSPs (and other files), RCM payload injector, application for split/merge files.项目地址: https://gitcode.com/gh_mirrors/ns/ns-usbloader