Kibana的安装部署

一、环境准备

1.1  系统要求

操作系统：CentOS 7+/Ubuntu 18.04+（64 位）

内存：至少 2GB 可用内存（推荐 4GB+）

磁盘：至少 10GB 可用空间

依赖：安装 libcap（解决权限问题）

# CentOS 系统

yum install -y libcap

# Ubuntu 系统

apt-get install -y libcap2-bin

1.2  网络要求

服务器开放 5601 端口（Kibana 默认端口）

确保 Kibana 服务器能访问 Elasticsearch 节点（默认 9200 端口）

1.3  用户准备

建议创建非 root 用户运行 Kibana（避免权限过高风险）：

# 创建 elastic 用户及组

groupadd elastic

useradd -g elastic -m -s /bin/bash elastic

# 设置密码

passwd elastic

 

二、下载 Kibana安装包

2.1  确认版本

首先确认你离线服务器上 Elasticsearch (ES) 的确切版本。

原则：Kibana 版本必须与 ES 版本完全一致（主版本号、次版本号、修订号都要一样）。

2.2  下载地址

官方下载链接（选择对应系统的 tar.gz 包）：

# 下载 Linux x86_64 版本

wget https://artifacts.elastic.co/downloads/kibana/kibana-9.1.2-linux-x86_64.tar.gz

# 校验文件完整性（可选，需提前获取官方 SHA256 校验值）

sha256sum kibana-9.1.2-linux-x86_64.tar.gz

2.3  解压安装包

# 解压到 /usr/local 目录（推荐安装路径）

tar -zxvf kibana-9.1.2-linux-x86_64.tar.gz -C /usr/local/

# 重命名目录，方便后续操作

mv /usr/local/kibana-9.1.2-linux-x86_64 /usr/local/kibana

# 修改目录所属用户

chown -R elastic:elastic /usr/local/kibana

 

三、配置 Kibana

3.1  编辑配置文件

Kibana 核心配置文件为 config/kibana.yml，切换到 elastic 用户后修改：

su - elastic

vi /usr/local/kibana/config/kibana.yml

核心配置项修改

kibana.yaml

# 服务器监听地址（0.0.0.0 允许所有IP访问）

server.host: "0.0.0.0"

# Kibana 服务端口（默认 5601）

server.port: 5601

# Elasticsearch 地址（需与 ES 配置一致）

elasticsearch.hosts: ["https://localhost:9200"]

# 若 ES 开启了账号密码认证，需配置以下内容（替换为实际账号密码）

elasticsearch.username: "kibana_system"

elasticsearch.password: "你的ES密码"

# SSL 证书验证

# 如果是自签名证书且未导入系统信任库，设为 none (生产环境建议配置 CA 证书)

elasticsearch.ssl.verificationMode: "none"

 

配置说明

elasticsearch.hosts：若 ES 为集群，需填写所有节点地址，如 ["https://192.168.1.10:9200", "https://192.168.1.11:9200"]；

kibana_system 是 Kibana 内置用户，需提前在 ES 中创建并授权（若 ES 开启安全认证）。

如何获取 kibana_system 的密码？
你需要回到 Elasticsearch 服务器 上执行：
bin/elasticsearch-reset-password -u kibana_system -i
设置好密码后，再填入上面的配置文件。

 

四、启动 Kibana

4.1  前台启动（测试用）

# 切换到 elastic 用户

su - elastic

# 进入 Kibana 安装目录

cd /usr/local/kibana/bin

# 前台启动（终端关闭则服务停止）

./kibana

启动成功后，终端会输出 Server running at http://0.0.0.0:5601。

4.2  后台启动（生产环境）

# 后台启动并输出日志到 kibana.log

nohup /usr/local/kibana/bin/kibana > /usr/local/kibana/logs/kibana.log 2>&1 &

# 查看启动状态

ps -ef | grep kibana

# 查看日志是否启动成功

tail -f  /usr/local/kibana/logs/kibana.log

启动成功后，终端会输出http server running at http://0.0.0.0:5601

4.3  设置开机自启（可选）

创建系统服务文件：

vi /etc/systemd/system/kibana.service

 

写入以下内容：

ini

[Unit]

Description=Kibana

After=network.target elasticsearch.service

 

[Service]

Type=simple

User=elastic

Group=elastic

ExecStart=/usr/local/kibana/bin/kibana

Restart=on-failure

RestartSec=5

 

[Install]

WantedBy=multi-user.target

 

重新加载服务并设置开机自启：

systemctl daemon-reload

systemctl enable kibana

systemctl start kibana

# 查看服务状态

systemctl status kibana

五、验证安装

5.1  访问 Kibana 界面

打开浏览器，输入 http://服务器IP:5601，若能进入 Kibana 登录 / 首页，说明安装成功。

若 ES 未开启安全认证：直接进入 Kibana 首页；

若 ES 开启安全认证：输入 ES 的账号密码（使用 elastic 用户）登录。

说明： kibana_system 是 Kibana 服务内部用来与 Elasticsearch 通信的“机器账户”，它不具备登录 Kibana 页面的权限。

 

 

登录成功后，会进入这个页面：

1. 点击“Add integrations”添加集成

如果你已经有数据源（比如从 Beats、Logstash 或其他应用发送数据到 Elasticsearch），可以通过这个入口快速配置数据集成。Kibana 提供了大量预定义的集成（如 Nginx、AWS、Docker 等），可以自动创建数据视图和仪表盘。

2. 点击“Explore on my own”自行探索

如果你只是想先熟悉 Kibana 界面，或者已经通过其他方式导入了数据，可以点击这个链接进入 Kibana 主页面。进入后，你需要先创建数据视图（Index Pattern），Kibana 才能知道如何展示你的数据。

• 创建数据视图：点击左上角菜单 → Stack Management → Data Views → Create data view。

• 输入一个匹配你 Elasticsearch 索引的名称（例如 logstash-*、filebeat-*），配置时间字段（如果有），然后保存。之后你就可以在 Analytics（分析）模块下使用 Discover、Dashboard 等功能了。

 

 

5.2  常见问题排查

无法访问 5601 端口：检查防火墙 / 安全组是否开放 5601 端口；

启动报错 “connect ECONNREFUSED”：检查 ES 是否启动、地址 / 端口是否正确；

权限错误：确保 /usr/local/kibana 目录所属用户为 elastic。

 

六、停止 Kibana

6.1  普通停止

# 查找 Kibana 进程ID

ps -ef | grep kibana | grep -v grep | awk '{print $2}'

# 杀死进程

kill -9 进程ID

6.2  系统服务停止

systemctl stop kibana

 

总结

1. Kibana 9.1.2 安装核心步骤：环境准备 → 下载解压 → 配置 kibana.yml → 启动验证，需确保与 Elasticsearch 版本一致、网络 / 权限配置正确；
2. 生产环境建议使用非 root 用户运行、后台启动并配置开机自启，同时开启 ES 安全认证以保障服务安全；
3. 关键配置项：server.host（监听地址）、elasticsearch.hosts（ES 地址）、i18n.locale（中文界面）。