news 2026/8/27 16:42:32

NS-USBloader 新手指南：Switch NSP 文件传输、RCM 注入与文件拆分合并

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
NS-USBloader 新手指南：Switch NSP 文件传输、RCM 注入与文件拆分合并

NS-USBloader 新手指南：Switch NSP 文件传输、RCM 注入与文件拆分合并

【免费下载链接】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

NS-USBloader 是一款运行在 Windows、macOS、Linux 上的 PC 端图形化工具，可以把 NSP、XCI 等文件发送到 Switch（支持 Awoo 与 Goldleaf 两款主机端安装程序）、向 RCM 模式的主机注入 payload 文件，并拆分、合并大文件。下面按你要完成的任务，讲解从安装到进阶的完整流程。

适合什么样的使用场景

  • 主机端已装好 Awoo 或 Goldleaf，需要把电脑里的 NSP / XCI 文件经 USB 或网络传到 Switch 上安装。
  • 主机已进入 RCM 模式（一种通过短接特定引脚或改装芯片进入的恢复模式），需要注入 Hekate、Lockpick_RCM 等 payload 文件。
  • 单个游戏文件超过 4GB，FAT32 格式的存储卡放不下，需要拆分成小文件，传输后再合并还原。

安装与首次运行

Windows

  1. 双击下载好的.jar文件启动（系统需已安装 Java）。
  2. 首次打开后点击左侧齿轮图标，点击「Download and install drivers」，按提示安装 USB 驱动——这是 Windows 下连接 Switch 的必要步骤。

macOS

  • 双击 JAR 即可运行；若系统弹出安全提示，到「安全性与隐私」设置中允许运行。
  • Apple Silicon（M 系列芯片）机器需下载带-m1后缀的版本，并先用 Homebrew 安装 libusb：
# 为 Apple Silicon 安装 libusb brew install libusb
  • 官方建议 macOS 用户使用 JDK 19；仍有用户在 JDK 14 上报告过问题。
  • macOS Mojave 之前的老系统请下载带-legacy后缀的版本（内部 usb4java 库版本不同导致）。

Linux 与 Raspberry Pi

# 安装 JDK（Debian/Ubuntu 系） sudo apt install default-jdk
# 用 Java 启动应用 sudo java -jar /path/to/NS-USBloader.jar

Raspberry Pi 用户还需安装 JavaFX：sudo apt install openjfx。为免每次用 root 运行，需添加 udev 规则，让普通账户能访问 USB 设备：

# 新建规则文件：一条针对 RCM 模式设备(0955:7321)，一条针对 Awoo USB 传输设备(057e:3000) sudo vim /etc/udev/rules.d/99-NS.rules

文件内容写入两行：

SUBSYSTEM=="usb", ATTRS{idVendor}=="0955", ATTRS{idProduct}=="7321", MODE="0666" SUBSYSTEM=="usb", ATTRS{idVendor}=="057e", ATTRS{idProduct}=="3000", MODE="0666"
# 重新加载 udev 规则使其生效 sudo udevadm control --reload-rules && sudo udevadm trigger

高分屏上界面偏小时，可用java -Dglass.gtk.uiScale=150% -jar NS-USBloader.jar按 150% 缩放界面。

第一次发送 NSP 文件（主界面）

开始前，先在 Switch 上装好 Awoo 或 Goldleaf，并在其中开启「USB 安装」或「网络安装」选项。然后：

  1. 顶部下拉框选择目标应用（Awoo 或 Goldleaf）与协议（USB 或 NET；Goldleaf 仅支持 USB），网络方式下填入主机 IP。
  2. 通过「Select files」按钮或拖拽把文件加入表格，可多次添加、多选；空格键勾选/取消，Delete 删除选中项，右键菜单可清空列表。
  3. 点击「Upload to NS」开始传输。

两个容易误解的细节：表格中状态显示「Uploaded」只表示文件已成功发送到主机，不代表安装成功——安装结果由主机端应用自行处理，NS-USBloader 拿不到安装反馈。使用 Goldleaf v0.6.1 时，需在 Goldleaf 里通过「Explore content → Remote PC (via USB)」看到HOME:/与VIRT:/两个盘符，从VIRT:/选择要安装的文件。

RCM 模式注入 payload 文件

  1. 将 Switch 进入 RCM 模式并用 USB-C 线连接电脑。
  2. 切到 RCM 标签页，选择或拖入 payload 文件（Hekate、Lockpick_RCM 均可，应用会做基本的格式校验）。
  3. 点击「Inject payload」，等待日志出现「Payload complete」即可断开。

拆分与合并大文件

  1. 进入拆分合并标签页，选择 Split（拆分）或 Merge（合并）。
  2. 拖入或选择文件，用「Change」指定输出目录。
  3. 点击「Convert」执行；拆出的多个分卷拷入 FAT32 存储卡即可，合并时把同一文件的各分卷一起选入即可还原。

设置页：语言、驱动与网络传输选项

常用选项：

  • Language：切换界面语言，内置十余种语言，含简体中文。
  • Select folder with ROM files…：勾选后「Select files」改为按文件夹整批添加受支持的文件。
  • Allow XCI / NSZ / XCZ files selection for Awoo：允许 Awoo 协议传输 XCI/NSZ/XCZ 文件。
  • Goldleaf 区域：可设置 Goldleaf 版本下拉框，并勾选只显示*.nsp文件以过滤HOME:/盘符内容。
  • Expert mode (NET setup)：高级网络配置，可关闭 Auto-detect IP、手动指定端口，或使用「Don't serve requests」——此时软件不再启动内置 HTTP 服务器，而是直接告诉 Awoo「去你指定的地址取文件」，需要你自己用 nginx 等服务把文件暴露出来。

