iPhone 配对文件指南:生成、导入和修复方法(2026)

作者Scarlet iOS Team 更新时间

配对文件是一个小文件，它能让 iPhone 上的某个应用与 iPhone 自身的开发者服务进行通信，其作用方式与一台受信任的电脑相同。SideStore、StikDebug、LiveContainer、Feather、KSign 以及其他几款 sideloading 应用都需要用到它，而“配对文件无效”正是它们停止工作最常见的原因之一。本指南将说明这个文件是什么、有哪些制作方法、如何把它导入应用、为什么它会失效，以及如何保证它的安全。最后核实时间:2026 年 11 月 2 日,核对依据为 iloader、idevice_pair 和 StikDebug 的 GitHub 页面以及 SideStore 的文档。

简要说明

  • 配对文件(通常是 .plist 或 .mobiledevicepairing 文件)是一份记录，表明你的 iPhone 信任某台“电脑”。应用利用它在不接线的情况下访问 iPhone 的开发者服务。
  • 它是针对某一台设备专属的。为一台 iPhone 制作的文件不能用在另一台上。
  • 制作并放置它最简单的方法是在 Mac、Windows 或 Linux 电脑上使用iloader。idevice_pair 和 Impactor 也能做到。
  • 重置 iPhone 或更改其密码时它会失效，这种情况常发生在 iOS 更新之后，有时也会随机发生。解决办法是重新制作一个。
  • 要像对待密码一样对待它：绝不要分享它，也不要下载别人制作的配对文件。

配对文件是什么

当你把 iPhone 连接到电脑并点击信任时，两台设备会交换密钥，电脑会保存一份“配对记录”。有了这份记录，电脑就能使用 iPhone 的开发者服务：安装应用、读取日志、启动调试器。配对文件就是这份记录的副本，你把它交给 iPhone 上的某个应用。该应用随后就会扮演那台受信任电脑的角色，通过本地回环连接（通常借助 LocalDevVPN 这类小型 VPN 应用）与 iPhone 通信，从而在没有电脑的情况下完成这些工作。

StikDebug 的指南将该文件描述为“设备专属”,StikDebug 的 README 将其列为 .plist 或 .mobiledevicepairing 两种格式之一。配对文件分为两类：传统的 lockdown 配对，适用于所有 iOS 版本；以及远程配对（RPPairing）,需要 iOS 17.4 或更高版本。

哪些应用需要它

  • SideStore,用于在设备上安装和刷新应用。
  • StikDebug,用于为模拟器等应用启用 JIT。
  • LiveContainer,在与 SideStore 一起安装时需要。
  • Feather 和 KSign,它们可以用它来安装应用。
  • 一些较小的工具，例如 Protokolle、Antrag 和 SparseBox,idevice_pair 中也列出了这些。

Scarlet iOS 不使用配对文件。它用自己的证书安装应用，完全不需要任何电脑设置。

如何制作配对文件

下面三款电脑端工具都是免费开源的。请只从它们的 GitHub 页面下载（iloader 也可以从 iloader.app 下载）;iloader 页面特别提醒不要从其他网站下载它。开始之前，请先给 iPhone 设置密码，并在配对过程中让它保持解锁状态、停留在主屏幕。

方法一:iloader（最简单）

  1. 在 Windows 上，请先安装 iTunes（它会带来所需的 USB 驱动）。在 Linux 上，如果缺少 usbmuxd 请先安装它。Mac 不需要额外安装任何东西。
  2. 从其 GitHub 发布页或 iloader.app 安装 iloader 并打开它。
  3. 用 USB 数据线连接 iPhone,如果提示就点击信任。
  4. 点击管理配对文件（Manage Pairing File）。
  5. 在你想要配对的每个应用旁点击放置（Place）,例如 StikDebug 或 SideStore。成功后会以绿色显示“Pairing file placed successfully!”。

当 iloader 为你安装 SideStore 或 LiveContainer + SideStore 时，它会自动放置配对文件，所以只有在替换旧文件或添加其他应用时，才需要执行上述步骤。

方法二:idevice_pair

idevice_pair（由 jkcoxson 开发，版本 1.1.0）是一个只用于制作配对文件的小工具。选择设备，选择 Lockdown 或 Remote pairing,点击 Create,然后可以选择保存为文件（Save to file）,或者点击某个应用的名称，直接将文件写入该应用。它还能检查新文件是否真的可用，这在某个应用一直拒绝你的文件时会很有帮助。

