README: 补齐完整部署命令+注意事项(三host/pid/privileged缺一不可/快照说明)

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`。
+
 
 ---