直接安装grafana需按发行版适配：ubuntu/debian须先导入gpg密钥并添加官方仓库源；rhel/centos 8+须用dnf而非yum；二进制包需手动指定配置路径以启用外部访问等关键设置；首次登录必须修改默认密码，否则api调用、插件安装均被拒绝。
直接装 grafana 就能跑起来，但不同发行版的安装命令、配置路径和默认行为差异很大，不注意容易卡在启动失败、端口打不开或登录后连不上数据源。
Ubuntu/Debian 用 apt 安装时必须加密钥和仓库源
只执行 sudo apt install grafana 会报错“无法定位软件包”，因为官方源里没有。必须先导入 GPG 密钥并添加稳定版仓库：
curl -fsSL https://packages.grafana.com/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/grafana-stable-archive-keyring.gpgecho "deb [arch=amd64 signed-by=/usr/share/keyrings/grafana-stable-archive-keyring.gpg] https://packages.grafana.com/oss/deb stable main" | sudo tee /etc/apt/sources.list.d/grafana.list- 再运行
sudo apt-get update && sudo apt-get install -y grafana
漏掉密钥或用错 signed-by 路径，会导致 apt update 报 NO_PUBKEY 错误，后续所有操作都无效。
RHEL/CentOS 8+ 必须用 dnf，yum 会失败
CentOS 8 及以后版本已弃用 yum，改用 dnf。如果沿用旧教程写 yum install grafana，会提示 “No match for argument: grafana”。正确做法是：
- 先建仓库文件：
sudo tee /etc/yum.repos.d/grafana.repo，内容含baseurl=https://packages.grafana.com/oss/rpm和gpgkey=https://packages.grafana.com/gpg.key - 然后执行：
sudo dnf install -y grafana（不是yum） - 服务名统一为
grafana-server，启动命令始终是sudo systemctl start grafana-server
CentOS 7 用户仍可用 yum，但别把两个命令混用——系统不会自动帮你降级或切换工具链。
二进制包解压后要手动指定配置路径才能加载自定义设置
下载 grafana-10.4.0.linux-amd64.tar.gz 解压后，bin/grafana-server 默认读取 /etc/grafana/grafana.ini。如果你没把配置文件放那儿，它就用内置默认值，比如监听 localhost:3000，外网访问不了。
- 启动时加参数指定配置：
./bin/grafana-server --config=/opt/grafana/conf/custom.ini - 或软链接覆盖默认路径：
sudo ln -sf /opt/grafana/conf/custom.ini /etc/grafana/grafana.ini - 关键修改项包括：
http_addr = 0.0.0.0（允许外部访问）、http_port = 3000、domain = your-domain.com（影响 cookie 和重定向）
不显式控制配置路径，就等于靠运气——很多用户调试半天才发现 Grafana 根本没读你改过的那个 .ini 文件。
首次登录后必须改密码，否则后续所有 API 调用和插件安装都会被拒绝
浏览器打开 http://your-server-ip:3000，用 admin/admin 登录成功后，页面强制跳转到密码修改页。跳过这步直接点“Skip”，界面看似能用，但：
- 调用
/api/datasources等管理接口会返回401 Unauthorized - 导入仪表盘 JSON 时提示 “Permission denied”
- 某些插件（如
grafana-image-renderer）初始化失败，日志里反复出现context deadline exceeded
这不是 bug，是 Grafana 的硬性安全策略：未完成初始密码变更，服务就处于“半锁定”状态，连 systemctl restart grafana-server 都不能绕过。
