From 13bf934fe6500b8736b9345ed7b0ff1002b8d79e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=9D=8E=E8=87=A3=E8=B6=85?= <517024110@qq.com>
Date: Tue, 29 Sep 2026 19:27:16 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3:=20=E8=A1=A5=E9=BD=90?=
 =?UTF-8?q?=E4=B8=89=E4=B8=AA=20exporter=EF=BC=88dcgm/ipmi/node=EF=BC=89?=
 =?UTF-8?q?=E7=9A=84=E5=AE=89=E8=A3=85=E5=AE=9E=E5=86=B5=E4=B8=8E=E8=87=AA?=
 =?UTF-8?q?=E6=A3=80=E5=91=BD=E4=BB=A4=EF=BC=8C=E9=A6=96=E6=AC=A1=E9=83=A8?=
 =?UTF-8?q?=E7=BD=B2=E6=B8=85=E5=8D=95=E5=8A=A0=E5=89=8D=E7=BD=AE=E6=AD=A5?=
 =?UTF-8?q?=E9=AA=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 DEPLOY.md | 26 ++++++++++++++++++++++++++
 README.md |  3 ++-
 2 files changed, 28 insertions(+), 1 deletion(-)

diff --git a/DEPLOY.md b/DEPLOY.md
index 43e575b..e0dbf0c 100644
--- a/DEPLOY.md
+++ b/DEPLOY.md
@@ -43,11 +43,37 @@ FastAPI 挂 `StaticFiles` 一起发出去。所以：
 | 心跳文件 | `/run/gpu-fan-console/heartbeat` | 主进程每轮写；过期则由看门狗强推 `8×0x00` 回落 |
 | 依赖的 exporter | ipmi_exporter `:9290`、node_exporter `:9100`、DCGM `:9400` | 都在 pve02 本机，都在跑 |
 
+### 2.1 三个 exporter 是怎么装的（pve02 实况，重装时照抄）
+
+控制台的**全部数据源就是这三个 exporter**（实时读数直连 `/metrics`，不走 Prometheus）。
+没有它们，控制台进程照样能起（DCGM 挂了会降级 `nvidia-smi` 兜底），但控速依据为零——
+所以**首次部署时这一步要在装控制台之前完成**。
+
+| exporter | 部署形态 | 端口 | 提供的数据 |
+|---|---|---|---|
+| dcgm-exporter | docker 容器，`nvcr.io/nvidia/k8s/dcgm-exporter:4.6.0-4.8.3-distroless`，`--restart unless-stopped`，需宿主已装 NVIDIA 驱动并以 `--gpus all` 启动 | 9400 | GPU 温度 / 功率 / 利用率 / SM 频率 |
+| ipmi_exporter | systemd 服务，`/usr/local/bin/ipmi_exporter --web.listen-address=:9290`（v1.10.1），**必须 root**（in-band 读 `/dev/ipmi0`，依赖 openipmi 驱动） | 9290 | 风扇转速 `ipmi_fan_speed_rpm` |
+| node_exporter | systemd 服务，`/usr/local/bin/node_exporter --collector.hwmon --collector.cpufreq` | 9100 | CPU 温度 `node_hwmon_temp_celsius`（`label="Tctl"`） |
+
+⚠️ node_exporter **不带 `--collector.hwmon` 就没有 hwmon 指标**，CPU 温度直接失明——
+这个 flag 是这里的关键，升级二进制时别丢。
+
+装完自检三连（各返回至少一行数据才算就位）：
+
+```bash
+curl -s localhost:9400/metrics | grep DCGM_FI_DEV_GPU_TEMP | head -1
+curl -s localhost:9290/metrics | grep ipmi_fan_speed_rpm | head -1
+curl -s localhost:9100/metrics | grep Tctl | head -1
+```
+
 ---
 
 ## 3. 首次部署（换机器 / 重装时才需要）
 
 ```bash
+# ⓪ 三个 exporter 先就位（dcgm-exporter / ipmi_exporter / node_exporter，见 2.1）
+#    它们是控制台的全部数据源，没有这一步控速无依据
+
 # ① 建目录、建 venv
 ssh pve02
 mkdir -p /opt/gpu-fan-console
diff --git a/README.md b/README.md
index d90dc20..59e45d8 100644
--- a/README.md
+++ b/README.md
@@ -32,7 +32,8 @@ scripts for Dell PowerEdge servers.**
 通过 `ipmitool raw 0x3a 0x01` 写给 BMC。
 
 - **数据采集**：GPU 温度走本地 DCGM exporter（`:9400`），风扇转速走 ipmi_exporter
-  （`:9290`），直连 exporter 读当下值；历史趋势另走 Prometheus。DCGM 不可用时降级 `nvidia-smi` 兜底
+  （`:9290`），CPU 温度走 node_exporter（`:9100`，需 `--collector.hwmon`），直连 exporter 读当下值；
+  历史趋势另走 Prometheus。DCGM 不可用时降级 `nvidia-smi` 兜底
 - **控制曲线**：分段折线 + 滞回带（升温立即生效，降温须跌出滞回带才降档，
   避免「直升机效应」）。界面上可编辑曲线并**试算预览**（`/api/curve/preview` 走真实算法）
 - **三种模式**：自动调档（按曲线）/ 手动定速（界面指定占空比）/ BMC 自动档（交还 BMC）