必须用 --device-write-iops 限制容器写IOPS，仅对Direct I/O生效；需先确认设备号（如8:0）和挂载路径，docker-compose不支持该参数，须用docker run；验证时需加oflag=direct并检查cgroup io.max。
要在容器启动时精确限制其向宿主机磁盘写入的每秒IO次数（IOPS），必须使用 --device-write-iops 参数，该参数直接作用于底层块设备，且仅对 Direct I/O 生效；若用 Buffered I/O（如普通 echo > file）测试，限速将完全失效。
确认目标设备号与路径
先在宿主机上查清容器实际写入的物理设备。运行 ls -l /dev/sda，若输出含 8, 0，则设备号为 8:0；NVMe 盘如 /dev/nvme0n1 通常对应 259:0。这一步不可跳过——【设备号写错，限速静默失效】。
再确认容器内数据卷挂载点（如 /data）对应的宿主机路径，然后用 df -h /mnt/data 或 findmnt -T /mnt/data 追溯到底层设备。
用 docker run 显式传参设置写IOPS
docker-compose.yml 不支持 --device-write-iops 字段，v3.x schema 未定义该参数，Swarm 模式也不支持。必须绕过 Compose，改用 docker run 启动：
方法一：限制写入 /dev/sda 设备为 300 IOPSdocker run -d --device-write-iops /dev/sda:300 --name myapp nginx
方法二：同时限制读写（推荐组合使用）docker run -d --device-read-iops /dev/sda:200 --device-write-iops /dev/sda:300 --device-read-bps /dev/sda:10mb --device-write-bps /dev/sda:15mb redis
注意：bps 和 iops 必须配套设，否则单次大 IO 可能打满带宽，让 iops 限制形同虚设。
验证限速是否生效
第一步：进入容器：docker exec -it myapp sh
第二步：生成测试文件（避免缓存干扰）：dd if=/dev/zero of=/tmp/testfile bs=4k count=10000
第三步：用 Direct I/O 测速：time dd if=/dev/zero of=/tmp/out bs=4k count=10000 oflag=direct
观察输出中的 “copied, X.X s, Y.Y MB/s” —— 若设备是 SATA SSD（典型 4K 随机写约 50–150K IOPS），而你设了 300 IOPS，实测应接近 1.2 MB/s（300 × 4 KB）。不加 oflag=direct 会走 PageCache，结果可能是 GB/s 级，那说明限速根本没起作用。
第四步：检查 cgroup 设置（cgroup v2 路径）：cat /sys/fs/cgroup/docker/$(cat /proc/1/cpuset | cut -d'/' -f3)/io.max | grep "8:0 write"，应看到类似 8:0 300 的条目。
