一、下载 InfluxDB
通过 Homebrew 安装(更便捷)
如果没有homebrew请跳转至博主的文章:Mac's Homebrew
如果已安装 Homebrew(macOS 包管理工具),可直接通过命令安装:
bash
brew install influxdb@2
二、安装与启动服务
- 启动 InfluxDB 服务:
bash
# 启动服务(临时启动,关闭终端后停止)
influxd
# 或设置开机自启(推荐)
brew services start influxdb@2
- 验证服务是否启动:
bash
brew services list | grep influxdb@2
- 若显示
started
则表示运行正常。
三、初始化配置(创建管理员和数据桶)
InfluxDB 2.x 需要初始化设置(创建组织、数据桶、API Token 等),推荐通过 Web UI 操作:
- 打开浏览器,访问
http://localhost:8086
(默认端口) - 点击 Get Started ,按提示完成以下设置:
- Username :管理员用户名(例如
admin
) - Password:管理员密码(至少 8 位)
- Organization :组织名(例如
my-org
,可自定义) - Bucket :数据桶(类似数据库,例如
my-bucket
,可自定义)
- Username :管理员用户名(例如
- 点击 Continue ,完成后会显示生成的 API Token(重要!后续操作需要,可截图保存,也可在设置中重新生成)
四、使用 InfluxDB CLI 操作(可选)
InfluxDB 自带命令行工具 influx
,可用于写入 / 查询数据、管理配置等。
1. 配置 CLI(连接本地服务)
-
Homebrew 安装,
influx
已加入环境变量,直接执行:bashinflux config create \ --config-name my-local \ --host-url http://localhost:8086 \ --org my-org \ --token 你的API Token \ --active
2. 测试写入数据
bash
# 写入一条温度数据到 my-bucket(替换为你的桶名)
influx write \
--bucket my-bucket \
--precision s \ # 时间精度(秒)
"temperature,location=room1 value=26 $(date +%s)" # 数据格式:measurement,tag=value field=value timestamp
3. 测试查询数据
在 Web UI 中查询:
-
进入
Data Explorer
(左侧菜单) -
选择桶
my-bucket
,输入查询语句(Flux 语言):bashfrom(bucket: "my-bucket") |> range(start: -10m) # 查询最近10分钟数据 |> filter(fn: (r) => r._measurement == "temperature") # 过滤测量值为temperature的数据
-
点击 Run,即可看到刚才写入的数据。
五、自定义配置(可选)
默认配置已满足基本需求,若需修改端口、数据存储目录等,可自定义配置文件:
- 复制默认配置文件(以压缩包安装为例):
bash
cp ~/Downloads/influxdb2-2.7.1-darwin-amd64/config.influxdb2.yml ~/my-influx-config.yml
- 编辑配置文件(例如修改端口为 8087):
bash
http-bind-address: ":8087" # 默认8086
storage-dir: "/Users/你的用户名/influxdata" # 自定义数据存储目录
- 用自定义配置启动服务:
bash
./influxd --config ~/my-influx-config.yml
六、停止服务
- 若通过终端直接启动(
./influxd
或influxd
),按Ctrl+C
停止。
七、卸载(如需)
bash
brew uninstall influxdb@2
rm -rf ~/.influxdbv2 # 清理数据