HeadlessHaystack 项目教程

HeadlessHaystack 项目教程

headless-haystack Create your own AirTag with OpenHaystack, but without the need to own an Apple device 项目地址: https://gitcode.com/gh_mirrors/he/headless-haystack

1、项目介绍

HeadlessHaystack 是一个开源项目，旨在简化自定义蓝牙设备与苹果 FindMy 网络的集成过程。该项目特别为那些希望利用苹果 FindMy 生态而无需真正 Mac 电脑和额外软件安装的开发者设计。通过 HeadlessHaystack，你可以通过一个无头 MacOS 环境，轻松地管理你的定制蓝牙设备，实现了跨平台的创新解决方案。

2、项目快速启动

2.1 环境准备

在开始之前，请确保你的系统满足以下要求：

• Docker 已安装
• Python3 和 pip3 已安装
• 拥有一个启用了 2FA（双因素认证）的 Apple ID，且仅支持短信/文本消息作为第二因素

2.2 硬件设置

1. 访问 Releases 页面，下载 generate_keys.py 和所需的固件（ESP32 或 NRF5x）zip 文件。
2. 执行 generate_keys.py 脚本生成密钥对（注意：需要依赖 cryptography，可以使用 pip install cryptography 安装）。
3. 解压固件并将其刷入你的设备（参考 Install ESP32-firmware with your key 或 Install NRF5x-firmware with your key）。

2.3 服务器设置

1. 创建一个新的 Docker 网络：

   docker network create mh-network
   

2. 安装 Anisette Server：

   docker run -d --restart always --name anisette -p 6969:6969 --volume anisette-v3_data:/home/Alcoholic/config/anisette-v3/lib/ --network mh-network dadoum/anisette-v3-server
   

3. 启动并设置 Macless Haystack 端点：

   docker run -it --restart unless-stopped --name macless-haystack -p 6176:6176 --volume mh_data:/app/endpoint/data --network mh-network christld/macless-haystack
   

4. 按照提示输入你的 Apple ID 和密码，以及 2FA 验证码。如果看到 serving at port 6176 over HTTP，说明设置成功。

5. 在后台重启服务器：

   docker restart macless-haystack
   

2.4 前端设置

你可以选择使用 GitHub 提供的前端，或者自己托管 Web 服务器，也可以使用 Android 应用程序。如果前端和端点不在同一台机器上，需要在设置中配置 URL。

3、应用案例和最佳实践

3.1 应用案例

HeadlessHaystack 可以用于创建自定义的 AirTag 替代品，适用于需要追踪物品但不想购买官方 AirTag 的用户。例如，你可以将自定义设备安装在自行车、宠物项圈或其他需要追踪的物品上。

3.2 最佳实践

• 安全性：确保你的 Apple ID 和设备固件的安全性，避免泄露敏感信息。
• 性能优化：根据设备的电池寿命和性能需求，选择合适的固件和配置。
• 跨平台兼容性：确保你的设备和前端在不同平台上的兼容性，提供良好的用户体验。

4、典型生态项目

HeadlessHaystack 融合了多个重量级开源项目，包括但不限于：

• OpenHaystack：提供了 Android 应用和 ESP32 固件，是 HeadlessHaystack 的基础。
• Biemster's FindMy：优化了密钥对生成器，支持 ESP32 固件和 Android 应用的导入。
• Positive Security's Find You：对 ESP32 固件进行了电池优化。
• acalatrava's OpenHaystack-Firmware：提供了 NRF5x 固件的优化版本。

这些项目共同构成了 HeadlessHaystack 的生态系统，为用户提供了丰富的功能和灵活的选择。

headless-haystack Create your own AirTag with OpenHaystack, but without the need to own an Apple device 项目地址: https://gitcode.com/gh_mirrors/he/headless-haystack