From 596eda71b64a895cad29834b017d5c3349e8883d Mon Sep 17 00:00:00 2001
From: 3970260761 <3970260761@qq.com>
Date: Sun, 8 Nov 2026 01:24:27 +0800
Subject: [PATCH] =?UTF-8?q?README:=20=E8=A1=A5=E9=BD=90=E5=AE=8C=E6=95=B4?=
 =?UTF-8?q?=E9=83=A8=E7=BD=B2=E5=91=BD=E4=BB=A4+=E6=B3=A8=E6=84=8F?=
 =?UTF-8?q?=E4=BA=8B=E9=A1=B9(=E4=B8=89host/pid/privileged=E7=BC=BA?=
 =?UTF-8?q?=E4=B8=80=E4=B8=8D=E5=8F=AF/=E5=BF=AB=E7=85=A7=E8=AF=B4?=
 =?UTF-8?q?=E6=98=8E)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index aca6339..29f73cd 100644
--- a/README.md
+++ b/README.md
@@ -78,16 +78,29 @@ CPU/内存/磁盘/网络 + 进程排行 + 一键回收 + SMART/连接明细，Do
 
 ## 🚀 快速开始
 
-### 方式一：Docker 运行（推荐）
+### 方式一：Docker 运行（推荐，必须带齐参数，否则数据不准）
 
 ```bash
-docker run -d --name fnos-resmon -p 7031:7031 --privileged \
+docker run -d --name fnos-resmon \
+  --network host --pid host --privileged --restart unless-stopped \
+  -e PORT=7031 -e PROCFS_PATH=/host/proc \
   -v /proc:/host/proc:rw -v /sys:/host/sys:ro \
   jpccr.ccs.tencentyun.com/jinghui/fnos-resmon:latest
 ```
 
 启动后浏览器访问 `http://你的NASIP:7031` 即可。
 
+### ⚠️ 部署注意事项（必看，少一个参数就少一块数据）
+
+- **三个缺一不可**：`--network host`（看宿主真实网卡/流量）＋ `--pid host`（看宿主全部进程）＋ `--privileged`（调频/一键优化/传感器写入）。README 旧版简化命令缺了前两个，照抄会只能看到容器自身，直接用上面这条完整命令。
+- **两个挂载不能少**：`-v /proc:/host/proc:rw` ＋ `-v /sys:/host/sys:ro`，并配合 `-e PROCFS_PATH=/host/proc`，CPU/内存/磁盘/温度全靠它们读宿主。
+- **`host` 网络下 `-p 7031:7031` 无效**：端口即 `7031`（可用 `-e PORT=` 改），访问 `http://NAS_IP:7031`。
+- **缺参数的现象（对照排查）**：进程只有几个/看不到宿主进程＝缺 `--pid host`；网速/连接数是容器视角＝缺 `--network host`；省电/性能切换报"调频接口不可写"、一键优化失败＝缺 `--privileged` 或宿主无 cpufreq（虚拟机/VPS 无此文件属正常，监控不受影响）。
+- **CPU 调频前提**：物理机＋主板/BIOS 暴露 cpufreq（amd-pstate/intel_pstate/acpi）＋ `--privileged`。虚拟机、部分 VPS、只读 `/sys` 会失败开放：提示错误但不影响监控。
+- **硬件型号栏是构建时快照**：硬盘型号/序列号/SMART、内存条颗粒、网卡型号/网关是镜像构建那台机器的快照；换机器部署后**实时占用/流量/温度是本机的**，但型号字样还是旧机器的。想要型号也对：在新机器上 `docker build` 一份即可，实时数据不受影响。
+- **性能模式记忆（可选）**：想重启后记住上次的省电/上限档，加 `-e PERF_FILE=/run/secrets/perf_mode.json -v /root/.fnos_resmon_perf.json:/run/secrets/perf_mode.json:rw`。
+- **更新**：`docker pull jpccr.ccs.tencentyun.com/jinghui/fnos-resmon:latest && docker rm -f fnos-resmon` 后用上面完整命令重建；也可用仓库内 `docker-compose.yml`（已带齐全部参数）`docker compose up -d`。
+
 
 ---