3. Grafana 环境搭建：安装、配置与界面导航

Grafana 作为数据可视化的核心组件，其环境搭建的稳定性直接影响后续仪表盘开发与运维效率。本章将系统讲解 Grafana 的三种主流安装方式（Docker、二进制、包管理器）、初始配置流程以及基本界面导航，帮助你在不同生产环境中快速部署 Grafana。

3.1 Grafana 安装方式对比

根据你的基础设施类型与运维习惯，Grafana 提供三种官方支持的安装路径。下表从部署速度、可维护性、资源隔离三个维度进行对比：

安装方式 适用场景 部署速度 资源隔离 升级复杂度
Docker 容器化环境、K8s、CI/CD 流水线 极快（秒级） 高（独立容器） 低（镜像替换）
二进制 裸金属服务器、离线环境、定制化安装 中等（分钟级） 低（共享系统库） 中（手动替换文件）
包管理器 标准 Linux 发行版、APT/YUM 生态 快（依赖自动解决） 低（系统级服务） 低（包管理器升级）
选型建议： 对于本课程后续的仪表盘模板部署实战，推荐使用 Docker 方式。它提供最干净的环境隔离，且与后续的 Prometheus、Loki 等数据源容器化部署天然兼容。

3.2 安装方式详解

3.2.1 Docker 安装（推荐）

Docker 安装是当前最主流的 Grafana 部署方式。以下命令将拉取最新稳定版 Grafana 并启动容器：

# 拉取 Grafana 官方镜像
docker pull grafana/grafana:latest

# 创建持久化数据目录（可选，但强烈推荐）
mkdir -p /data/grafana

# 启动 Grafana 容器
docker run -d \
  --name=grafana \
  -p 3000:3000 \
  -v /data/grafana:/var/lib/grafana \
  -e "GF_SECURITY_ADMIN_PASSWORD=admin123" \
  grafana/grafana:latest

启动后，通过 docker ps 确认容器状态。若需自定义配置文件，可挂载 grafana.ini：

docker run -d \
  --name=grafana \
  -p 3000:3000 \
  -v /data/grafana:/var/lib/grafana \
  -v /path/to/custom/grafana.ini:/etc/grafana/grafana.ini \
  grafana/grafana:latest
注意： 生产环境中务必修改默认管理员密码，不要使用 admin123 等弱口令。可通过环境变量 GF_SECURITY_ADMIN_PASSWORD 或配置文件设置。

3.2.2 二进制安装

适用于无法使用 Docker 的离线环境或需要精细控制 Grafana 版本的场景。以下以 Linux amd64 为例：

# 下载 Grafana 二进制包
wget https://dl.grafana.com/oss/release/grafana-10.4.2.linux-amd64.tar.gz

# 解压到指定目录
tar -zxvf grafana-10.4.2.linux-amd64.tar.gz -C /opt/

# 创建软链接（便于版本管理）
ln -s /opt/grafana-10.4.2 /opt/grafana

# 启动 Grafana（前台运行，用于测试）
/opt/grafana/bin/grafana server \
  --config=/opt/grafana/conf/defaults.ini \
  --homepath=/opt/grafana

若需后台运行，建议使用 systemd 管理：

# 创建 systemd 服务文件
cat <<EOF > /etc/systemd/system/grafana-server.service
[Unit]
Description=Grafana
After=network.target

[Service]
Type=simple
User=grafana
Group=grafana
ExecStart=/opt/grafana/bin/grafana server \
  --config=/opt/grafana/conf/defaults.ini \
  --homepath=/opt/grafana
Restart=on-failure

[Install]
WantedBy=multi-user.target
EOF

# 启动并设置开机自启
systemctl daemon-reload
systemctl start grafana-server
systemctl enable grafana-server

3.2.3 包管理器安装

对于 Ubuntu/Debian 和 CentOS/RHEL 用户，包管理器是最便捷的方式：

# Ubuntu/Debian (APT)
sudo apt-get install -y software-properties-common
sudo add-apt-repository "deb https://packages.grafana.com/oss/deb stable main"
wget -q -O - https://packages.grafana.com/gpg.key | sudo apt-key add -
sudo apt-get update
sudo apt-get install grafana

