直接将 proxy_temp_path 指向独立高性能磁盘（如 NVMe SSD）可切断临时文件写入与系统 I/O 耦合，避免密集小文件随机写引发的磁盘颠簸；需确认 ROTA=0、绕过 LVM/加密/NFS、配置两级哈希子目录、挂载启用 noatime/nobarrier/commit=60，并调大内存缓冲或关闭缓冲直传。
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
为什么磁盘颠簸常源于 proxy_temp_path
高并发代理场景下，大量中等大小响应（几十 KB 到几 MB）会反复触发临时文件创建、同步写入、rename 移动。这些操作集中在默认路径（如 /var/tmp/nginx_temp），而该路径往往落在根分区或 SATA 盘上：
• 每次写 .tmp 文件都要更新 inode 和目录项，元数据压力大
• 多个 worker 进程并发写，产生大量随机 I/O，await 值飙升、%util 接近 100%
• 系统盘同时承载 journal、rsyslog、docker overlay 等，I/O 队列排队拉长，连带影响 Nginx accept 和 SSL 握手延迟
• 看似是“CPU 高”或“连接超时”，实则是 iowait 占比突增，top 里 wa% >30%，但 error.log 几乎无报错
用独立 NVMe SSD 承载 proxy_temp_path
关键不是“挂 SSD”，而是确保路径真正跑在低延迟物理介质上：
• 确认设备类型：运行 lsblk -d -o NAME,ROTA,MODEL，目标盘 ROTA=0 且型号含 NVMe
• 绕过逻辑层：不挂 LVM、LUKS 加密卷、ZFS 或 NFS；findmnt -T /ssd 应直接指向 /dev/nvme0n1p1
• 新建专用目录并赋权：mkdir -p /ssd/nginx_temp && chown nginx:nginx /ssd/nginx_temp
• 启用两级哈希子目录：在 http 块中写 proxy_temp_path /ssd/nginx_temp 1 2;，避免单目录文件过多导致 lookup 慢
挂载与缓冲协同压降 I/O 压力
光换盘不够，要配合文件系统级优化降低同步开销：
• 挂载时加 noatime,nobarrier,commit=60（ext4/xfs 下适用，需业务可容忍极小元数据风险）
• 调大内存缓冲，减少实际落盘次数：
proxy_buffer_size 128k;
proxy_buffers 8 256k;（总 2MB，覆盖 95% API/HTML 响应）
proxy_busy_buffers_size 512k;
• 对视频、ISO 等纯流式内容，直接关缓冲：proxy_buffering off; sendfile on;，跳过临时文件全流程
验证是否真正消除颠簸
重启后不能只看配置，要观测真实行为：
• 用 iostat -x 1 对比 /dev/nvme0n1 和系统盘的 await（应 %util（应
• 访问一个 10MB 文件，检查 /ssd/nginx_temp 下是否生成类似 a/3f/xxx.tmp 的多级子目录，而非空或只在 /var/tmp 出现
• 压测期间观察 wa% 是否稳定在 5% 以内，同时 access log 中 >500ms 请求比例下降明显