方法三:Impactor

Impactor（前身为 PlumeImpactor）在设备连接后会出现一个 Utilities 页面。在那里它可以安装 SideStore 或 LiveContainer、重新信任设备，并将配对文件放入受支持的应用中。

无需电脑（仅限较新设备）

StikDebug 内置了一个配对菜单（设置，然后 Pair a Device），但其指南说明这只适用于 iOS/iPadOS 27 或更高版本的设备，以及 Apple TV。在较旧的版本上，你仍然需要用一次电脑。

如何将它导入应用

如果你使用了 iloader 或 idevice_pair 的“放置（place）”选项，就已经完成了。如果你是把文件保存了下来，那就把它传到 iPhone 上（通过 AirDrop、文件 App 或 iCloud Drive），然后打开对应的应用:

  • StikDebug: 点击选择配对文件（Select Pairing File）并选中该文件。
  • SideStore: 它会在首次启动以及旧文件失效时要求提供该文件。
  • Feather / KSign: 两者都提供导入配对文件的选项；请按应用自身的说明操作，因为各版本之间菜单名称会有变化。

然后打开应用所使用的回环 VPN(StikDebug 和 SideStore 使用 LocalDevVPN),并保持连接 Wi-Fi。

为什么配对文件会失效

  • 更改或重置密码: StikDebug 的指南提醒，重置或更改密码会使文件失效。
  • iOS 更新或设备重置: SideStore 的文档说明，更新或重置设备后该文件“可能会失效”,并且也会“在随机时间”失效，这属于 Apple 那一侧的因素。
  • 设备不匹配: 来自另一台 iPhone 的文件，或者恢复之前生成的文件，都无法使用。
  • VPN 未开启: StikDebug 中出现“heartbeat”或“connection dropped”之类的错误，通常意味着 VPN 未开启或未连接 Wi-Fi,而不是文件本身有问题。

解决办法几乎总是一样的：将 iPhone 连接到电脑，保持解锁状态，重新制作并放置一个新文件。在 iloader 中，先用删除已存配对（Delete Stored Pairing）清除旧文件，然后在 iPhone 上再次点击信任。对于 SideStore 特有的提示，例如“The current pairing file is invalid”,可参阅我们的SideStore 错误说明指南。

配对文件安全吗?

持有它的人会获得与一台受信任电脑相同的访问权限，所以要像对待密码一样对待它。不要把它发到 Discord 聊天里，也不要“为了求助”上传到某个网站，更不要使用别人为你制作的配对文件；那样做反正也不会有用，因为它是与你的设备绑定的。如果你怀疑文件已经泄露，取消信任即可重置：在 iPhone 上前往“设置 > 通用 > 传输或还原 iPhone > 还原 > 还原定位与隐私”,这样会让所有电脑重新弹出信任提示。然后重新制作一个新文件。

配对文件还是 Scarlet?

配对文件属于自己动手的路线：你自己的 Apple 账号、自己的证书、一次性的电脑设置，以及免费账号每 7 天一次的刷新，这些 SideStore 都能在设备上完成。Scarlet iOS 跳过了这一切：不需要电脑，不需要 Apple 账号，也不需要配对文件，因为它提供证书。这个证书是共享的，所以 Apple 可能会将其吊销。我们的免费 sideloading 工具对比指南将两条路线并排展示。想试试 Scarlet,可查看Scarlet iOS 安装方法,或从我们的 Scarlet iOS 安装页面开始。

常见问题

配对文件保存在电脑的哪个位置？
电脑会把配对记录保存在自己的 lockdown 文件夹中，但你不需要去找它。iloader 和 idevice_pair 会自动为你生成并导出该文件。

一个配对文件可以用于两台 iPhone 吗？
不可以。每个文件只针对一台设备生成。

每次 iOS 更新后都需要重新生成文件吗？
不是每次都需要，但情况常常如此。如果更新后某个应用提示配对文件无效或缺失，就需要重新生成一个。

生成配对文件需要付费开发者账号吗？
不需要。生成配对文件只需要一台 iPhone 信任的电脑。使用该文件的应用仍然是用你自己的 Apple Account 签名的，受 Apple 对免费账号的常规限制。

类似文章