银河麒麟系统Prometheus安装配置方法详解

在银河麒麟系统上部署Prometheus，其实是一项需要细致操作的任务。先跟大家说明几个关键要点：必须准确确认你的CPU架构是ARM64还是AMD64；安装路径要规范，不能随意解压；必须使用非root用户启动，最后还要注册为systemd服务。如果跳过这些步骤，后续启动失败、端口不监听、配置不生效等问题几乎必然出现。

在银河麒麟系统上完成Prometheus的安装与配置，有几个硬性门槛无法绕过：架构必须匹配、路径必须规范、用户必须非root、systemd必须注册。否则，执行出错、端口处于空闲状态、配置无法加载，这些麻烦迟早会找上门来。

确认系统架构并下载对应安装包

第一步，搞清楚手头机器的架构类型。执行 uname -m，如果返回的是 【aarch64】，那就直接下载 linux-arm64.tar.gz 包；如果是 x86_64，则去获取 linux-amd64.tar.gz。选错的话会直接报错“cannot execute binary file”，这个错误信息很明确，不需要怀疑自己的操作。

Prometheus 的官方 Release 页面上提供了各版本的下载链接，例如 v2.49.1 的 ARM64 包地址如下：
https://github.com/prometheus/prometheus/releases/download/v2.49.1/prometheus-2.49.1.linux-arm64.tar.gz

使用 wget 拉取后，顺手校验一下 SHA256 值，避免下载文件损坏：
wget https://github.com/prometheus/prometheus/releases/download/v2.49.1/prometheus-2.49.1.linux-arm64.tar.gz && sha256sum prometheus-2.49.1.linux-arm64.tar.gz

创建标准部署目录并解压

解压这个操作，千万不要放在 /root 或者当前用户的家目录下。如果那样做，后续 systemd 服务启动时，会因为权限问题或路径不可靠而直接罢工。

正确的做法是建立一个规范的目录结构：
mkdir -p /opt/prometheus/{bin,conf,data}

然后解压到 bin 目录，并去掉顶层文件夹：
tar -zxvf prometheus-2.49.1.linux-arm64.tar.gz -C /opt/prometheus/bin --strip-components=1

接下来，把默认的配置模板复制到 conf 目录：
cp /opt/prometheus/bin/prometheus.yml /opt/prometheus/conf/

最后，给主程序添加可执行权限：
chmod +x /opt/prometheus/bin/prometheus

配置自监控并验证语法

Prometheus 的默认配置基本上是空的。如果不添加抓取目标，稍后你在 Web 界面上会看到“No targets”，metrics 接口也无法获取数据。

编辑配置文件：
vim /opt/prometheus/conf/prometheus.yml

在 scrape_configs: 下面，插入一个静态任务（注意缩进必须是2个空格）：

- job_name: 'prometheus'
  static_configs:
  - targets: ['localhost:9090']

同时，记得在 global: 块里设置好采集间隔。在ARM平台上，建议不要低于30s，如果间隔太短，低性能设备可能会承受不住：
scrape_interval: 30s

保存后，用 promtool 检查语法，这个检查直接决定了后续能否正常运行：
/opt/prometheus/bin/promtool check config /opt/prometheus/conf/prometheus.yml 输出“SUCCESS”才说明配置没有问题。

创建专用用户并手动启动验证

第一步，创建一个没有登录权限的专用用户：
useradd -r -s /sbin/nologin prometheus

第二步，将整个部署目录的归属权交给这个用户：
chown -R prometheus:prometheus /opt/prometheus

第三步，切换到这个用户，在前台运行一下 Prometheus，观察日志是否有异常：

sudo -u prometheus /opt/prometheus/bin/prometheus 
  --config.file=/opt/prometheus/conf/prometheus.yml 
  --storage.tsdb.path=/opt/prometheus/data 
  --web.console.libraries=/opt/prometheus/bin/console_libraries 
  --web.console.templates=/opt/prometheus/bin/consoles

第四步，另开一个终端，检查 9090 端口是否在监听：
ss -tlnp | grep :9090 看到 prometheus 的进程存在，就说明启动成功。

第五步，打开浏览器，访问 http://本机IP:9090/targets，确认状态那一栏显示为 UP，标签中显示 instance="localhost:9090"。

注册为 systemd 服务实现开机自启

创建服务文件：
sudo vim /etc/systemd/system/prometheus.service

填入以下内容，注意 User 和 ExecStart 的路径必须与实际部署的一致：

[Unit]
Description=Prometheus Monitoring System
After=network.target

[Service]
Type=simple
User=prometheus
Group=prometheus
ExecStart=/opt/prometheus/bin/prometheus 
  --config.file=/opt/prometheus/conf/prometheus.yml 
  --storage.tsdb.path=/opt/prometheus/data 
  --web.console.libraries=/opt/prometheus/bin/console_libraries 
  --web.console.templates=/opt/prometheus/bin/consoles 
  --web.enable-lifecycle
Restart=always
RestartSec=10
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

重载 systemd 配置，然后启用并立即启动服务：
sudo systemctl daemon-reload && sudo systemctl enable --now prometheus

最后，检查服务状态：
sudo systemctl status prometheus 输出中包含“active (running)”，整个部署就算完成了。