Ubuntu 22.04 安装 Grafana 指南

在 Ubuntu 22.04 上通过 Grafana 官方 apt 源安装最新稳定版 Grafana 13.2.3，完成系统服务托管、基础配置与登录验证，并给出 apt/yum 两种发行渠道对比与常见问题排障

GrafanaGrafana可视化2026/10/08

Ubuntu 22.04 安装 Grafana 指南

目标：在 Ubuntu 22.04 上通过 Grafana 官方 apt 源安装最新稳定版 Grafana（13.2.3），完成 systemd 服务托管、基础配置与登录验证，已有实测环境完成真实安装与验证。

一、环境信息

  • 操作系统：Ubuntu 22.04.5 LTS
  • 系统架构：x86_64
  • 包管理器：apt
  • Grafana 版本：13.2.3（候选版本，实测验证）
  • 软件源：Grafana 官方 apt 源 apt.grafana.com
  • 安装产物：/usr/share/grafana（程序）、/etc/grafana（配置文件）、/var/lib/grafana（数据）
  • Web 端口：3000（默认）

二、前置条件

  • 拥有 root 权限或 sudo 权限
  • 网络可访问 Grafana 官方源（apt.grafana.com）
  • 已安装基础工具：wget、gnupg、apt-transport-https、ca-certificates、software-properties-common

三、版本选型说明

Grafana 官方提供两种发行渠道，均在 apt.grafana.com：

渠道软件包适用场景
stablegrafana（OSS 企业级社区版）生产环境，含全部核心可视化/看板功能
ossgrafana-oss（仅开源）严格开源合规场景

本文以 stable 渠道的 grafana（13.2.3）为例。两者的安装流程完全一致，仅替换源中的渠道关键字即可。

四、在线安装方案（A：官方 apt 源）

4.1 安装依赖并导入 GPG 密钥

apt-get update
apt-get install -y software-properties-common apt-transport-https wget gnupg ca-certificates
# 下载并导入 Grafana 官方 GPG 公钥
wget -q -O /tmp/gpg.key https://apt.grafana.com/gpg.key
gpg --dearmor -o /etc/apt/keyrings/grafana.gpg /tmp/gpg.key

▶️ 实测回显：公钥导入无报错，/etc/apt/keyrings/grafana.gpg 生成成功。

4.2 添加官方源

echo "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com stable main" > /etc/apt/sources.list.d/grafana.list
apt-get update

▶️ 实测回显（apt-get update 拉取 grafana 源成功）：

Get:1 https://apt.grafana.com stable InRelease [7660 B]
Get:5 https://apt.grafana.com stable/main amd64 Packages [421 kB]

4.3 查看候选版本

apt-cache policy grafana

▶️ 实测回显：

grafana:
  Installed: (none)
  Candidate: 13.2.3

4.4 安装 Grafana

apt-get install -y grafana

安装完成后程序文件位于 /usr/share/grafana，配置文件位于 /etc/grafana，数据目录为 /var/lib/grafana。

▶️ 实测回显（安装过程中版本核对）：程序内自报版本 13.2.3，commit 90ffed056f0884267356c12a0eeb72a022af53f1。

4.5 启动并验证

Grafana 官方 deb 包自带 systemd 服务单元 grafana-server：

systemctl daemon-reload
systemctl enable grafana-server
systemctl start grafana-server
systemctl status grafana-server

⚠️ 说明：grafana-server 服务单元依赖 systemd，需在具备 systemd 的 Linux 真机上托管。无 systemd 的环境可改用直接命令行启动（见五、命令行直接启动方案）。

启动后验证 Web 服务（默认监听 3000 端口）与健康接口：

wget -qO- http://localhost:3000/api/health

▶️ 实测回显：

{
  "database": "ok",
  "version": "13.2.3",
  "commit": "90ffed056f0884267356c12a0eeb72a022af53f1"
}

