中文

应用程序

安装 Prometheus 和 Grafana

在 Debian 或 Ubuntu 上不使用 Docker 安装 Prometheus、node_exporter 和 Grafana,包含仪表板、受保护的 HTTPS 访问、更新与备份。

阅读约 7 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南介绍如何在运行 Debian 12/13 或 Ubuntu 22.04/24.04 的 VPS 或专用服务器上,不使用 Docker 安装一套完整的监控平台。

组件 作用 端口 监听地址
node_exporter 暴露系统指标 9100 127.0.0.1
Prometheus 采集并存储指标 9090 127.0.0.1
Grafana 展示仪表板 3000 127.0.0.1
Nginx 通过 HTTPS 发布 Grafana 80, 443 公开

只有 Grafana 会被发布,并且位于 Nginx 之后,通过 HTTPS 访问并需要账户登录。Prometheus 和 node_exporter 绝不会暴露到互联网。

订购服务器

为了托管您的监控系统,HostMyServers 提供多种方案:

前提条件

  • 一台运行 Debian 12/13 或 Ubuntu 22.04/24.04 的服务器,架构为 amd64 或 arm64
  • 拥有 sudo 权限的用户的 SSH 访问
  • 一个域名及其 A 记录:grafana.您的域名.com 必须指向服务器的 IP 地址
  • 根据 Grafana 的文档,Grafana 至少需要 512 MB 内存和 1 个 CPU 核心,这还不包括 Prometheus 的需求
  • 用于存放指标的磁盘空间:取决于采集的时间序列数量和保留时长

准备服务器

终端
sudo apt update
sudo apt upgrade -y
sudo apt install -y curl wget tar jq gnupg ufw nginx certbot python3-certbot-nginx apache2-utils

配置防火墙。请在启用 UFW 之前先放行 SSH;如果您使用其他端口,请替换 22。

终端
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw allow 80,443/tcp
sudo ufw enable

3000、9090 和 9100 端口不应开放。

安装 Prometheus

创建用户和目录

终端
sudo useradd --system --no-create-home --shell /usr/sbin/nologin prometheus
sudo mkdir -p /etc/prometheus /var/lib/prometheus
sudo chown prometheus:prometheus /var/lib/prometheus

下载并校验归档文件

终端
VERSION=3.13.5
ARCH=$(dpkg --print-architecture)
cd "$(mktemp -d)"
wget "https://github.com/prometheus/prometheus/releases/download/v${VERSION}/prometheus-${VERSION}.linux-${ARCH}.tar.gz"
wget "https://github.com/prometheus/prometheus/releases/download/v${VERSION}/sha256sums.txt"
sha256sum --check --ignore-missing sha256sums.txt
tar -xzf "prometheus-${VERSION}.linux-${ARCH}.tar.gz"
sudo install -m 0755 "prometheus-${VERSION}.linux-${ARCH}/prometheus" "prometheus-${VERSION}.linux-${ARCH}/promtool" /usr/local/bin/
prometheus --version

校验应对已下载的归档文件显示 OK。

配置指标采集

终端
sudo nano /etc/prometheus/prometheus.yml
YAML
global:
  scrape_interval: 15s
  evaluation_interval: 15s

scrape_configs:
  - job_name: prometheus
    static_configs:
      - targets: ["127.0.0.1:9090"]

  - job_name: node
    static_configs:
      - targets: ["127.0.0.1:9100"]

检查该文件:

终端
sudo chown -R root:prometheus /etc/prometheus
sudo chmod 750 /etc/prometheus
sudo chmod 640 /etc/prometheus/prometheus.yml
sudo promtool check config /etc/prometheus/prometheus.yml

创建 systemd 服务

终端
sudo nano /etc/systemd/system/prometheus.service
配置
[Unit]
Description=Prometheus
Wants=network-online.target
After=network-online.target

[Service]
User=prometheus
Group=prometheus
Type=simple
ExecStart=/usr/local/bin/prometheus \
  --config.file=/etc/prometheus/prometheus.yml \
  --storage.tsdb.path=/var/lib/prometheus \
  --storage.tsdb.retention.time=30d \
  --web.listen-address=127.0.0.1:9090 \
  --web.enable-admin-api
