Skip to main content

安装

Quickwit 编译为一个单一的二进制文件，我们提供了多种安装方法：

先决条件​

Quickwit 官方仅支持 Linux。FreeBSD 和 MacOS 虽然不是官方支持的，但应该也能正常工作。

Quickwit 提供了 x86-64 和 aarch64 的二进制文件。不需要特殊指令集，但在 x86-64 上推荐使用 SSE3。 对于 aarch64 的支持目前还是实验性的。

下载​

version: 0.8.1 - Release notes - Changelog License: AGPL V3 Downloads .tar.gz:

在 GitHub 上详细了解可用的构建版本。

注意外部依赖​

Quickwit 正常工作依赖于以下外部库：

  • libssl：行业标准加密库。 这些库可以通过本机包管理器安装在您的系统上。 您可以使用以下命令安装这些依赖项：
apt-get -y update && apt-get -y install libssl

另外，编译它还需要一些额外的依赖项。这些依赖项在生产系统上不是必需的：

  • clang：用于编译某些依赖项。
  • protobuf-compiler：用于编译 protobuf 定义。
  • libssl-dev：libssl 的头文件。
  • pkg-config：用于定位 libssl。
  • cmake：用于构建 librdkafka，以支持 kafka。 这些依赖项也可以通过本机包管理器安装在您的系统上。 您可以使用以下命令安装这些依赖项：
apt install -y clang protobuf-compiler libssl-dev pkg-config cmake

安装脚本​

要在您的机器上轻松安装 Quickwit，只需从您首选的 shell 运行以下命令。 该脚本会检测架构，然后为机器下载正确的二进制存档。

curl -L https://install.quickwit.io | sh

此脚本所做的只是下载适用于您机器的正确二进制存档，并将其提取到当前工作目录中。这意味着您可以从 GitHub 下载与您的操作系统架构匹配的任何所需的存档，并手动将其提取到任何位置。

安装或解压后，所有 Quickwit 的安装文件都可以在一个名为 quickwit-{version} 的目录中找到，其中 version 是对应的 Quickwit 版本。此目录具有以下布局：

quickwit-{version}
    ├── config
    │   └── quickwit.yaml
    ├── LICENSE_AGPLv3.0.txt
    ├── quickwit
    └── qwdata
  • config/quickwit.yaml: 默认配置文件。
  • LICENSE_AGPLv3.0.txt: 许可证文件。
  • quickwit: Quickwit 可执行二进制文件。
  • qwdata/: 默认的数据目录。

使用 Docker 镜像​

如果您使用 Docker，这可能是最快捷的启动方式之一。 以下命令将从 Docker Hub 拉取镜像并启动一个容器，准备执行 Quickwit 命令。

docker run --rm quickwit/quickwit --version

# If you are using Apple silicon based macOS system you might need to specify the platform.
# You can also safely ignore jemalloc warnings.
docker run --rm --platform linux/amd64 quickwit/quickwit --version

要全面了解这一点，请参阅 快速入门指南。