自制AirTag定位器成品使用FAQ

常见问题

主机上存储什么数据以及存储什么数据？

在安装过程中，会创建一个 Docker 卷 ( mh_data )，它位于默认文件夹中。这通常位于 下/var/lib/docker/volumes/mh_data/_data，但如果您的位置不同，您可以使用以下命令进行检查：

docker inspect macless-haystack-gitee | grep mh_data

查看Source键。该文件夹通常受到保护，只有 root 用户才能访问和修改。

在该文件夹中，您将找到配置 (config.ini) 和身份验证 (auth.json)（如果已执行）。此外，用于 SSL 的自签名证书也位于此处。

我如何才能看到日志？

您可以使用以下方式查看日志：

docker logs -f macless-haystack-gitee

或者命令行重新启动docker：

docker stop macless-haystack-gitee
docker start -ai macless-haystack-gitee

config.ini 有什么用处？

这里可以配置特定设置，例如，是否要使用另一个/现有的 Anisette 服务器，或者是否要提供用户名和密码。通常，这里不需要进行任何调整。

注册时出错

注册过程中，出现错误，例如：

It seems your account score is not high enough. Log in to https://appleid.apple.com/ and add your credit card (nothing will be charged) or additional data to increase it.

这种情况可能发生在未提供任何数据和/或设备的新帐户上。解决方案可能是添加付款方式（即信用卡）、使用真正的 Apple 设备注册您的帐户和/或在 Apple 向帐户添加更多数据。

有迹象表明，通过 Apple Music 新注册的账户不存在此问题。

不幸的是，由于 Apple 改变了机制，因此没有通用的解决方案。添加数据后，可以重新启动服务并重新输入 Apple-ID 和密码：

docker stop macless-haystack-gitee
docker start -ai macless-haystack-gitee

#立即开启另一个终端，执行下面命令重新启动服务器
docker restart macless-haystack-gitee

我如何确保运行的服务安全？

服务可以且应该得到保护，尤其是当它暴露在互联网上时。可以在 config.ini 文件中配置此身份验证（使用键 endpoint_user 和 endpoint_pass）。重新启动容器后，日志输出应指示身份验证成功。

当然，账户和密码还必须在前端应用程序中配置。

我如何托管我自己的 Web 前端？

你不应该这样做，因为没有理由这样做。最好使用 Atomgit 上的 Web 前端 Atomgit Page(http) 或 Atomgit Page(https) 。前端始终是最新的并且运行稳定。数据的安全问题在这里也不是问题，因为 Atomgit 只提供空白页面。所有数据（例如位置、密钥、请求频率等）都不会传输到任何地方。然后所有通信仅发生在你的系统（浏览器）和你自己部署的后台服务之间。

前端在发布版本中仍可供下载（webapplication.zip），并且可以自行托管。

如何更新 Docker 容器

通常不需要更新容器，因为它会在重新启动时自动更新。这可以通过使用

docker restart macless-haystack-gitee

启动时，容器会自动从此存储库获取最新状态。但是，如果需要更新容器（例如，如果在发行说明中提到），则可以删除旧容器并提取新容器：

docker rm -f macless-haystack-gitee
docker rmi lovelyelfpop/macless-haystack-gitee
docker run -d --restart unless-stopped --name macless-haystack-gitee -p 6176:6176 --volume mh_data:/app/endpoint/data --network mh-network lovelyelfpop/macless-haystack-gitee

由于数据被保留，通常不需要重新注册。

重新注册/更改账户

如果，如果您的服务激活成功，但您仍然无权访问或只是想切换您的帐户，则可以通过删除 auth.json 并重新启动容器来重新注册：

docker stop macless-haystack-gitee
sudo rm /var/lib/docker/volumes/mh_data/_data/auth.json
docker start -ai macless-haystack-gitee

#立即开启另一个终端，执行下面命令重新启动服务器
docker restart macless-haystack-gitee

我如何重置所有内容并重新开始？我如何彻底卸载 Macless Haystack？

您可以通过删除容器和数据来完全从头开始。之后，您可以从头开始：

docker rm -f macless-haystack-gitee
docker rmi lovelyelfpop/macless-haystack-gitee
docker volume rm mh_data
docker rm -f anisette
docker rmi dadoum/anisette-v3-server
docker volume rm anisette-v3_data
docker volume prune
docker network rm mh-network
docker network prune

如何使用 shell 访问正在运行的容器

您始终可以使用以下命令访问容器的 shell：

docker exec -it  macless-haystack-gitee /bin/bash -c "export TERM=xterm; exec bash"

如果服务和 UI 不在一台机器上运行，我该如何使用 SSL？

如果您想在与浏览器运行的机器不同的机器上使用 Macless Haystack，或者您想使用 SSL，则需要一些额外的步骤。您需要一个有效的证书，在服务器的文件夹中称为 certificate.pem，或者您可以以 root 身份将文件 rename_me.pem 重命名为 certificate.pem，并使用我的自签名证书。之后重新启动容器：

sudo su
cd /var/lib/docker/volumes/mh_data/_data
mv rename_me.pem certificate.pem
docker restart macless-haystack-gitee

如果你使用了自签名证书，浏览器会提示有风险，可以选择继续访问。你也可以申请 Let’s Encrypt 等免费 SSL 证书。

如何使用带有私钥和公钥的自己的证书 (比如 Let’s Encrypt )

证书是根据 Let’s Encrypt 的当前说明创建的，然后在容器中以符号形式链接。如果在 certificate.pem（公钥）旁边有一个文件，名为 privkey.pem（私钥），则会使用它们。这两个文件将像这样链接（查看文件夹和文件名）

sudo ln -s <path_to_private_key> /var/lib/docker/volumes/mh_data/_data/privkey.pem 
sudo ln -s <path_to_public_key> /var/lib/docker/volumes/mh_data/_data/certificate.pem