ExecReload=/bin/kill -HUP $MAINPID
Restart=on-failure
NoNewPrivileges=true
ProtectSystem=full
ProtectHome=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
选项 作用
--storage.tsdb.retention.time=30d 保留 30 天的指标(默认 15 天)
--web.listen-address=127.0.0.1:9090 仅在本地接口上监听
--web.enable-admin-api 启用用于快照备份的 API

启动服务:

终端
sudo systemctl daemon-reload
sudo systemctl enable --now prometheus
sudo systemctl status prometheus --no-pager

安装 node_exporter

终端
sudo useradd --system --no-create-home --shell /usr/sbin/nologin node_exporter
VERSION=1.13.0
ARCH=$(dpkg --print-architecture)
cd "$(mktemp -d)"
wget "https://github.com/prometheus/node_exporter/releases/download/v${VERSION}/node_exporter-${VERSION}.linux-${ARCH}.tar.gz"
wget "https://github.com/prometheus/node_exporter/releases/download/v${VERSION}/sha256sums.txt"
sha256sum --check --ignore-missing sha256sums.txt
tar -xzf "node_exporter-${VERSION}.linux-${ARCH}.tar.gz"
sudo install -m 0755 "node_exporter-${VERSION}.linux-${ARCH}/node_exporter" /usr/local/bin/
sudo nano /etc/systemd/system/node_exporter.service
配置
[Unit]
Description=Prometheus Node Exporter
Wants=network-online.target
After=network-online.target

[Service]
User=node_exporter
Group=node_exporter
Type=simple
ExecStart=/usr/local/bin/node_exporter --web.listen-address=127.0.0.1:9100
Restart=on-failure
NoNewPrivileges=true

[Install]
WantedBy=multi-user.target
终端
sudo systemctl daemon-reload
sudo systemctl enable --now node_exporter
curl -s http://127.0.0.1:9100/metrics | head -n 5

检查 Prometheus 是否已正常采集这两个目标。启动后请等待十五秒左右:

终端
curl -s http://127.0.0.1:9090/api/v1/targets | jq -r '.data.activeTargets[] | "\(.labels.job) \(.health)"'

预期结果如下:

文本
node up
prometheus up

安装 Grafana

添加官方软件源

终端
sudo mkdir -p /etc/apt/keyrings
sudo wget -O /etc/apt/keyrings/grafana.asc https://apt.grafana.com/gpg-full.key
sudo chmod 644 /etc/apt/keyrings/grafana.asc
echo "deb [signed-by=/etc/apt/keyrings/grafana.asc] https://apt.grafana.com stable main" | sudo tee /etc/apt/sources.list.d/grafana.list
sudo apt update
sudo apt install -y grafana

将 Grafana 限制在本地接口

Grafana 的初始账户为 admin / admin。请在首次启动之前限制监听范围:

终端
sudo nano /etc/grafana/grafana.ini

在 [server] 段中,取消注释或添加:

配置
[server]
http_addr = 127.0.0.1
http_port = 3000

启动服务并确认其有响应:

终端
sudo systemctl daemon-reload
sudo systemctl enable --now grafana-server
sudo ss -tlnp | grep 3000
curl -s http://127.0.0.1:3000/api/health

修改管理员密码

请在发布 Grafana 之前修改密码。在您自己的电脑上打开 SSH 隧道,并保持该会话处于打开状态:

终端
ssh -L 3000:127.0.0.1:3000 您的用户名@您的服务器IP

打开 http://localhost:3000,使用 admin / admin 登录,然后在 Grafana 提示时设置一个强密码。之后即可关闭隧道。

将 Prometheus 声明为数据源

终端
sudo nano /etc/grafana/provisioning/datasources/prometheus.yaml
YAML
apiVersion: 1

datasources:
  - name: Prometheus
    type: prometheus
    access: proxy
    url: http://127.0.0.1:9090
    isDefault: true
    editable: false
终端
sudo chown root:grafana /etc/grafana/provisioning/datasources/prometheus.yaml
sudo chmod 640 /etc/grafana/provisioning/datasources/prometheus.yaml
sudo systemctl restart grafana-server

通过 HTTPS 发布 Grafana

创建 Nginx 站点

终端
sudo nano /etc/nginx/sites-available/grafana.conf
Nginx
map $http_upgrade $connection_upgrade {
    default upgrade;
    '' close;
}

upstream grafana {
    server 127.0.0.1:3000;
}

