Grafana 仪表板安装配置完整指南

Grafana 是目前最流行的开源可视化和监控平台，能够将来自 Prometheus、InfluxDB、Elasticsearch 等多种数据源的指标数据转化为精美的图表和仪表板。本文将详细介绍如何在搬瓦工 VPS 上安装 Grafana，配置数据源并创建第一个监控仪表板。如果你还没有搬瓦工 VPS，可以先参考 全部方案 选购合适的套餐。

一、环境要求

• 操作系统：Ubuntu 20.04+、Debian 11+ 或 CentOS 7+（推荐 Ubuntu 22.04）。
• 内存：至少 512MB，推荐 1GB 以上以获得流畅体验。
• 磁盘：Grafana 本身占用较少，但数据源数据库需要额外空间。
• 网络：需要开放 3000 端口（Grafana 默认端口）。

二、在 Ubuntu/Debian 上安装 Grafana

2.1 添加 Grafana APT 仓库

首先安装必要的依赖并添加 Grafana 官方仓库：

apt update
apt install -y apt-transport-https software-properties-common wget
wget -q -O /usr/share/keyrings/grafana.key https://apt.grafana.com/gpg.key
echo "deb [signed-by=/usr/share/keyrings/grafana.key] https://apt.grafana.com stable main" | tee /etc/apt/sources.list.d/grafana.list

2.2 安装 Grafana

apt update
apt install grafana -y

2.3 启动并设置开机自启

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

2.4 验证安装

systemctl status grafana-server
grafana-server -v

Grafana 默认监听 3000 端口，可通过浏览器访问 http://你的IP:3000。默认用户名和密码均为 admin，首次登录后系统会要求修改密码。

三、在 CentOS 上安装 Grafana

3.1 添加 Grafana YUM 仓库

cat > /etc/yum.repos.d/grafana.repo <<EOF
[grafana]
name=grafana
baseurl=https://rpm.grafana.com
repo_gpgcheck=1
enabled=1
gpgcheck=1
gpgkey=https://rpm.grafana.com/gpg.key
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
EOF

3.2 安装并启动

yum install grafana -y
systemctl daemon-reload
systemctl start grafana-server
systemctl enable grafana-server

四、使用 Docker 安装 Grafana

如果你已经在搬瓦工 VPS 上安装了 Docker，可以使用容器方式快速部署 Grafana：

docker run -d \
  --name grafana \
  --restart unless-stopped \
  -p 3000:3000 \
  -v grafana-data:/var/lib/grafana \
  grafana/grafana:latest

也可以使用 Docker Compose，创建 docker-compose.yml：

version: '3.8'

services:
  grafana:
    image: grafana/grafana:latest
    container_name: grafana
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - grafana-data:/var/lib/grafana
      - grafana-config:/etc/grafana
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=your_secure_password
      - GF_USERS_ALLOW_SIGN_UP=false

volumes:
  grafana-data:
  grafana-config:

docker compose up -d

五、配置 Grafana

5.1 修改配置文件

Grafana 的主配置文件位于 /etc/grafana/grafana.ini，以下是常用配置项：

# 编辑配置文件
nano /etc/grafana/grafana.ini

# 常用配置项：
[server]
http_port = 3000
domain = your-domain.com
root_url = %(protocol)s://%(domain)s/

[security]
admin_user = admin
admin_password = your_secure_password

[users]
allow_sign_up = false

[auth.anonymous]
enabled = false

修改配置后需要重启 Grafana：

systemctl restart grafana-server

5.2 配置防火墙

# UFW 防火墙
ufw allow 3000/tcp

# 或 firewalld
firewall-cmd --permanent --add-port=3000/tcp
firewall-cmd --reload

六、添加数据源

6.1 添加 Prometheus 数据源

登录 Grafana 后，依次点击左侧菜单的「Connections」→「Data Sources」→「Add data source」，选择 Prometheus，填写以下信息：

• URL：http://localhost:9090（如果 Prometheus 在同一台服务器上）。
• Access：选择「Server」模式。
• 其他保持默认即可，点击「Save & Test」验证连接。

如果尚未安装 Prometheus，请参考 Prometheus 服务器监控系统搭建教程。

6.2 添加 InfluxDB 数据源

选择 InfluxDB 作为数据源类型，填入：

• URL：http://localhost:8086
• Database：你的数据库名称。
• User/Password：InfluxDB 认证信息。

七、创建仪表板

7.1 导入预置仪表板

Grafana 社区提供了大量预置仪表板模板，可以直接导入使用：

• 点击左侧菜单「Dashboards」→「Import」。
• 输入仪表板 ID（例如 1860 是常用的 Node Exporter 仪表板）。
• 选择对应的数据源，点击「Import」即可。

7.2 手动创建面板

点击「Dashboards」→「New」→「New Dashboard」→「Add visualization」，选择数据源后可以编写查询语句。例如查询 CPU 使用率：

100 - (avg by(instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)

在「Panel options」中设置面板标题、图表类型（时序图、仪表盘、柱状图等），调整完毕后点击「Apply」保存。

八、配置反向代理

生产环境建议使用 Nginx 反向代理并配置 HTTPS：

server {
    listen 80;
    server_name grafana.your-domain.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name grafana.your-domain.com;

    ssl_certificate /etc/letsencrypt/live/grafana.your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/grafana.your-domain.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /api/live/ {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }
}

配置反向代理后，需要同步更新 grafana.ini 中的 root_url 为你的域名地址。

九、安全加固

• 修改默认密码：首次登录后立即修改 admin 密码。
• 禁用注册：在配置文件中设置 allow_sign_up = false。
• 启用 HTTPS：通过反向代理或 Grafana 内置 SSL 配置。
• 限制访问 IP：在防火墙中限制只有可信 IP 能访问 3000 端口。
• 定期备份：备份 /var/lib/grafana/grafana.db 数据库文件。

十、常见问题

无法访问 Grafana Web 界面

检查服务状态和端口监听：

systemctl status grafana-server
ss -tlnp | grep 3000

确认防火墙已放行 3000 端口，搬瓦工后台安全组也需要相应配置。

忘记管理员密码

grafana-cli admin reset-admin-password new_password

插件安装失败

# 命令行安装插件
grafana-cli plugins install grafana-clock-panel
systemctl restart grafana-server

总结

Grafana 是搭建监控体系的核心可视化组件，配合 Prometheus 和 Node Exporter 可以构建一套完整的服务器监控系统。搬瓦工 VPS 提供稳定的 KVM 架构，非常适合部署此类监控服务。选购搬瓦工 VPS 请参考 全部方案，购买时使用优惠码 NODESEEK2026 可享受 6.77% 的循环折扣。