1. 项目概述为什么需要关注InfluxDB的特定版本安装最近在整理一个老项目的监控系统时遇到了一个典型问题项目依赖的InfluxDB版本是1.1.0而团队新成员在本地搭建环境时直接安装了最新的2.x版本导致数据写入和查询的API完全不兼容整个开发流程卡住了。这让我意识到对于InfluxDB这类时序数据库版本的选择和安装远不是一句apt-get install influxdb那么简单尤其是在你还需要用到它内置的、后来被官方“隐藏”甚至废弃的Web管理界面时。InfluxDB 1.x系列特别是1.1.0到1.8.0是一个承上启下的关键版本区间。1.1.0版本稳定了早期1.0.0的特性而1.8.0则是1.x系列的最后一个重要版本它包含了许多性能改进和功能增强同时其数据格式与后续的2.x版本有根本性不同。很多遗留的监控系统比如基于Telegraf Grafana的经典组合、物联网数据平台甚至是一些企业内部的自研系统都依然运行在这些版本上。因此掌握如何正确安装并配置这些“老”版本尤其是开启那个简单直观的Web管理界面进行初步的数据查看和管理是一项非常实用的运维和开发技能。本文将手把手带你完成InfluxDB 1.1.0和1.8.0两个典型版本在Linux环境下的安装、基础配置并重点解决如何成功开启并访问其Web管理界面。我会基于实际操作对比两个版本在配置上的异同并分享在安装过程中可能遇到的“坑”及其解决方案。无论你是需要复现一个旧环境还是单纯想了解InfluxDB 1.x的经典架构这篇文章都能给你提供一份可直接“抄作业”的详细指南。2. 核心思路与版本选择背后的考量在动手之前我们得先搞清楚为什么要这么麻烦地指定版本安装而不是直接用最新版。这背后涉及到几个核心的技术决策点。2.1 InfluxDB 1.x 与 2.x 的架构鸿沟InfluxDB在2.0版本进行了一次彻底的重构这不仅仅是API的变化而是整个数据模型、查询语言和存储引擎的革新。数据模型与API1.x 版本使用类似SQL的InfluxQL查询语言写入数据通常通过HTTP API发送Line Protocol格式的数据。而2.x 版本引入了全新的Flux查询语言虽然也支持InfluxQL兼容模式并采用了基于API令牌Token的认证体系完全取代了1.x的用户名/密码和数据库Database的概念2.x中称为Bucket。Web界面1.x 版本内置了一个简单的Web管理界面默认运行在8083端口可以用来创建数据库、用户执行查询等。这个界面在2.x 中被功能更强大但也更复杂的全新Web UI通常运行在8086端口所取代两者操作逻辑完全不同。兼容性如果你手头有旧的配置文件、自动化脚本或应用程序代码它们很可能是针对1.x的API编写的。直接升级到2.x意味着大量的迁移和重写工作。因此如果你的目标是与一个现有的、基于InfluxDB 1.x的系统进行交互或复现其环境那么安装对应的1.x版本是唯一正确的起点。2.2 为什么选择1.1.0和1.8.0在1.x的漫长迭代中1.1.0和1.8.0是两个具有代表性的节点。InfluxDB 1.1.0这个版本出现在2016年底是1.0稳定版系列的一个重要更新。它修复了初期的大量bug提升了稳定性。许多在2017-2018年间搭建的系统可能就锁定在这个版本。它的配置文件和Web界面功能代表了1.x早期的典型状态。InfluxDB 1.8.0发布于2020年是1.x系列的最后一个重要功能版本。它包含了直到1.x生命周期结束为止的大部分优化例如改进的TSM存储引擎、更高效的查询并且是最后一个官方提供独立二进制安装包的版本再往后就主推2.x和Docker了。很多系统在无法直接迁移到2.x的情况下会选择升级到1.8.x以获得更好的性能和稳定性。通过对比安装这两个版本你不仅能学会方法还能直观感受到InfluxDB在1.x系列内的演进比如配置项的变化、依赖库的更新等。2.3 安装方式的选择包管理器 vs 二进制包对于这类开源软件通常有几种安装方式系统包管理器apt/yum最方便能自动处理依赖和服务管理。但官方仓库可能只保留最新版本老版本很难找到。下载官方二进制包.tar.gz最灵活可以安装任意历史版本且干净、隔离性好。需要手动管理服务和依赖。Docker非常流行隔离性最好。但对于需要开启Web界面并直接与宿主机网络交互的初学者可能会增加一层网络配置的复杂度。考虑到我们要安装的是两个特定的老版本并且需要清晰地展示配置修改过程本文将采用下载官方二进制包并手动安装的方式。这种方式步骤清晰不受系统仓库限制且能让你更深入地理解InfluxDB的目录结构和服务运行机制。当然我会在最后补充如何将其配置为系统服务以便像正规软件一样管理。3. 环境准备与依赖检查在开始下载和安装之前我们需要确保系统环境满足基本要求。这里我以最常用的Ubuntu 20.04 LTS系统为例其他Linux发行版如CentOS的命令会略有不同但思路一致。3.1 系统与用户准备首先确保你有一个具有sudo权限的用户。我们将创建一个专门的系统用户来运行InfluxDB服务这是生产环境的最佳实践能提高安全性。# 更新系统包列表 sudo apt-get update # 创建一个名为‘influxdb’的系统用户不创建家目录-r并指定shell为/sbin/nologin sudo useradd -rs /bin/false influxdb接下来为InfluxDB创建必要的数据和配置目录。InfluxDB默认会将数据、元数据和配置文件存放在特定位置。# 创建数据、元数据和配置文件目录 sudo mkdir -p /var/lib/influxdb sudo mkdir -p /var/lib/influxdb/{data,meta,wal} # 创建配置目录 sudo mkdir -p /etc/influxdb # 将目录所有权赋予我们刚创建的influxdb用户 sudo chown -R influxdb:influxdb /var/lib/influxdb sudo chown -R influxdb:influxdb /etc/influxdb注意/var/lib/influxdb/wal目录存放预写式日志Write-Ahead Log这是TSM存储引擎的关键部分用于在数据写入磁盘前提供持久化保证确保数据不会因进程崩溃而丢失。务必确保该目录有足够的写入权限和磁盘空间。3.2 网络与防火墙考虑InfluxDB 1.x 默认使用以下几个端口8086: HTTP API端口用于数据写入和查询InfluxQL。8083: Web管理界面端口如果启用。8088: 用于集群特性如RPC通信单机安装一般不用。如果你的服务器开启了防火墙如ufw或firewalld需要开放8086和8083端口。# 对于使用ufw的Ubuntu系统 sudo ufw allow 8086/tcp sudo ufw allow 8083/tcp sudo ufw reload # 对于使用firewalld的CentOS/RHEL系统 sudo firewall-cmd --permanent --add-port8086/tcp sudo firewall-cmd --permanent --add-port8083/tcp sudo firewall-cmd --reload4. InfluxDB 1.8.0 安装与配置详解我们首先安装较新的1.8.0版本因为它的安装过程更接近现代标准遇到的问题也更具普遍性。4.1 下载与解压官方二进制包InfluxData官方为每个版本都提供了编译好的64位Linux二进制包。我们可以直接从其发布页面下载。# 进入一个临时目录比如 /tmp cd /tmp # 下载 InfluxDB 1.8.0 的二进制包 # 注意官方下载链接可能随时间变化如果以下链接失效可以去官网历史发布页面查找 wget https://dl.influxdata.com/influxdb/releases/influxdb-1.8.0_linux_amd64.tar.gz # 解压下载的压缩包 tar xvfz influxdb-1.8.0_linux_amd64.tar.gz解压后你会看到一个名为influxdb-1.8.0-1的目录。进入该目录里面包含几个关键文件influxInfluxDB的命令行客户端CLI用于连接服务器并执行命令。influxdInfluxDB的服务端守护进程daemon我们主要安装和运行的就是它。influxdb.conf默认的配置文件模板。LICENSE,README.md等文档。4.2 安装二进制文件与初始化配置我们将influxd和influx这两个可执行文件复制到系统的/usr/bin目录下这样可以在任何位置直接调用它们。# 进入解压后的目录 cd influxdb-1.8.0-1 # 复制可执行文件到系统路径 sudo cp influxd influx /usr/bin/ # 复制默认配置文件到 /etc/influxdb sudo cp influxdb.conf /etc/influxdb/现在基本的安装就完成了。你可以通过以下命令测试influxd是否能正常运行# 检查版本 influxd version # 应该输出InfluxDB v1.8.0 (git: 1.8 563e6c3d1a7a2790763c7e0d075dfcaa4fa8ee6c)4.3 核心配置文件解析与Web界面启用这是最关键的一步。InfluxDB的所有行为都由/etc/influxdb/influxdb.conf这个配置文件控制。我们需要编辑它来启用Web界面并做基本设置。使用你喜欢的文本编辑器如vim或nano打开配置文件sudo vim /etc/influxdb/influxdb.conf这个配置文件非常长但结构清晰大部分配置项都被注释掉了以#开头。我们只需要找到并修改几个关键部分。1. 启用Web管理界面 ([[graph]])在配置文件中搜索[[graph]]部分大约在第450行左右。默认情况下它可能是被注释的。我们需要取消注释并确保其配置如下[[graph]] # Determines whether the graph endpoint is enabled. enabled true # 确保这里是 true # The bind address used by the graph endpoint. bind-address :8083 # Web界面绑定的地址和端口默认:8083表示监听所有网卡的8083端口 # If true, the graph endpoint will use HTTPS. # https-enabled false # The SSL certificate to use when HTTPS is enabled. # https-certificate /etc/ssl/influxdb.pem实操心得bind-address参数如果设置为“127.0.0.1:8083”则Web界面只允许本机访问。这对于生产环境是更安全的但如果你想从其他机器访问就需要设置为“:8083”或“0.0.0.0:8083”。在测试环境为了方便我们通常选择后者。2. 配置HTTP API端点 ([[http]])Web界面本身不处理数据它通过调用后端的HTTP API默认8086端口来操作数据。所以我们需要确保HTTP API是启用的。搜索[[http]]部分大约在第250行。[[http]] # Determines whether HTTP endpoint is enabled. enabled true # 确保为 true # The bind address used by the HTTP service. bind-address :8086 # API服务地址默认:8086 # Determines whether HTTP request logging is enabled. # log-enabled true # Determines whether detailed write logging is enabled. # write-tracing false3. 配置数据目录路径 (meta, data, wal)虽然我们在准备阶段创建了目录但需要在配置文件中告诉InfluxDB使用这些目录。搜索以下部分[meta] # Where the metadata/raft database is stored dir /var/lib/influxdb/meta # 修改为你的meta目录 [data] # The directory where the TSM storage engine stores TSM files. dir /var/lib/influxdb/data # 修改为你的data目录 # The directory where the TSM storage engine stores WAL files. wal-dir /var/lib/influxdb/wal # 修改为你的wal目录4. (可选) 配置身份认证默认情况下1.8.0安装后是没有启用身份认证的任何能访问8086端口的人都可以读写数据。这对于测试可以但对于生产环境或暴露在公网的环境极其危险。建议在初步测试后立即配置认证。在[[http]]部分下可以找到认证相关的配置[[http]] # ... # Determines whether user authentication is enabled over HTTP/HTTPS. auth-enabled false # 默认是false改为 true 以启用认证 # ...启用认证后你需要通过命令行创建管理员用户后续所有API请求和Web界面登录都需要用户名和密码。我们会在服务启动后做这件事。4.4 创建系统服务文件Systemd为了让InfluxDB能像系统服务一样开机自启、方便地启动/停止/重启我们为其创建一个systemd服务单元文件。创建文件/etc/systemd/system/influxdb.servicesudo vim /etc/systemd/system/influxdb.service将以下内容写入该文件[Unit] DescriptionInfluxDB is an open-source, distributed, time series database Documentationhttps://docs.influxdata.com/influxdb/ Afternetwork-online.target [Service] Userinfluxdb Groupinfluxdb Typesimple ExecStart/usr/bin/influxd -config /etc/influxdb/influxdb.conf KillModecontrol-group Restarton-failure RestartSec10s LimitNOFILE65536 [Install] WantedBymulti-user.target关键参数解释User/Group指定以我们之前创建的influxdb用户身份运行服务提升安全性。ExecStart启动命令通过-config参数指定我们的配置文件路径。Restarton-failure服务异常退出时自动重启。LimitNOFILE65536提高进程可打开的文件描述符数量限制对于数据库类服务很重要。然后重新加载systemd配置启动服务并设置开机自启# 重新加载systemd配置 sudo systemctl daemon-reload # 启动InfluxDB服务 sudo systemctl start influxdb # 设置开机自启 sudo systemctl enable influxdb # 检查服务状态确认是否运行正常 sudo systemctl status influxdb如果状态显示为active (running)并且日志中没有明显的错误信息通常以绿色文字显示说明服务启动成功。4.5 验证安装与初始设置现在我们可以验证InfluxDB是否正常工作并进行初始设置。1. 验证服务端口# 检查8083和8086端口是否在监听 sudo netstat -tulpn | grep -E ‘:(8083|8086)’你应该能看到influxd进程正在监听这两个端口。2. 访问Web管理界面打开你的浏览器访问http://你的服务器IP地址:8083。如果一切正常你将看到InfluxDB 1.x经典的Web管理界面登录页。在首次启动且未启用认证时你可以直接点击“Connect”按钮进入。3. 使用命令行客户端进行初始配置特别是启用认证后首先连接到本地的InfluxDB实例# 启动influx命令行客户端 influx如果未启用认证你会直接进入提示符。如果启用了认证auth-enabled true你需要先创建用户。但注意在启用认证后首次启动没有任何用户你需要先临时关闭认证或使用无认证模式创建第一个管理员用户。更安全的方法是在配置文件中将auth-enabled暂时改回false。重启服务sudo systemctl restart influxdb运行influx进入CLI。执行以下命令创建管理员用户CREATE USER admin WITH PASSWORD ‘your_strong_password_here’ WITH ALL PRIVILEGES退出CLI (exit)。将配置文件中的auth-enabled改回true。重启服务sudo systemctl restart influxdb现在你可以用新创建的用户登录Web界面或CLI了。# 使用用户名密码连接CLI influx -username admin -password ‘your_strong_password_here‘进入CLI后可以创建第一个数据库用于测试-- 创建一个名为mydb的数据库 CREATE DATABASE mydb -- 查看所有数据库 SHOW DATABASES5. InfluxDB 1.1.0 安装的特殊注意事项与差异点安装1.1.0版本的流程与1.8.0大体相同都是下载、解压、复制二进制文件、配置、创建服务。但其中有一些关键的差异和“坑”需要特别注意这也是为什么单独拿出来讲的原因。5.1 获取安装包与潜在的依赖问题1.8.0的二进制包是静态链接的对系统库依赖较少。而1.1.0版本相对较老可能依赖一些特定版本的系统库。cd /tmp # 下载 InfluxDB 1.1.0 二进制包 wget https://dl.influxdata.com/influxdb/releases/influxdb-1.1.0_linux_amd64.tar.gz tar xvfz influxdb-1.1.0_linux_amd64.tar.gz cd influxdb-1.1.0-1可能遇到的依赖问题 在某些非常新的Linux发行版上运行老版本的influxd可能会报错例如/lib/x86_64-linux-gnu/libc.so.6: version GLIBC_2.xx not found。这是因为二进制文件链接了较老版本的glibc。解决方法有在较老版本的系统如Ubuntu 16.04上安装。从源码编译比较复杂。使用Docker容器运行1.1.0版本推荐可以完美隔离环境。本文为了流程完整仍以二进制包安装为例假设你的系统兼容。5.2 配置文件结构的差异1.1.0的配置文件influxdb.conf结构与1.8.0类似但部分配置项的位置或默认值可能不同。最关键的一点是在1.1.0中Web界面Graphite API的Web UI的配置段标识符可能不同。在1.1.0中Web管理界面的配置通常位于[admin]部分而不是[[graph]]。用编辑器打开1.1.0的配置文件模板sudo vim /etc/influxdb/influxdb.conf搜索[admin]部分[admin] # Determines whether the admin service is enabled. enabled true # 确保启用 # The bind address used by the admin service. bind-address “:8083“ # 绑定地址和端口是的在1.1.0中Web界面是由[admin]节控制的。确保enabled true。HTTP API的配置仍在[http]部分注意1.1.0可能用的是单括号[http]而1.8.0是双括号[[http]]这是TOML格式的差异但功能相同。[http] # Determines whether HTTP endpoint is enabled. enabled true # The bind address used by the HTTP service. bind-address “:8086“ # Determines whether HTTP request logging is enabled. # log-enabled true # The default chunk size for result sets that should be chunked. # max-row-limit 0数据目录[data]和[meta]的配置方式与1.8.0类似请根据你创建的路径进行修改。5.3 身份认证的早期状态InfluxDB 1.1.0版本已经支持HTTP API认证但其Web管理界面在最初可能不支持基于用户名/密码的登录。早期版本的Web UI设计是直接连接本地API如果本地API未启用认证则Web UI可以直接访问。这意味着如果你在1.1.0中启用了HTTP认证(auth-enabled true)可能会导致无法通过Web UI登录。解决方案测试环境保持auth-enabled false仅通过防火墙或网络策略限制对8083和8086端口的访问。需要认证查阅1.1.0的官方文档看是否有针对Admin UI的独立认证配置。通常更建议将1.1.0版本用于内网可信环境或者升级到更高版本的1.x以获得更好的认证支持。5.4 创建系统服务文件为1.1.0创建systemd服务文件的过程与1.8.0完全一样。你可以使用同一个/etc/systemd/system/influxdb.service文件因为ExecStart命令是相同的都是/usr/bin/influxd -config /etc/influxdb/influxdb.conf。如果你要在同一台机器上安装两个版本不推荐端口冲突则需要创建不同的服务文件如influxdb-1.1.0.service和不同的配置/数据目录。启动和验证步骤与1.8.0章节所述完全相同。6. 常见问题与排查技巧实录在实际安装和配置过程中你几乎一定会遇到一些问题。下面是我总结的几个最常见的问题及其解决方法。6.1 Web界面无法访问404或连接拒绝这是最常见的问题。检查服务是否运行sudo systemctl status influxdb。如果服务是inactive或failed查看日志sudo journalctl -u influxdb -f获取错误信息。检查端口监听sudo netstat -tulpn | grep :8083。确保influxd进程正在监听正确的IP和端口0.0.0.0:8083或:8083。如果只看到127.0.0.1:8083说明配置中bind-address设置成了本地回环需要修改配置文件并重启服务。检查防火墙确认服务器防火墙和云服务商的安全组Security Group规则已放行8083端口。确认配置段正确对于1.8.0检查[[graph]]中的enabled。对于1.1.0检查[admin]中的enabled。务必重启服务使配置生效sudo systemctl restart influxdb。配置文件语法错误TOML配置文件对格式要求严格。如果修改配置时破坏了结构如括号不匹配、布尔值没用小写true/false会导致服务启动失败。仔细检查配置文件或与备份的原版配置文件对比。6.2 数据目录权限问题服务启动失败日志中出现“permission denied”错误。# 查看日志 sudo journalctl -u influxdb -n 50 --no-pager如果错误指向/var/lib/influxdb下的某个文件说明目录权限不对。确保整个数据目录及其子目录的所有者和组都是influxdb。sudo chown -R influxdb:influxdb /var/lib/influxdb sudo chmod -R 755 /var/lib/influxdb # 或 750根据安全要求调整然后重启服务。6.3 认证启用后无法连接启用auth-enabled true后之前能用的CLI或客户端突然报“401 Unauthorized”。确认已创建用户按照4.5节的步骤确保至少创建了一个具有权限的用户。连接时提供凭证CLI使用influx -username admin -password ‘password‘。HTTP API在请求头中添加Authorization: Token username:password注意这里是Basic Auth格式为base64(“username:password”)。或者使用URL参数?uusernameppassword不推荐密码会暴露在日志中。Web界面登录在登录页面输入用户名和密码。如果页面没有登录框可能是浏览器缓存了旧的未认证页面尝试强制刷新CtrlF5或清除缓存。6.4 版本间的重要行为差异数据文件不兼容绝对不要将1.1.0的数据文件目录直接给1.8.0使用反之亦然。虽然同属1.x系列但TSM存储格式可能有细微升级直接复制可能导致数据损坏或服务无法启动。迁移数据应使用influx_inspect工具导出和导入或通过备份恢复。配置项变更如[admin]变为[[graph]]一些性能调优参数的名字或默认值可能发生了变化。从低版本升级到高版本时务必参考官方升级指南不要直接替换配置文件。默认参数例如1.8.0可能对内存使用、查询超时等有更优化的默认设置。6.5 性能与资源调优提示安装完成后如果用于生产环境或处理较大数据量可能需要调整配置。内存限制在[http]部分可以设置max-connection-limit和max-concurrent-write-limit来限制并发防止OOM内存溢出。查询超时[coordinator]部分下的query-timeout参数可以控制查询执行的最长时间避免慢查询拖垮系统。数据保留策略Retention Policy这是InfluxDB的核心概念之一。默认的RP是autogen保留时间是永久。对于监控数据你通常需要创建更短的RP如30天、90天。可以通过CLI或Web界面设置。-- 在mydb数据库中创建一个保留30天的RP USE mydb CREATE RETENTION POLICY “30_days“ ON “mydb“ DURATION 30d REPLICATION 1 DEFAULT监控InfluxDB自身可以用另一个InfluxDB实例或者Telegraf来收集本实例的监控指标_internal数据库便于发现问题。安装并配置好InfluxDB 1.x只是第一步。接下来你可以结合Telegraf收集系统/应用指标再用Grafana制作炫酷的监控仪表盘构建完整的监控栈。或者用你熟悉的编程语言Python, Go, Java等通过HTTP API向其中写入业务数据进行时序数据分析。这个经典而稳定的架构至今仍在许多场景下发挥着重要作用。
1. 项目概述为什么需要关注InfluxDB的特定版本安装最近在整理一个老项目的监控系统时遇到了一个典型问题项目依赖的InfluxDB版本是1.1.0而团队新成员在本地搭建环境时直接安装了最新的2.x版本导致数据写入和查询的API完全不兼容整个开发流程卡住了。这让我意识到对于InfluxDB这类时序数据库版本的选择和安装远不是一句apt-get install influxdb那么简单尤其是在你还需要用到它内置的、后来被官方“隐藏”甚至废弃的Web管理界面时。InfluxDB 1.x系列特别是1.1.0到1.8.0是一个承上启下的关键版本区间。1.1.0版本稳定了早期1.0.0的特性而1.8.0则是1.x系列的最后一个重要版本它包含了许多性能改进和功能增强同时其数据格式与后续的2.x版本有根本性不同。很多遗留的监控系统比如基于Telegraf Grafana的经典组合、物联网数据平台甚至是一些企业内部的自研系统都依然运行在这些版本上。因此掌握如何正确安装并配置这些“老”版本尤其是开启那个简单直观的Web管理界面进行初步的数据查看和管理是一项非常实用的运维和开发技能。本文将手把手带你完成InfluxDB 1.1.0和1.8.0两个典型版本在Linux环境下的安装、基础配置并重点解决如何成功开启并访问其Web管理界面。我会基于实际操作对比两个版本在配置上的异同并分享在安装过程中可能遇到的“坑”及其解决方案。无论你是需要复现一个旧环境还是单纯想了解InfluxDB 1.x的经典架构这篇文章都能给你提供一份可直接“抄作业”的详细指南。2. 核心思路与版本选择背后的考量在动手之前我们得先搞清楚为什么要这么麻烦地指定版本安装而不是直接用最新版。这背后涉及到几个核心的技术决策点。2.1 InfluxDB 1.x 与 2.x 的架构鸿沟InfluxDB在2.0版本进行了一次彻底的重构这不仅仅是API的变化而是整个数据模型、查询语言和存储引擎的革新。数据模型与API1.x 版本使用类似SQL的InfluxQL查询语言写入数据通常通过HTTP API发送Line Protocol格式的数据。而2.x 版本引入了全新的Flux查询语言虽然也支持InfluxQL兼容模式并采用了基于API令牌Token的认证体系完全取代了1.x的用户名/密码和数据库Database的概念2.x中称为Bucket。Web界面1.x 版本内置了一个简单的Web管理界面默认运行在8083端口可以用来创建数据库、用户执行查询等。这个界面在2.x 中被功能更强大但也更复杂的全新Web UI通常运行在8086端口所取代两者操作逻辑完全不同。兼容性如果你手头有旧的配置文件、自动化脚本或应用程序代码它们很可能是针对1.x的API编写的。直接升级到2.x意味着大量的迁移和重写工作。因此如果你的目标是与一个现有的、基于InfluxDB 1.x的系统进行交互或复现其环境那么安装对应的1.x版本是唯一正确的起点。2.2 为什么选择1.1.0和1.8.0在1.x的漫长迭代中1.1.0和1.8.0是两个具有代表性的节点。InfluxDB 1.1.0这个版本出现在2016年底是1.0稳定版系列的一个重要更新。它修复了初期的大量bug提升了稳定性。许多在2017-2018年间搭建的系统可能就锁定在这个版本。它的配置文件和Web界面功能代表了1.x早期的典型状态。InfluxDB 1.8.0发布于2020年是1.x系列的最后一个重要功能版本。它包含了直到1.x生命周期结束为止的大部分优化例如改进的TSM存储引擎、更高效的查询并且是最后一个官方提供独立二进制安装包的版本再往后就主推2.x和Docker了。很多系统在无法直接迁移到2.x的情况下会选择升级到1.8.x以获得更好的性能和稳定性。通过对比安装这两个版本你不仅能学会方法还能直观感受到InfluxDB在1.x系列内的演进比如配置项的变化、依赖库的更新等。2.3 安装方式的选择包管理器 vs 二进制包对于这类开源软件通常有几种安装方式系统包管理器apt/yum最方便能自动处理依赖和服务管理。但官方仓库可能只保留最新版本老版本很难找到。下载官方二进制包.tar.gz最灵活可以安装任意历史版本且干净、隔离性好。需要手动管理服务和依赖。Docker非常流行隔离性最好。但对于需要开启Web界面并直接与宿主机网络交互的初学者可能会增加一层网络配置的复杂度。考虑到我们要安装的是两个特定的老版本并且需要清晰地展示配置修改过程本文将采用下载官方二进制包并手动安装的方式。这种方式步骤清晰不受系统仓库限制且能让你更深入地理解InfluxDB的目录结构和服务运行机制。当然我会在最后补充如何将其配置为系统服务以便像正规软件一样管理。3. 环境准备与依赖检查在开始下载和安装之前我们需要确保系统环境满足基本要求。这里我以最常用的Ubuntu 20.04 LTS系统为例其他Linux发行版如CentOS的命令会略有不同但思路一致。3.1 系统与用户准备首先确保你有一个具有sudo权限的用户。我们将创建一个专门的系统用户来运行InfluxDB服务这是生产环境的最佳实践能提高安全性。# 更新系统包列表 sudo apt-get update # 创建一个名为‘influxdb’的系统用户不创建家目录-r并指定shell为/sbin/nologin sudo useradd -rs /bin/false influxdb接下来为InfluxDB创建必要的数据和配置目录。InfluxDB默认会将数据、元数据和配置文件存放在特定位置。# 创建数据、元数据和配置文件目录 sudo mkdir -p /var/lib/influxdb sudo mkdir -p /var/lib/influxdb/{data,meta,wal} # 创建配置目录 sudo mkdir -p /etc/influxdb # 将目录所有权赋予我们刚创建的influxdb用户 sudo chown -R influxdb:influxdb /var/lib/influxdb sudo chown -R influxdb:influxdb /etc/influxdb注意/var/lib/influxdb/wal目录存放预写式日志Write-Ahead Log这是TSM存储引擎的关键部分用于在数据写入磁盘前提供持久化保证确保数据不会因进程崩溃而丢失。务必确保该目录有足够的写入权限和磁盘空间。3.2 网络与防火墙考虑InfluxDB 1.x 默认使用以下几个端口8086: HTTP API端口用于数据写入和查询InfluxQL。8083: Web管理界面端口如果启用。8088: 用于集群特性如RPC通信单机安装一般不用。如果你的服务器开启了防火墙如ufw或firewalld需要开放8086和8083端口。# 对于使用ufw的Ubuntu系统 sudo ufw allow 8086/tcp sudo ufw allow 8083/tcp sudo ufw reload # 对于使用firewalld的CentOS/RHEL系统 sudo firewall-cmd --permanent --add-port8086/tcp sudo firewall-cmd --permanent --add-port8083/tcp sudo firewall-cmd --reload4. InfluxDB 1.8.0 安装与配置详解我们首先安装较新的1.8.0版本因为它的安装过程更接近现代标准遇到的问题也更具普遍性。4.1 下载与解压官方二进制包InfluxData官方为每个版本都提供了编译好的64位Linux二进制包。我们可以直接从其发布页面下载。# 进入一个临时目录比如 /tmp cd /tmp # 下载 InfluxDB 1.8.0 的二进制包 # 注意官方下载链接可能随时间变化如果以下链接失效可以去官网历史发布页面查找 wget https://dl.influxdata.com/influxdb/releases/influxdb-1.8.0_linux_amd64.tar.gz # 解压下载的压缩包 tar xvfz influxdb-1.8.0_linux_amd64.tar.gz解压后你会看到一个名为influxdb-1.8.0-1的目录。进入该目录里面包含几个关键文件influxInfluxDB的命令行客户端CLI用于连接服务器并执行命令。influxdInfluxDB的服务端守护进程daemon我们主要安装和运行的就是它。influxdb.conf默认的配置文件模板。LICENSE,README.md等文档。4.2 安装二进制文件与初始化配置我们将influxd和influx这两个可执行文件复制到系统的/usr/bin目录下这样可以在任何位置直接调用它们。# 进入解压后的目录 cd influxdb-1.8.0-1 # 复制可执行文件到系统路径 sudo cp influxd influx /usr/bin/ # 复制默认配置文件到 /etc/influxdb sudo cp influxdb.conf /etc/influxdb/现在基本的安装就完成了。你可以通过以下命令测试influxd是否能正常运行# 检查版本 influxd version # 应该输出InfluxDB v1.8.0 (git: 1.8 563e6c3d1a7a2790763c7e0d075dfcaa4fa8ee6c)4.3 核心配置文件解析与Web界面启用这是最关键的一步。InfluxDB的所有行为都由/etc/influxdb/influxdb.conf这个配置文件控制。我们需要编辑它来启用Web界面并做基本设置。使用你喜欢的文本编辑器如vim或nano打开配置文件sudo vim /etc/influxdb/influxdb.conf这个配置文件非常长但结构清晰大部分配置项都被注释掉了以#开头。我们只需要找到并修改几个关键部分。1. 启用Web管理界面 ([[graph]])在配置文件中搜索[[graph]]部分大约在第450行左右。默认情况下它可能是被注释的。我们需要取消注释并确保其配置如下[[graph]] # Determines whether the graph endpoint is enabled. enabled true # 确保这里是 true # The bind address used by the graph endpoint. bind-address :8083 # Web界面绑定的地址和端口默认:8083表示监听所有网卡的8083端口 # If true, the graph endpoint will use HTTPS. # https-enabled false # The SSL certificate to use when HTTPS is enabled. # https-certificate /etc/ssl/influxdb.pem实操心得bind-address参数如果设置为“127.0.0.1:8083”则Web界面只允许本机访问。这对于生产环境是更安全的但如果你想从其他机器访问就需要设置为“:8083”或“0.0.0.0:8083”。在测试环境为了方便我们通常选择后者。2. 配置HTTP API端点 ([[http]])Web界面本身不处理数据它通过调用后端的HTTP API默认8086端口来操作数据。所以我们需要确保HTTP API是启用的。搜索[[http]]部分大约在第250行。[[http]] # Determines whether HTTP endpoint is enabled. enabled true # 确保为 true # The bind address used by the HTTP service. bind-address :8086 # API服务地址默认:8086 # Determines whether HTTP request logging is enabled. # log-enabled true # Determines whether detailed write logging is enabled. # write-tracing false3. 配置数据目录路径 (meta, data, wal)虽然我们在准备阶段创建了目录但需要在配置文件中告诉InfluxDB使用这些目录。搜索以下部分[meta] # Where the metadata/raft database is stored dir /var/lib/influxdb/meta # 修改为你的meta目录 [data] # The directory where the TSM storage engine stores TSM files. dir /var/lib/influxdb/data # 修改为你的data目录 # The directory where the TSM storage engine stores WAL files. wal-dir /var/lib/influxdb/wal # 修改为你的wal目录4. (可选) 配置身份认证默认情况下1.8.0安装后是没有启用身份认证的任何能访问8086端口的人都可以读写数据。这对于测试可以但对于生产环境或暴露在公网的环境极其危险。建议在初步测试后立即配置认证。在[[http]]部分下可以找到认证相关的配置[[http]] # ... # Determines whether user authentication is enabled over HTTP/HTTPS. auth-enabled false # 默认是false改为 true 以启用认证 # ...启用认证后你需要通过命令行创建管理员用户后续所有API请求和Web界面登录都需要用户名和密码。我们会在服务启动后做这件事。4.4 创建系统服务文件Systemd为了让InfluxDB能像系统服务一样开机自启、方便地启动/停止/重启我们为其创建一个systemd服务单元文件。创建文件/etc/systemd/system/influxdb.servicesudo vim /etc/systemd/system/influxdb.service将以下内容写入该文件[Unit] DescriptionInfluxDB is an open-source, distributed, time series database Documentationhttps://docs.influxdata.com/influxdb/ Afternetwork-online.target [Service] Userinfluxdb Groupinfluxdb Typesimple ExecStart/usr/bin/influxd -config /etc/influxdb/influxdb.conf KillModecontrol-group Restarton-failure RestartSec10s LimitNOFILE65536 [Install] WantedBymulti-user.target关键参数解释User/Group指定以我们之前创建的influxdb用户身份运行服务提升安全性。ExecStart启动命令通过-config参数指定我们的配置文件路径。Restarton-failure服务异常退出时自动重启。LimitNOFILE65536提高进程可打开的文件描述符数量限制对于数据库类服务很重要。然后重新加载systemd配置启动服务并设置开机自启# 重新加载systemd配置 sudo systemctl daemon-reload # 启动InfluxDB服务 sudo systemctl start influxdb # 设置开机自启 sudo systemctl enable influxdb # 检查服务状态确认是否运行正常 sudo systemctl status influxdb如果状态显示为active (running)并且日志中没有明显的错误信息通常以绿色文字显示说明服务启动成功。4.5 验证安装与初始设置现在我们可以验证InfluxDB是否正常工作并进行初始设置。1. 验证服务端口# 检查8083和8086端口是否在监听 sudo netstat -tulpn | grep -E ‘:(8083|8086)’你应该能看到influxd进程正在监听这两个端口。2. 访问Web管理界面打开你的浏览器访问http://你的服务器IP地址:8083。如果一切正常你将看到InfluxDB 1.x经典的Web管理界面登录页。在首次启动且未启用认证时你可以直接点击“Connect”按钮进入。3. 使用命令行客户端进行初始配置特别是启用认证后首先连接到本地的InfluxDB实例# 启动influx命令行客户端 influx如果未启用认证你会直接进入提示符。如果启用了认证auth-enabled true你需要先创建用户。但注意在启用认证后首次启动没有任何用户你需要先临时关闭认证或使用无认证模式创建第一个管理员用户。更安全的方法是在配置文件中将auth-enabled暂时改回false。重启服务sudo systemctl restart influxdb运行influx进入CLI。执行以下命令创建管理员用户CREATE USER admin WITH PASSWORD ‘your_strong_password_here’ WITH ALL PRIVILEGES退出CLI (exit)。将配置文件中的auth-enabled改回true。重启服务sudo systemctl restart influxdb现在你可以用新创建的用户登录Web界面或CLI了。# 使用用户名密码连接CLI influx -username admin -password ‘your_strong_password_here‘进入CLI后可以创建第一个数据库用于测试-- 创建一个名为mydb的数据库 CREATE DATABASE mydb -- 查看所有数据库 SHOW DATABASES5. InfluxDB 1.1.0 安装的特殊注意事项与差异点安装1.1.0版本的流程与1.8.0大体相同都是下载、解压、复制二进制文件、配置、创建服务。但其中有一些关键的差异和“坑”需要特别注意这也是为什么单独拿出来讲的原因。5.1 获取安装包与潜在的依赖问题1.8.0的二进制包是静态链接的对系统库依赖较少。而1.1.0版本相对较老可能依赖一些特定版本的系统库。cd /tmp # 下载 InfluxDB 1.1.0 二进制包 wget https://dl.influxdata.com/influxdb/releases/influxdb-1.1.0_linux_amd64.tar.gz tar xvfz influxdb-1.1.0_linux_amd64.tar.gz cd influxdb-1.1.0-1可能遇到的依赖问题 在某些非常新的Linux发行版上运行老版本的influxd可能会报错例如/lib/x86_64-linux-gnu/libc.so.6: version GLIBC_2.xx not found。这是因为二进制文件链接了较老版本的glibc。解决方法有在较老版本的系统如Ubuntu 16.04上安装。从源码编译比较复杂。使用Docker容器运行1.1.0版本推荐可以完美隔离环境。本文为了流程完整仍以二进制包安装为例假设你的系统兼容。5.2 配置文件结构的差异1.1.0的配置文件influxdb.conf结构与1.8.0类似但部分配置项的位置或默认值可能不同。最关键的一点是在1.1.0中Web界面Graphite API的Web UI的配置段标识符可能不同。在1.1.0中Web管理界面的配置通常位于[admin]部分而不是[[graph]]。用编辑器打开1.1.0的配置文件模板sudo vim /etc/influxdb/influxdb.conf搜索[admin]部分[admin] # Determines whether the admin service is enabled. enabled true # 确保启用 # The bind address used by the admin service. bind-address “:8083“ # 绑定地址和端口是的在1.1.0中Web界面是由[admin]节控制的。确保enabled true。HTTP API的配置仍在[http]部分注意1.1.0可能用的是单括号[http]而1.8.0是双括号[[http]]这是TOML格式的差异但功能相同。[http] # Determines whether HTTP endpoint is enabled. enabled true # The bind address used by the HTTP service. bind-address “:8086“ # Determines whether HTTP request logging is enabled. # log-enabled true # The default chunk size for result sets that should be chunked. # max-row-limit 0数据目录[data]和[meta]的配置方式与1.8.0类似请根据你创建的路径进行修改。5.3 身份认证的早期状态InfluxDB 1.1.0版本已经支持HTTP API认证但其Web管理界面在最初可能不支持基于用户名/密码的登录。早期版本的Web UI设计是直接连接本地API如果本地API未启用认证则Web UI可以直接访问。这意味着如果你在1.1.0中启用了HTTP认证(auth-enabled true)可能会导致无法通过Web UI登录。解决方案测试环境保持auth-enabled false仅通过防火墙或网络策略限制对8083和8086端口的访问。需要认证查阅1.1.0的官方文档看是否有针对Admin UI的独立认证配置。通常更建议将1.1.0版本用于内网可信环境或者升级到更高版本的1.x以获得更好的认证支持。5.4 创建系统服务文件为1.1.0创建systemd服务文件的过程与1.8.0完全一样。你可以使用同一个/etc/systemd/system/influxdb.service文件因为ExecStart命令是相同的都是/usr/bin/influxd -config /etc/influxdb/influxdb.conf。如果你要在同一台机器上安装两个版本不推荐端口冲突则需要创建不同的服务文件如influxdb-1.1.0.service和不同的配置/数据目录。启动和验证步骤与1.8.0章节所述完全相同。6. 常见问题与排查技巧实录在实际安装和配置过程中你几乎一定会遇到一些问题。下面是我总结的几个最常见的问题及其解决方法。6.1 Web界面无法访问404或连接拒绝这是最常见的问题。检查服务是否运行sudo systemctl status influxdb。如果服务是inactive或failed查看日志sudo journalctl -u influxdb -f获取错误信息。检查端口监听sudo netstat -tulpn | grep :8083。确保influxd进程正在监听正确的IP和端口0.0.0.0:8083或:8083。如果只看到127.0.0.1:8083说明配置中bind-address设置成了本地回环需要修改配置文件并重启服务。检查防火墙确认服务器防火墙和云服务商的安全组Security Group规则已放行8083端口。确认配置段正确对于1.8.0检查[[graph]]中的enabled。对于1.1.0检查[admin]中的enabled。务必重启服务使配置生效sudo systemctl restart influxdb。配置文件语法错误TOML配置文件对格式要求严格。如果修改配置时破坏了结构如括号不匹配、布尔值没用小写true/false会导致服务启动失败。仔细检查配置文件或与备份的原版配置文件对比。6.2 数据目录权限问题服务启动失败日志中出现“permission denied”错误。# 查看日志 sudo journalctl -u influxdb -n 50 --no-pager如果错误指向/var/lib/influxdb下的某个文件说明目录权限不对。确保整个数据目录及其子目录的所有者和组都是influxdb。sudo chown -R influxdb:influxdb /var/lib/influxdb sudo chmod -R 755 /var/lib/influxdb # 或 750根据安全要求调整然后重启服务。6.3 认证启用后无法连接启用auth-enabled true后之前能用的CLI或客户端突然报“401 Unauthorized”。确认已创建用户按照4.5节的步骤确保至少创建了一个具有权限的用户。连接时提供凭证CLI使用influx -username admin -password ‘password‘。HTTP API在请求头中添加Authorization: Token username:password注意这里是Basic Auth格式为base64(“username:password”)。或者使用URL参数?uusernameppassword不推荐密码会暴露在日志中。Web界面登录在登录页面输入用户名和密码。如果页面没有登录框可能是浏览器缓存了旧的未认证页面尝试强制刷新CtrlF5或清除缓存。6.4 版本间的重要行为差异数据文件不兼容绝对不要将1.1.0的数据文件目录直接给1.8.0使用反之亦然。虽然同属1.x系列但TSM存储格式可能有细微升级直接复制可能导致数据损坏或服务无法启动。迁移数据应使用influx_inspect工具导出和导入或通过备份恢复。配置项变更如[admin]变为[[graph]]一些性能调优参数的名字或默认值可能发生了变化。从低版本升级到高版本时务必参考官方升级指南不要直接替换配置文件。默认参数例如1.8.0可能对内存使用、查询超时等有更优化的默认设置。6.5 性能与资源调优提示安装完成后如果用于生产环境或处理较大数据量可能需要调整配置。内存限制在[http]部分可以设置max-connection-limit和max-concurrent-write-limit来限制并发防止OOM内存溢出。查询超时[coordinator]部分下的query-timeout参数可以控制查询执行的最长时间避免慢查询拖垮系统。数据保留策略Retention Policy这是InfluxDB的核心概念之一。默认的RP是autogen保留时间是永久。对于监控数据你通常需要创建更短的RP如30天、90天。可以通过CLI或Web界面设置。-- 在mydb数据库中创建一个保留30天的RP USE mydb CREATE RETENTION POLICY “30_days“ ON “mydb“ DURATION 30d REPLICATION 1 DEFAULT监控InfluxDB自身可以用另一个InfluxDB实例或者Telegraf来收集本实例的监控指标_internal数据库便于发现问题。安装并配置好InfluxDB 1.x只是第一步。接下来你可以结合Telegraf收集系统/应用指标再用Grafana制作炫酷的监控仪表盘构建完整的监控栈。或者用你熟悉的编程语言Python, Go, Java等通过HTTP API向其中写入业务数据进行时序数据分析。这个经典而稳定的架构至今仍在许多场景下发挥着重要作用。
