文档文档

安装和使用 influx CLI

使用 influx CLI 与您的 InfluxDB 实例交互和管理。写入和查询数据、生成 InfluxDB 模板、导出数据等等。

influx CLI 与 InfluxDB 服务器 (influxd) 分开打包和版本控制。

安装 influx CLI

执行以下操作之一

使用 Homebrew

brew install influxdb-cli

如果您使用 Homebrew 安装了 InfluxDB 2.7,则 influxdb-cli 公式已作为依赖项下载,并且应该已经安装。如果已安装,influxdb-cli 将出现在以下命令的输出中

brew list | grep influxdb-cli

手动下载和安装

  1. 从您的浏览器下载从命令行下载 influx CLI 包。

    从您的浏览器下载

    influx CLI v2.7.5 (macOS)

    从命令行下载

    curl -LO https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.7.5-darwin-amd64.tar.gz \
        --output-dir ~/Downloads
    
  2. 解包下载的二进制文件。

    执行以下操作之一

    • Finder 中,双击下载的包文件。

    • 在您的终端(例如,终端iTerm2)中使用 tar 解压包 - 例如,输入以下命令将其解压到 ~/Downloads

      tar zxvf ~/Downloads/influxdb2-client-2.7.5-darwin-amd64.tar.gz \
        --directory ~/Downloads
      
  3. 可选:将 influx 二进制文件放在您的 $PATH 中 - 例如,将二进制文件复制到 /usr/local/bin

    sudo cp ~/Downloads/influx /usr/local/bin/
    

    influx 二进制文件放在您的 $PATH (/usr/local/bin) 中后,您可以在终端中输入 influx 来运行 CLI。

    如果您不将 influx 二进制文件移动到您的 $PATH 中,请输入二进制文件的路径以运行 CLI - 例如

    ~/Downloads/influx
    
  4. (macOS Catalina 和更高版本)授权 influx 二进制文件。

    macOS 要求下载的二进制文件由注册的 Apple 开发者签名。当您首次尝试运行 influx 时,macOS 会阻止它运行。要授权 influx 二进制文件

    在 macOS Ventura 上允许二进制文件

    1. 按照前面的说明尝试启动 influx
    2. 打开系统设置,然后单击隐私与安全性
    3. 安全性标题下,有一条关于“influxd”被阻止的消息,单击仍然允许
    4. 出现提示时,输入您的密码以允许该设置。
    5. 关闭系统设置
    6. 尝试启动 influx
    7. 将出现一个提示,其中包含消息“macOS 无法验证“influx”的开发者…”。单击打开

    在 macOS Catalina 上允许二进制文件

    1. 尝试运行 influx 命令。
    2. 打开系统偏好设置,然后单击安全性与隐私
    3. 通用选项卡下,有一条关于 influx 被阻止的消息。单击仍然打开
  1. 从您的浏览器下载从命令行下载 influx CLI 包。

    从您的浏览器下载

    influx CLI v2.7.5 (amd64) influx CLI v2.7.5 (arm)

    从命令行下载

    # amd64
    wget https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.7.5-linux-amd64.tar.gz
    
    # arm
    wget https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.7.5-linux-arm64.tar.gz
    
  2. 解包下载的二进制文件。

    注意:以下命令是示例。如有必要,调整文件名、路径和实用程序。

    # amd64
    tar xvzf ./influxdb2-client-2.7.5-linux-amd64.tar.gz
    
    # arm
    tar xvzf ./influxdb2-client-2.7.5-linux-arm64.tar.gz
    
  3. 可选:将解压后的 influx 可执行文件放在您的系统 $PATH 中。

    # amd64
    sudo cp ./influx /usr/local/bin/
    
    # arm
    sudo cp ./influx /usr/local/bin/
    

    如果您不将 influxd 二进制文件移动到您的 $PATH 中,请输入二进制文件的路径以启动服务器 - 例如

    ./influx
    

我们建议在 Powershell 中运行 influx CLI 命令。命令提示符不完全兼容。

  1. 下载 influx CLI 包。

    influx CLI v2.7.5 (Windows)

  2. 展开下载的存档。

    将下载的存档展开到 C:\Program Files\InfluxData\ 中,并根据需要重命名。

    > Expand-Archive .\influxdb2-client-2.7.5-windows-amd64.zip -DestinationPath 'C:\Program Files\InfluxData\'
    > mv 'C:\Program Files\InfluxData\influxdb2-client-2.7.5-windows-amd64' 'C:\Program Files\InfluxData\influx'
    
  3. 授予 influx CLI 网络访问权限。

    首次使用 influx CLI 时,Windows Defender 会显示以下消息

    Windows Defender 防火墙阻止了此应用的某些功能。

    要授予 influx CLI 所需的访问权限,请执行以下操作

    1. 选择专用网络,例如我的家庭或工作网络
    2. 单击允许访问

设置 influx CLI

提供所需的身份验证凭据

为了避免每次命令都传递 InfluxDB 主机API 令牌组织,请将它们存储在 influx CLI 配置(config)中。需要这些凭据的 influx 命令会自动从活动配置中检索这些凭据。

使用 influx config create 命令 创建 influx CLI 配置并将其设置为活动配置

influx config create --config-name 
CONFIG_NAME
\
--host-url
http://localhost:8086
\
--org
ORG
\
--token
API_TOKEN
\
--active

替换以下内容

  • CONFIG_NAME:连接配置名称。
  • ORG_NAME:您的 InfluxDB 组织
  • API_TOKEN:您的 API 令牌

有关管理 CLI 配置的更多信息,请参阅 influx config 文档

有关如何创建 API 令牌的说明,请参阅 创建令牌

使用用户名和密码进行身份验证

influx CLI 2.4.0+ 允许您创建连接配置,该配置使用您用于登录 InfluxDB 用户界面 (UI) 的用户名和密码组合来验证 InfluxDB OSS 2.4+ 的身份。CLI 检索会话 cookie 并将其未加密地存储在您的 configs 路径中。

使用 --username-password, -p 选项使用 <username>:<password> 语法提供您的用户名和密码。如果未提供密码,则 CLI 会在每次需要身份验证的命令后提示输入密码。

influx config create \
  -n 
CONFIG_NAME
\
-u
http://localhost:8086
\
-p
USERNAME
:
PASSWORD
\
-o
ORG

替换以下内容

  • CONFIG_NAME:连接配置名称。
  • ORG: 您的组织名称
  • USERNAME:PASSWORD: 您的 UI 用户名和密码组合。

启用 shell 补全(可选)

要安装 influx shell 补全脚本,请参阅 influx completion

使用 influx CLI 命令

有关 influx CLI 命令的信息,请参阅 influx CLI 参考文档


此页面是否有帮助?

感谢您的反馈!


Flux 的未来

Flux 将进入维护模式。您可以像目前一样继续使用它,而无需对代码进行任何更改。

阅读更多

现已全面上市

InfluxDB 3 Core 和 Enterprise

快速启动。更快扩展。

获取更新

InfluxDB 3 Core 是一款开源、高速的最新数据引擎,可实时收集和处理数据,并将其持久化到本地磁盘或对象存储。InfluxDB 3 Enterprise 以 Core 的基础为构建,增加了高可用性、读取副本、增强的安全性以及数据压缩,从而实现更快的查询和优化的存储。InfluxDB 3 Enterprise 的免费层可供非商业家庭或业余爱好者使用。

有关更多信息,请查看