安装 InfluxDB 3 Core

• 系统要求
• 安装
  • Linux 和 macOS 快速安装
  • 下载并安装最新构建的制品
  • 拉取 Docker 镜像
  • Linux DEB 和 RPM 安装
    • TOML 配置 (Linux)
    • 作为系统服务运行 (Linux)
  • 验证安装

系统要求

操作系统

InfluxDB 3 Core 支持 Linux、macOS 和 Windows。

对象存储

InfluxDB 3 的一个关键特性是它使用对象存储来以 Apache Parquet 格式存储时序数据。您可以选择将这些文件存储在本地文件系统上。本地文件系统的性能可能会更好，但对象存储的优点是不会耗尽空间，并且可以通过网络被其他系统访问。InfluxDB 3 Core 原生支持 Amazon S3、Azure Blob Storage 和 Google Cloud Storage。您还可以使用许多提供 S3 兼容 API 的本地对象存储实现，例如 Minio。

安装

InfluxDB 3 Core 支持 Linux、macOS 和 Windows。

选择以下一种方法来安装 InfluxDB 3 Core

• Linux 和 macOS 快速安装
• 下载并安装最新构建的制品
• 拉取 Docker 镜像
• Linux DEB 和 RPM 安装

Linux 和 macOS 快速安装

要在 Linux 或 macOS 上安装 InfluxDB 3 Core，请下载并运行 InfluxDB 3 Core 的快速安装脚本——例如，使用 curl 下载脚本

curl -O https://influxdb.org.cn/d/install_influxdb3.sh \
&& sh install_influxdb3.sh 

下载并安装最新构建的制品

您可以直接下载并安装 InfluxDB 3 Core 构建的制品

拉取 Docker 镜像

运行以下命令来拉取 influxdb:3-core 镜像，该镜像适用于 x86_64 (AMD64) 和 ARM64 架构

docker pull influxdb:3-core

Docker 会自动为您的系统架构拉取合适的镜像。

# For x86_64/AMD64
docker pull \
--platform linux/amd64 \
influxdb:3-core

# For ARM64
docker pull \
--platform linux/arm64 \
influxdb:3-core

Linux DEB 和 RPM 安装

当通过 DEB 或 RPM 在启用了 systemd 的系统上安装时，InfluxDB 3 Core 在沙盒环境中运行。包含的 systemd 单元文件配置了环境，为典型部署提供安全隔离。有关更多信息，请参阅 管理安全。

curl --silent --location -O https://repos.influxdata.com/influxdata-archive.key
gpg --show-keys --with-fingerprint --with-colons ./influxdata-archive.key 2>&1 \
| grep -q '^fpr:\+24C975CBA61A024EE1B631787C3D57159FC2F927:$' \
&& cat influxdata-archive.key \
| gpg --dearmor \
| sudo tee /usr/share/keyrings/influxdata-archive.gpg > /dev/null \
&& echo 'deb [signed-by=/usr/share/keyrings/influxdata-archive.gpg] https://repos.influxdata.com/debian stable main' \
| sudo tee /etc/apt/sources.list.d/influxdata.list
sudo apt-get update && sudo apt-get install influxdb3-core

curl --silent --location -O https://repos.influxdata.com/influxdata-archive.key
gpg --show-keys --with-fingerprint --with-colons ./influxdata-archive.key 2>&1 \
| grep -q '^fpr:\+24C975CBA61A024EE1B631787C3D57159FC2F927:$' \
&& sudo cp ./influxdata-archive.key /usr/share/influxdata-archive-keyring/keyrings/influxdata-archive.asc \
&& cat <<EOF | sudo tee /etc/yum.repos.d/influxdata.repo
[influxdata]
name = InfluxData Repository - Stable
baseurl = https://repos.influxdata.com/stable/\$basearch/main
enabled = 1
gpgcheck = 1
gpgkey = file:///usr/share/influxdata-archive-keyring/keyrings/influxdata-archive.asc
yum install influxdb3-core
EOF

TOML 配置 (Linux)

安装 DEB 或 RPM 包后，InfluxDB 3 Core TOML 配置文件位于 /etc/influxdb3/influxdb3-core.conf，包含以下设置

• object-store: file
• data-dir: /var/lib/influxdb3/data
• plugin-dir: /var/lib/influxdb3/plugins
• node-id: primary-node

作为系统服务运行 (Linux)

InfluxDB 3 Core 的 DEB 和 RPM 安装包含了在 Linux 上作为托管系统服务运行的服务文件

• systemd：适用于现代 Linux 发行版
• SysV init：兼容旧系统

使用 systemd 运行

在 systemd 系统上，influxdb3-core 单元文件在安装时被启用，但单元尚未启动，以便进行配置。

要启动数据库，请输入以下命令

# Start the service
systemctl start influxdb3-core

# View status
systemctl status influxdb3-core

# View logs
journalctl --unit influxdb3-core

使用 SysV 运行

在 SysV init 系统上，influxdb3-core 在安装时被禁用，可以通过修改 /etc/default/influxdb3-core 来包含 ENABLED=yes 来启用。

要启动数据库，请输入以下命令

# Start the database
/etc/init.d/influxdb3-core start

# View status
/etc/init.d/influxdb3-core status

# View logs
tail -f /var/lib/influxdb3/influxdb3-core.log

验证安装

安装 InfluxDB 3 Core 后，请输入以下命令来验证是否安装成功

influxdb3 --version

如果您的系统在 快速安装 后无法找到 influxdb3，请 source 您 shell 的配置文件（例如，.bashrc、.zshrc）——例如

source ~/.zshrc