server {
    listen 80;
    listen [::]:80;
    server_name grafana.您的域名.com;

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://grafana;
    }

    location /api/live/ {
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_set_header Host $host;
        proxy_pass http://grafana;
    }
}
终端
sudo ln -s /etc/nginx/sites-available/grafana.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
sudo certbot --nginx -d grafana.您的域名.com -m admin@您的域名.com --agree-tos --no-eff-email --redirect
sudo certbot renew --dry-run

有关证书的更多详情,请参阅指南 使用 Let's Encrypt 安装 SSL 证书。

完成 Grafana 配置

终端
sudo nano /etc/grafana/grafana.ini

按如下内容调整各段:

配置
[server]
http_addr = 127.0.0.1
http_port = 3000
domain = grafana.您的域名.com
root_url = https://grafana.您的域名.com/

[security]
cookie_secure = true
cookie_samesite = lax
strict_transport_security = true

[users]
allow_sign_up = false
终端
sudo systemctl restart grafana-server

导入仪表板

  1. 打开 https://grafana.您的域名.com 并登录。
  2. 在主菜单中点击 Dashboards。
  3. 点击 New,然后点击 Import dashboard。
  4. 输入 ID 1860(Node Exporter Full),然后点击 Load。
  5. 选择数据源 Prometheus,然后点击 Import。

验证安装

在服务器上,任何内部服务都不应监听公网地址:

终端
sudo ss -tlnp | grep -E ':(3000|9090|9100)\b'

每一行都应以 127.0.0.1 开头。在您自己的电脑上,以下命令应当失败:

终端
curl -m 5 http://您的服务器IP:3000/
curl -m 5 http://您的服务器IP:9090/
curl -m 5 http://您的服务器IP:9100/metrics

最后,https://grafana.您的域名.com 应显示登录页面,并且证书有效。

如需查看 Prometheus 的界面,请通过 SSH 隧道访问,然后打开 http://localhost:9090:

终端
ssh -L 9090:127.0.0.1:9090 您的用户名@您的服务器IP

使用密码保护 Prometheus(可选)

仅监听本地已经可以阻止来自互联网的任何访问。如果其他用户或应用程序可以访问该服务器,请再添加密码。

首先生成密码的哈希值:

终端
htpasswd -nBC 12 "" | tr -d ':\n'; echo

使用 sudo nano 创建 /etc/prometheus/web.yml,然后将该哈希值粘贴进去:

YAML
basic_auth_users:
  admin: "BCRYPT哈希"

同时保存明文密码,Prometheus 采集自身指标时需要用到它:

终端
sudo install -o root -g prometheus -m 640 /dev/null /etc/prometheus/web-password
sudo nano /etc/prometheus/web-password
sudo chown root:prometheus /etc/prometheus/web.yml
sudo chmod 640 /etc/prometheus/web.yml
sudo promtool check web-config /etc/prometheus/web.yml

然后进行以下三项修改:

  1. 在 prometheus.service 中,将 --web.config.file=/etc/prometheus/web.yml 添加到 ExecStart 命令中。

  2. 在 prometheus.yml 中,补全 prometheus 任务:

    YAML
    - job_name: prometheus
      basic_auth:
        username: admin
        password_file: /etc/prometheus/web-password
      static_configs:
        - targets: ["127.0.0.1:9090"]
  3. 在 Grafana 数据源中,添加凭据:

    YAML
    basicAuth: true
    basicAuthUser: admin
    secureJsonData:
      basicAuthPassword: 您的Prometheus密码

重新加载配置并重启服务:

终端
sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl daemon-reload
sudo systemctl restart prometheus grafana-server

此后,请在发往 9090 端口的 curl 命令中添加 -u admin。

监控另一台服务器

在第二台服务器上安装 node_exporter,并在其服务中设置 --web.listen-address=0.0.0.0:9100。在这台第二台服务器上,只允许您的 Prometheus 服务器访问:

终端
sudo ufw allow from 您的服务器IP to any port 9100 proto tcp

然后在 /etc/prometheus/prometheus.yml 中添加该目标,并重新加载 Prometheus:

YAML
  - job_name: node
    static_configs:
      - targets: ["127.0.0.1:9100", "第二台服务器IP:9100"]
终端
sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl reload prometheus

更新

请先备份数据并阅读发行说明。

Prometheus:使用新的 VERSION 值重复下载步骤,然后执行:

