适用范围
本文适用于官方仍在维护的 Debian 与 Ubuntu 版本，具体支持矩阵以官方下载页为准。相比 Docker，包安装把 Grafana 交给 systemd 与 apt 管理，适合长期运行的单机服务器。
添加官方 APT 仓库
sudo apt install -y apt-transport-https software-properties-common wget
sudo mkdir -p /etc/apt/keyrings/
wget -q -O - https://apt.grafana.com/gpg.key | \
gpg --dearmor | sudo tee /etc/apt/keyrings/grafana.gpg > /dev/null
echo "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com stable main" | \
sudo tee /etc/apt/sources.list.d/grafana.list
sudo apt update官方仓库提供 stable、rolling、beta 三条线：生产环境用 stable；想提前验证新版本，再临时加 beta 或 rolling。
安装并启动服务
sudo apt install grafana
sudo systemctl daemon-reload
sudo systemctl enable --now grafana-server确认状态并查看端口监听：
sudo systemctl status grafana-server
curl -s http://localhost:3000/api/health浏览器访问 http://<服务器IP>:3000，首次登录使用 admin / admin，登录后立即修改密码。
提示： 如果服务器上有防火墙，别忘了放行端口，例如 ufw：
sudo ufw allow 3000/tcp。生产环境更推荐反向代理到 443，见生产环境安全加固。
服务管理速查
| 操作 | 命令 |
|---|---|
| 启动 / 停止 / 重启 | sudo systemctl start grafana-server（动作换成 stop、restart 同理） |
| 开机自启 | sudo systemctl enable grafana-server |
| 查看状态 | systemctl status grafana-server |
| 跟踪日志 | journalctl -u grafana-server -f |
目录布局
| 路径 | 内容 |
|---|---|
/etc/grafana/grafana.ini |
主配置文件 |
/usr/share/grafana |
程序本体与静态资源 |
/var/lib/grafana |
数据目录：SQLite 数据库、插件 |
/var/log/grafana |
日志目录 |
/etc/grafana/provisioning |
数据源与仪表盘的代码化配置目录 |
安装指定版本
默认安装的是仓库里的最新版。需要钉版本时，先查再装：
apt policy grafana
sudo apt install grafana=12.1.0注意： 钉住具体版本号后，
apt upgrade不会再把 Grafana 升上去，升级需要显式执行，详见升级与回滚。
常见坑
- GPG 报错：跳过了
keyrings步骤或signed-by写错，apt update会拒绝该仓库，重跑上面的仓库添加段即可。 - 改完配置没生效：
grafana.ini需要重启服务才读取，sudo systemctl restart grafana-server。 - 误改默认配置文件：升级时包管理器可能提示
/etc/grafana/grafana.ini冲突；更稳妥的做法是用独立的自定义配置文件，见配置文件 grafana.ini。
下一步
- 配置调优从配置文件 grafana.ini开始。
- 对外提供访问前，先做生产环境安全加固。
- 换机器或升级时，读升级与回滚。