开源项目 headless-haystack 使用教程

开源项目 headless-haystack 使用教程

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

项目介绍

headless-haystack 是一个开源项目，旨在简化自定义蓝牙设备与苹果的 FindMy 网络的集成。该项目的主要目标是允许用户在没有实际 Mac 设备的情况下运行一个无头（headless）的 MacOS 系统，并且无需安装邮件插件或 OpenHaystack 本身。通过该项目，用户可以获取位置数据，并将其用于各种应用场景。

项目快速启动

环境准备

• Docker 安装
• Python3 和 pip3 安装
• 启用 2FA 的 Apple-ID

快速启动步骤

1. 克隆项目仓库

   git clone https://github.com/dchristl/headless-haystack.git
   cd headless-haystack
   

2. 生成密钥对

   python3 generate_keys.py
   

3. 设置 Docker 网络

   docker network create mh-network
   

4. 安装 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
   

5. 启动 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
   

6. 输入 Apple-ID 和 2FA 信息

   在终端中输入你的 Apple-ID 和 2FA 信息，完成后会看到 serving at port 6176 over HTTP 的提示。

7. 后台重启服务器

   docker restart macless-haystack
   

应用案例和最佳实践

应用案例

• 家庭共享物品追踪：通过结合 OpenHaystack 和 OwnTracks，家庭成员可以共享位置信息，追踪共享物品如雨伞或家庭车辆。
• 个人物品防丢：使用 OpenHaystack 标记个人物品如钥匙、手机等，防止丢失。

最佳实践

• 定期更新固件：确保设备固件始终是最新版本，以获得最佳性能和安全性。
• 使用强密码：为 Apple-ID 设置强密码，并启用 2FA 保护账户安全。
• 监控日志：定期检查 Docker 容器日志，确保服务正常运行。

典型生态项目

• OpenHaystack：用于创建追踪标签，利用 Apple 的 AirTag 位置框架。
• OwnTracks：开源的位置共享系统，与 OpenHaystack 结合使用，提供强大的开源物品追踪解决方案。
• Anisette Server：用于模拟苹果设备，支持无头 MacOS 系统的运行。

通过以上步骤和案例，您可以快速启动并使用 headless-haystack 项目，实现自定义蓝牙设备与苹果 FindMy 网络的集成。

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