终端
sudo promtool check config /etc/prometheus/prometheus.yml
sudo systemctl restart prometheus
prometheus --version

node_exporter:同样重复其下载和安装步骤,然后执行:

终端
sudo systemctl restart node_exporter
node_exporter --version

Grafana:软件包通过 APT 更新。

终端
sudo apt update
sudo apt install --only-upgrade grafana
sudo systemctl restart grafana-server

备份与恢复

Prometheus

Prometheus 的文档推荐使用快照(snapshots):

终端
SNAPSHOT=$(curl -fsS -X POST http://127.0.0.1:9090/api/v1/admin/tsdb/snapshot | jq -r '.data.name')
sudo tar -czpf "/root/prometheus-${SNAPSHOT}.tar.gz" -C /var/lib/prometheus/snapshots "$SNAPSHOT"
sudo rm -rf "/var/lib/prometheus/snapshots/${SNAPSHOT}"
sudo tar -czpf "/root/prometheus-config-$(date +%F).tar.gz" /etc/prometheus /etc/systemd/system/prometheus.service

恢复快照:

终端
sudo systemctl stop prometheus
sudo mv /var/lib/prometheus /var/lib/prometheus.old
sudo mkdir /var/lib/prometheus
sudo tar -xzpf /root/prometheus-快照名称.tar.gz --strip-components=1 -C /var/lib/prometheus
sudo chown -R prometheus:prometheus /var/lib/prometheus
sudo systemctl start prometheus

Grafana

默认情况下,Grafana 将账户和仪表板存储在 SQLite 数据库 /var/lib/grafana/grafana.db 中。复制期间请停止服务:

终端
sudo systemctl stop grafana-server
sudo tar -czpf "/root/grafana-$(date +%F).tar.gz" /var/lib/grafana /etc/grafana
sudo systemctl start grafana-server

恢复:

终端
sudo systemctl stop grafana-server
sudo tar -xzpf /root/grafana-YYYY-MM-DD.tar.gz -C /
sudo chown -R grafana:grafana /var/lib/grafana
sudo systemctl start grafana-server

这些归档文件包含机密信息:请使用 sudo chmod 600 /root/*.tar.gz 限制其权限,并将它们复制到服务器之外。

故障排查

Prometheus 无法启动

终端
sudo journalctl -u prometheus -n 50 --no-pager
sudo promtool check config /etc/prometheus/prometheus.yml
sudo ls -ld /var/lib/prometheus

数据目录上的 permission denied 可通过 sudo chown -R prometheus:prometheus /var/lib/prometheus 修复。address already in use 表示另一个进程占用了 9090 端口:请使用 sudo ss -tlnp | grep 9090 找出该进程。

某个目标处于 down 状态

查看 lastError 字段:

终端
curl -s http://127.0.0.1:9090/api/v1/targets | jq '.data.activeTargets[] | {job: .labels.job, health, lastError}'

connection refused 表示 exporter 已停止,或监听在其他地址。如果指向另一台服务器的目标出现 context deadline exceeded,则更可能是防火墙的问题。

Grafana 出现 502 Bad Gateway 错误

终端
sudo systemctl status grafana-server --no-pager
sudo journalctl -u grafana-server -n 50 --no-pager
curl -s http://127.0.0.1:3000/api/health

登录循环或出现 “origin not allowed” 提示

请确认 domain 和 root_url 与浏览器中使用的地址完全一致,并且 Nginx 已正确传递 Host 请求头。cookie_secure = true 要求通过 HTTPS 访问。

仪表板没有显示任何数据

  • 确认两个目标均为 up。
  • 将显示的时间范围扩大到几个小时。
  • 在仪表板中,确认所选的数据源、job 和实例是否正确。

忘记 Grafana 管理员密码

在服务器上重置密码,然后在界面中再次修改:

终端
sudo -u grafana grafana cli --homepath /usr/share/grafana --config /etc/grafana/grafana.ini admin reset-admin-password 临时密码

磁盘空间被占满

请调小 --storage.tsdb.retention.time,或使用 --storage.tsdb.retention.size=10GB 添加容量上限,然后执行 sudo systemctl daemon-reload 和 sudo systemctl restart prometheus。指南 在 Linux 中检查磁盘空间与使用情况 可帮助您找出占用空间的内容。

延伸阅读

如果您只有一台服务器,想要更简单的方案,请参阅指南 使用 Netdata 监控服务器。

参考资料