OpenHaystack 开源项目教程

1. 项目介绍

OpenHaystack 是一个开源项目，旨在通过 Apple 的 Find My 网络来追踪个人蓝牙设备。该项目允许用户创建自己的追踪标签，这些标签可以附加到物理对象（如钥匙链、背包等）或集成到其他蓝牙设备（如笔记本电脑）中。通过使用 OpenHaystack，用户可以在全球范围内追踪他们的设备，即使在没有蜂窝网络覆盖的区域。

2. 项目快速启动

2.1 系统要求

• macOS 11 (Big Sur) 或更高版本

2.2 安装步骤

1. 下载预编译的二进制文件： 从 GitHub 页面 下载预编译的二进制文件。

2. 安装 Apple Mail 插件： 打开终端并运行以下命令以禁用 Gatekeeper：

   sudo spctl --master-disable
   

   打开 Apple Mail，进入 Preferences → General → Manage Plug-Ins，并激活 OpenHaystackMail.mailbundle 插件。

3. 启用 Gatekeeper： 运行以下命令以重新启用 Gatekeeper：

   sudo spctl --master-enable
   

2.3 使用步骤

1. 添加新设备： 打开 OpenHaystack 应用，输入设备名称并选择图标和颜色。应用将生成一个新的密钥对，用于加密和解密位置报告。

2. 部署到设备： 通过 USB 连接支持的设备（如 BBC micro:bit），点击设备名称旁边的 Deploy 按钮，选择相应的设备进行部署。

3. 显示设备位置： 设备位置报告可能需要 30 分钟才能显示在地图上。点击设备图标可以查看上次更新的时间。点击刷新按钮可以更新位置报告。

3. 应用案例和最佳实践

3.1 追踪个人物品

OpenHaystack 可以用于追踪个人物品，如钥匙、钱包、背包等。通过将追踪标签附加到这些物品上，用户可以在丢失物品时通过 Apple 的 Find My 网络快速定位。

3.2 集成到蓝牙设备

OpenHaystack 还可以集成到其他蓝牙设备中，如笔记本电脑、平板电脑等。这使得用户可以在设备丢失或被盗时，通过 Find My 网络追踪设备的位置。

3.3 安全与隐私

OpenHaystack 强调安全和隐私，所有位置报告都是端到端加密的，只有拥有相应私钥的用户才能解密和查看位置信息。此外，OpenHaystack 不访问用户的电子邮件或其他私人数据。

4. 典型生态项目

4.1 OpenHaystack Mobile

OpenHaystack Mobile 是 OpenHaystack 的移动端应用，支持 Android 和 iOS 平台。该应用提供了与 macOS 应用相同的功能，允许用户在智能手机上创建和追踪设备。

4.2 FindYou

FindYou 是一个与 OpenHaystack 兼容的项目，专注于优化蓝牙设备的电池使用。通过结合 FindYou 项目，用户可以进一步延长追踪设备的电池寿命。

4.3 Anisette Server

Anisette Server 是一个用于模拟 Apple 设备的服务器，允许用户在没有实际 Apple 设备的情况下访问 Find My 网络。该项目与 OpenHaystack 结合使用，可以进一步简化设备的设置和追踪过程。

通过以上步骤和案例，用户可以充分利用 OpenHaystack 及其生态项目，实现个人蓝牙设备的全球追踪。