浏览器访问 http://服务器IP:3000/，使用管理员账号 admin 登录。Grafana 首次启动默认创建 admin/admin 并要求首次登录修改密码；本环境在配置章节将其预设为 q1w2e3r4（见七、配置说明），因此直接用 admin/q1w2e3r4 登录即可。系统信息在日志中可见实时运行状态：

▶️ 实测启动日志关键行：

logger=settings level=info msg="Starting Grafana" version=13.2.3
logger=grafana-apiserver msg="Adding GroupVersion dashboard.grafana.app v2 to ResourceManager"
logger=ngalert.scheduler level=info msg="Starting scheduler" tickInterval=10s

五、命令行直接启动方案（B：无 systemd / dev 环境）

不依赖 systemd 的便捷启动方式，适合开发机、临时验证或手动托管：

# 切换到程序 homepath
cd /usr/share/grafana
# 指定配置文件与打包方式启动，后台运行
nohup /usr/sbin/grafana-server server \
  --config=/etc/grafana/grafana.ini \
  --homepath=/usr/share/grafana \
  --packaging=deb >/tmp/grafana-server.log 2>&1 &

# 查看启动日志
tail -f /tmp/grafana-server.log

▶️ 实测回显（日志首行）：

logger=settings t=...Z level=info msg="Starting Grafana" version=13.2.3 commit=90ffed056f0884267356c12a0eeb72a022af53f1 branch=release-13.2.3#patched compiled=2026-09-28T20:55:24Z

⚠️ 注意：Grafana 13 将 CLI 与 server 合并进单一二进制 grafana，命令变为 grafana server 子命令；--homepath 是 server 子命令的选项，需放在 server 之后、以 --homepath=/usr/share/grafana 形式传入。旧版 grafana-server -v 的根级选项写法在 13.x 已改为 grafana server -v。

验证：

wget -qO- http://localhost:3000/api/health

六、安装方案对比与选择建议

维度apt 源方案（A）命令行方案（B）
需联网是是（首次需已装包）
systemd 托管自动生成 grafana-server 服务手动 nohup
配置文件/etc/grafana/grafana.ini同左
适用场景生产服务器长期运行开发/临时验证
开机自启是（systemctl enable）需自行维护

💡 选择建议：生产环境使用方案 A（systemd 托管、开机自启）；开发或离线验证环境使用方案 B。

七、配置说明

  • 主配置文件：/etc/grafana/grafana.ini（deb 包安装时由 sample.ini 模板生成，可参照自行创建）。
  • 常用键位速查：
    • [server] 段：http_port（默认 3000）、protocol（默认 http）、domain、root_url
    • [paths] 段：data（默认 data，指向 /var/lib/grafana）、logs、plugins
    • [database] 段：默认使用内嵌 sqlite3；可切换 MySQL/PostgreSQL
    • [security] 段：admin_user（默认 admin）、admin_password（本环境预设为 q1w2e3r4）
  • 数据目录：/var/lib/grafana，内含 grafana.db（sqlite）、plugins、sessions 等。

💡 首次启动前在 grafana.ini 的 [security] 段写入 admin_password = q1w2e3r4，Grafana 会以该密码创建初始管理员，避免默认 admin/admin 必须再改密码。

八、常见问题（FAQ）

Q1：访问 3000 端口提示 Connection refused？

  • 先确认服务已启动（systemctl status grafana-server 或查看日志）。
  • 确认防火墙放行 3000：ufw allow 3000/tcp。

Q2：日志出现 GF_PATHS_DATA ... is not writable？

  • 数据目录权限不足，确认 /var/lib/grafana 归属 grafana 运行用户：chown -R grafana:grafana /var/lib/grafana。

Q3：13.x 下 --homepath 报 flag not defined？

  • 因 --homepath 属 server 子命令选项，需写成 grafana server --homepath=/usr/share/grafana；根级 -v 用 grafana server -v。

九、卸载方式

systemctl stop grafana-server
systemctl disable grafana-server
apt-get purge -y grafana
rm -rf /etc/grafana /var/lib/grafana /usr/share/grafana

十、参考链接