# CentOS/RHEL (YUM)
cat <<EOF | sudo tee /etc/yum.repos.d/grafana.repo
[grafana]
name=grafana
baseurl=https://packages.grafana.com/oss/rpm
repo_gpgcheck=1
enabled=1
gpgcheck=1
gpgkey=https://packages.grafana.com/gpg.key
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
EOF

sudo yum install grafana

# 启动服务
sudo systemctl daemon-reload
sudo systemctl start grafana-server
sudo systemctl enable grafana-server

3.3 Grafana 安装架构图

下图展示了三种安装方式与底层系统组件的关系：

Grafana 安装方式架构图 Grafana 应用层 Docker 容器 镜像: grafana/grafana 二进制部署 tar.gz + systemd 包管理器 APT / YUM 基础设施层 Linux 主机 / 虚拟机 / 云服务器 说明 三种安装方式共享同一套 Grafana 核心引擎，区别仅在于部署形态和运维接口。 Docker 方式提供最佳隔离性，适合微服务架构；包管理器方式与系统集成度最高。

3.4 初始配置与登录

无论采用哪种安装方式，Grafana 默认监听 3000 端口。首次访问需完成以下步骤：

  1. 访问地址： 浏览器打开 http://<服务器IP>:3000
  2. 默认凭据： 用户名 admin，密码 admin（首次登录强制修改）
  3. 修改密码： 系统引导设置新密码，建议使用 16 位以上强密码
  4. 配置数据源： 登录后进入 Configuration > Data Sources 添加数据源
关键配置项（grafana.ini）：
  • [server] 段：http_port（默认 3000）、domain（生产环境需设置）
  • [security] 段：admin_user、admin_password（环境变量覆盖）
  • [database] 段：默认使用 SQLite，生产环境建议切换为 MySQL/PostgreSQL
  • [auth.anonymous] 段：是否允许匿名访问（默认关闭）

3.5 基本界面导航

Grafana 的 UI 设计遵循“左侧导航 + 右侧内容区”的经典布局。掌握以下核心导航入口是高效使用 Grafana 的基础：

导航图标 菜单名称 功能说明
☰ (汉堡菜单) 主菜单 展开/收起左侧导航栏
📊 Dashboards 仪表盘列表、创建、管理、导入/导出
🔍 Explore 临时查询面板，用于快速调试数据源和 PromQL/SQL
⚙️ Configuration 数据源管理、用户、团队、s、插件
📡 Alerting 告警规则、通知渠道、静默管理
👤 用户头像 个人设置、组织切换、退出登录

3.6 Grafana 界面导航流程图

下图展示了从登录到创建第一个仪表盘的典型操作路径：

Grafana 界面导航流程图 1. 登录 Grafana 2. 配置数据源 3. 创建仪表盘 4. 添加查询面板 提示：Explore 面板可用于在创建仪表盘前快速验证查询语句的正确性。

3.7 常见问题与排错

端口冲突： 如果 3000 端口已被占用，可通过 --http-port 参数或修改 grafana.ini 中的 http_port 值来更换端口。
日志查看： Docker 方式使用 docker logs grafana；二进制/包管理器方式日志位于 /var/log/grafana/grafana.log。

常见错误及解决方案：

  • 无法访问 3000 端口： 检查防火墙规则（ufw status 或 firewall-cmd --list-all），确保 3000 端口已放行。
  • 登录后白屏： 清除浏览器缓存或使用无痕模式重试；检查 Grafana 版本与浏览器兼容性。
  • 数据源连接失败： 确认数据源地址是否可从 Grafana 容器/主机访问；检查网络策略和认证凭据。
  • 权限不足： 检查 grafana.ini 中 [security] 段的 admin_user 和 admin_password 是否正确。

至此，Grafana 环境搭建完成。你已经掌握了三种安装方式、初始配置流程以及基本界面导航。在下一阶段，我们将深入数据源配置与 SQL 查询集成，为构建专业仪表盘奠定基础。

← 上一章 📖 返回目录 下一章 →