如何将macOS上二进制安装的Qdrant配置为launchd服务？

本指南将帮助你在 macOS 系统中下载、安装 Qdrant，并将其配置为 launchd 守护进程，以便随系统启动并在后台运行。 前置条件 macOS 操作系统 终端访问权限 已安装 curl、tar、lsof 等基础工具 对 ~/Library/LaunchAgents 目录有写入权限（用户级别服务） 1. 下载 Qdrant 二进制 打开终端，执行以下命令以下载最新版本的 Qdrant 二进制包（适用于 Intel 架构的 macOS）： curl -L https://github.com/qdrant/qdrant/releases/latest/download/qdrant-x86_64-apple-darwin.tar.gz -o qdrant.tar.gz 注意：如果你使用的是 Apple Silicon (M1/M2/M3) Mac，请将 URL 中的 x86_64-apple-darwin 替换为 aarch64-apple-darwin，或者直接访问 Qdrant Releases 选择适合你架构的包。 2. 解压并安装 创建一个目录用于存放 Qdrant 及其配置文件，然后解压并移动可执行文件： # 创建安装目录 mkdir -p ~/qdrant_cli # 解压到该目录 tar -xzf qdrant.tar.gz -C ~/qdrant_cli # 解压后，二进制文件通常名为 qdrant，确保它位于 ~/qdrant_cli 中 # 若解压后直接生成了 qdrant 文件，则无需额外移动；否则请根据实际结构调整 检查可执行文件是否已正确放置： ls -l ~/qdrant_cli/qdrant 如果文件存在且具有可执行权限，即可继续。 3. 准备配置文件（可选） Qdrant 默认可以在没有配置文件的情况下运行，但启动命令中指定了 --config-path。你可以先创建一个最小配置文件，或从官方仓库获取示例。 在 ~/qdrant_cli 目录下创建一个 config.yaml 文件，内容可以是最简配置（例如只设置存储路径）： # ~/qdrant_cli/config.yaml storage: storage_path: ./storage 或使用官方默认配置（可参考 官方文档）。如果没有特殊需求，也可以跳过创建配置文件，直接运行 qdrant（不指定 --config-path），但本教程的后续命令均假设你已创建该文件。 4. 手动启动测试（可选） 在配置 launchd 之前，可以先手动启动 Qdrant，确认二进制文件工作正常： ~/qdrant_cli/qdrant --config-path ~/qdrant_cli/config.yaml 启动后，按 Ctrl+C 停止。如果看到启动日志且无错误，说明二进制正常。 5. 创建 launchd plist 文件 launchd 使用 plist 文件来管理服务。我们需要创建一个 io.qdrant.plist 文件，将其放置在 ~/Library/LaunchAgents/ 目录下（用户级服务）。