主界面右上角的灯泡图标用于切换深色/浅色主题。

用日志页排查问题

三个点图标对应的标签页记录所有传输与注入的详细日志，[INFO]是过程信息，[PASS]表示关键步骤成功。三个常见问题：

  1. 现象：Windows 下连接后识别不到主机。原因：USB 驱动未装好。解决：到设置页点「Download and install drivers」重装驱动，或改用管理员权限运行。
  2. 现象：Linux 下操作 USB 设备报权限错误。原因：未加 udev 规则。解决：按上文写入规则文件后执行sudo udevadm control --reload-rules && sudo udevadm trigger。
  3. 现象：传输或注入中途失败。原因：多为 USB 接触不良或主机不在预期模式。解决：重新插紧线缆，确认主机处于 RCM / 目标安装模式后重试，并对照日志里 FAIL 之前的最后一条[PASS]定位卡在哪一步。

命令行用法 ⌨️

除图形界面外，程序提供完整的 CLI。运行java -jar ns-usbloader.jar --help查看全部选项，常用命令：

# 向 RCM 模式主机发送 payload java -jar ns-usbloader.jar -r /path/to/hekate.bin # 网络方式传输：指定主机 IP 与文件列表 java -jar ns-usbloader.jar -n nsip=192.168.1.100 ~/Games/*.nsp # 拆分文件，输出目录为 /tmp/ java -jar ns-usbloader.jar -s /tmp/ ~/Games/*.nsp # 合并拆分文件 java -jar ns-usbloader.jar -m /tmp/ ~/Games/*.nsp # 通过 Goldleaf v0.8 USB 模式安装 java -jar ns-usbloader.jar -g ver=v0.8 ./game.nsp

每个选项后再加help（如-n help）可看该选项的详细参数，例如-n支持hostip=ip[:port]手动指定本机地址。

与官方传输脚本的区别

对比项NS-USBloader官方 usb_install_pc.py / remote_install_pc.py
支持的安装器Awoo（USB+网络）、Goldleaf（USB）Awoo（USB/网络）
RCM payload 注入支持不提供
文件拆分 / 合并支持不提供
使用形态跨平台图形界面 + 命令行命令行脚本

Goldleaf 版本兼容性方面，项目支持 v0.5、v0.6.1、v0.7 系列、v0.8–0.9（需 NS-USBloader v1.0+）以及 v0.10–1.0.0 和 v1.2.0+（需 v6.0+）；v0.6 与 v1.1.0–1.1.1 无对应支持。当前项目版本为 7.3，版本号要求以发布说明为准。

适用边界

  • 它只是 PC 端工具，主机端必须预先装好 Awoo 或 Goldleaf，软件不负责安装它们。
  • 它不报告游戏是否安装成功，也不提供存档、系统管理等主机侧功能。
  • 遵循 GPLv3 协议开源，代码仓库可通过git clone https://gitcode.com/gh_mirrors/ns/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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/8/27 16:40:57

豆伴安全与隐私指南：Cookie会话机制与扩展权限深度解析

豆伴安全与隐私指南：Cookie会话机制与扩展权限深度解析 【免费下载链接】tofu Chrome 扩展，用于备份豆瓣账号的数据，并支持导出 Excel 文档。 项目地址: https://gitcode.com/gh_mirrors/tofu1/tofu 豆伴是一款用于豆瓣账号备份的 Chr…

作者头像 李华
网站建设 2026/8/27 16:37:50

PaperTodo 完整指南：Windows 桌面待办便签工具

PaperTodo 完整指南：Windows 桌面待办便签工具 【免费下载链接】PaperTodo 极简 Windows 桌面便签工具。让桌面上有几张安静、可用、不会打扰人的纸。WPF 原生，支持待办与 Markdown。——A minimalist Windows desktop sticky note tool. It puts a few …

作者头像 李华
网站建设 2026/8/27 16:36:06

105、增强概念与SAP标准程序修改

105、增强概念与SAP标准程序修改 调一个物料凭证过账的问题，用户在MIGO里输入自定义字段，回头查凭证发现字段没存上。我SAP也没有后台配置可勾，只能硬着头皮去看标准代码。T-code SI80还是SE24？忘了，反正进程序里跟着断点走，追到某个BAPI调用之前，发现标准逻辑根本没打…

作者头像 李华
网站建设 2026/8/27 16:33:38

FanControl风扇控制软件：画一条曲线，让机箱安静

FanControl风扇控制软件：画一条曲线，让机箱安静 【免费下载链接】FanControl.Releases This is the release repository for Fan Control, a highly customizable fan controlling software for Windows. 项目地址: https://gitcode.com/GitHub_Trendi…

作者头像 李华
网站建设 2026/8/27 16:33:25

gibMacOS：在 Windows 和 Linux 上快速拿到 macOS 官方安装镜像

gibMacOS：在 Windows 和 Linux 上快速拿到 macOS 官方安装镜像 【免费下载链接】gibMacOS Py2/py3 script that can download macOS components direct from Apple 项目地址: https://gitcode.com/gh_mirrors/gi/gibMacOS 手边只有一台 Windows 开发机&#…

作者头像 李华