3分钟把CIA拖进3DS：3DS FBI Link 无线推送工具上手全记录

【免费下载链接】3DS-FBI-Link Mac app to graphically push CIAs to FBI. Extra features over servefiles and Boop. 项目地址: https://gitcode.com/gh_mirrors/3d/3DS-FBI-Link

在 Mac 上把 CIA 文件无线推给 3DS，到底能有多省事？开源的 3DS FBI Link 给出的答案很直接：三步操作，外加一次拖拽。折腾过 3DS 自制系统的朋友都知道，下载游戏文件从来不是问题，传输才是——反复拔插 SD 卡，或者开着终端敲一串记不住的命令，还要祈祷端口没被占用。这款工具想做的，就是让 Mac 和 3DS 连上同一个 WiFi 后，文件能像 AirDrop 一样直接"丢"进主机。

它的定位一句话能说清：一个 macOS 图形界面应用，把 CIA 文件推送给运行 FBI 的 3DS，同时补上了 servefiles 和 Boop 这两款同类方案缺失的功能。


三步完成第一次传输：3DS FBI Link 快速上手

不用编译、不用命令行，跑通最小可用流程只要三步：

1. 让 3DS 进入接收状态：在主机上打开 FBI，进入 "Receive URLs over the network"，屏幕会显示本机 IP 和端口（默认 5000）。
2. 打开 Mac 端应用：设备列表里没自动出现你的 3DS 时，点 "+" 手动填入屏幕上的地址和端口即可。
3. 拖入文件，点 Start：把 CIA 文件或整个文件夹直接拖进窗口，也可以粘贴一条网络直链，然后点 Start，3DS 端就开始下载了。

想从源码自己构建也很快：pod install 装上两个依赖（CocoaAsyncSocket 负责设备通信，GCDWebServer 提供文件下载服务），再打开 3ds FBI Link.xcworkspace 就能跑。需要留意的是，构建环境要求 macOS 10.12+ 和 Xcode 8，代码基于 Swift 3 编写。

相比 Boop 和 servefiles，它赢在哪儿

这个领域不是没有工具，但 3DS FBI Link 解决的恰恰是它们最别扭的地方：

• 双击即用，零命令行：保留了 Boop 的设备自动发现思路，但不用为了传个文件去碰终端或 WINE。
• 文件可以在电脑任何位置：不少工具要求所有 CIA 集中在同一个文件夹，它不需要——应用给每个文件生成独立 URL，文件散落在哪儿都能找到。
• 端口随机分配：HTTP 服务用 withPort: 0 启动，让系统挑一个空闲端口，彻底绕开 8080 被占用的老问题。
• 多台设备同时传：设备列表里加几台就传几台，应用给每台 3DS 都发一份下载清单，全部完成自动收工。
• 本地文件与网络直链混搭：GitHub 上的 CIA 直链和本地文件能放进同一个列表，一次开始全部下发。

设备发现是它最聪明的一笔：应用读取 arp -a 的输出，用正则匹配任天堂设备的 MAC 前缀（比如 e8:4e:ce、e0:e7:51 这类），命中就自动加入列表，端口先按 5000 猜，全程不需要你填任何网络配置。

下发数据的协议也很轻巧：一个 4 字节大端序长度头，加上换行分隔的 URL 列表，核心就两行代码：

var urlDataCount: UInt32 = UInt32(urlData.count).bigEndian
dataPayload.append(Data(bytes: &urlDataCount, count: 4))

3DS 收到后按清单逐个下载，最后回传一个字节表示"搞定"，连接自动断开。

实测表现与典型用法

作者在 New 3DS 上实测，传输速度最高到 1.3MB/s 左右，已经接近这台机器的无线传输上限。至于老款 3DS，作者手头只有一台主机，还没法亲自验证，这也是他公开征集测试反馈的原因之一。

几个特别值得用的场景：

• 应用开发者：出了新版本，几台测试机同时推送，比一台台拷 SD 卡高效太多。
• Homebrew 玩家：把现成的 CIA 直链粘进来，省掉"先下载再拖拽"的两步操作。
• 临时装工具：随便哪个文件夹里的 CIA 都能拖进去发，不用先归置到统一目录。

新手最容易踩的四个坑

1. 抄错端口：以 FBI 接收页面显示的端口为准，别想当然以为永远是 5000。
2. 发现不了设备就以为坏了：先确认 Mac 和 3DS 在同一个子网、3DS 停在接收页面，再查防火墙有没有拦掉随机端口——多数情况不是应用的问题。
3. 文件夹里混着非目标文件：拖入文件夹时应用会递归扫描、只挑 .cia 和 .tik，这是设计行为而不是漏文件，想精确控制就单独拖文件。
4. 直链粘贴不对：GitHub 上要复制 raw 直链而不是页面地址，否则 3DS 拿到的是 HTML 而不是安装包。

另外，作者在待办里提到文件名带 emoji 这类特殊字符的边界情况还没完全处理，碰到怪名字的文件，先改成简单文件名再传最稳妥。

社区、待办与你能帮的忙

项目作者很坦诚：多设备同时传输的逻辑写好了，但他只有一台 3DS 可测；老款机型的兼容性也需要更多人确认。如果你手头正好有闲置的主机，帮忙跑一次传输、顺手反馈结果，就是最有价值的贡献。

目前列出的待办方向包括：更完善的边界检查（emoji 文件名、连接状态检测）、多网络连接支持、自动更新检查、状态栏自动滚动等 UI 打磨，以及做一版 Apple 开发者签名版本方便启动。任何一条都欢迎认领。

现在就去试一次

3DS FBI Link 把"无线传 CIA"这件事收敛成了三个动作：打开 FBI 接收页、拖进文件、点 Start。不用记任何命令，不用担心端口冲突，剩下的事应用都替你安排好了。

想动手的话，克隆仓库、跑一遍构建，或者直接把应用装上连一次传输：

git clone https://gitcode.com/gh_mirrors/3d/3DS-FBI-Link

下次再往 3DS 里装东西，不妨让 3DS FBI Link 帮你省掉拔卡插卡的来回折腾——拖拽一下，剩下的交给 WiFi 就行。

【免费下载链接】3DS-FBI-Link Mac app to graphically push CIAs to FBI. Extra features over servefiles and Boop. 项目地址: https://gitcode.com/gh_mirrors/3d/3DS-FBI-Link