安装 Prometheus 和 Grafana
在 Debian 或 Ubuntu 上不使用 Docker 安装 Prometheus、node_exporter 和 Grafana,包含仪表板、受保护的 HTTPS 访问、更新与备份。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南介绍如何在运行 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 enable3000、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.ymlglobal:
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.targetsudo 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.yamlapiVersion: 1
datasources:
- name: Prometheus
type: prometheus
access: proxy
url: http://127.0.0.1:9090
isDefault: true
editable: falsesudo 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.confmap $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 = falsesudo systemctl restart grafana-server导入仪表板
- 打开
https://grafana.您的域名.com并登录。 - 在主菜单中点击 Dashboards。
- 点击 New,然后点击 Import dashboard。
- 输入 ID
1860(Node Exporter Full),然后点击 Load。 - 选择数据源 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,然后将该哈希值粘贴进去:
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然后进行以下三项修改:
-
在
prometheus.service中,将--web.config.file=/etc/prometheus/web.yml添加到ExecStart命令中。 -
在
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"] -
在 Grafana 数据源中,添加凭据:
YAMLbasicAuth: 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:
- 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 --versionnode_exporter:同样重复其下载和安装步骤,然后执行:
sudo systemctl restart node_exporter
node_exporter --versionGrafana:软件包通过 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 prometheusGrafana
默认情况下,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 监控服务器。