如何利用Njs动态根据系统I/O负载调整文件缓存策略-Nginx-PHP中文网

Nginx 通过 njs 模块消费外部预置的磁盘 I/O 状态（如 /run/nginx_io_state.json），在请求处理阶段动态控制 proxy_cache 启用与否及 Cache-Control 响应头，实现轻量级缓存熔断；njs 不采集指标，仅同步读取小文件或内存存储的快照，避免阻塞 worker。

如何利用njs动态根据系统i/o负载调整文件缓存策略

Nginx 本身不直接读取系统 I/O 负载指标（如 iostat 的 %util、await 或 /proc/diskstats 数据），但通过 njs（Nginx JavaScript 模块）可以在请求处理阶段执行轻量级逻辑判断，结合外部采集的 I/O 状态，实现缓存策略的动态切换。关键在于：njs 不负责采集 I/O，而是消费已就绪的负载信号。

以下为可落地的实施路径：

njs 如何接入系统 I/O 状态

njs 运行在 Nginx worker 进程内，无权限直接调用 iostat 或读取 /sys/block/*/stat。必须依赖外部预置机制提供“IO 健康快照”：

推荐方式：由定时脚本（如每 5 秒）将当前磁盘负载写入共享内存文件（如 /run/nginx_io_state.json），内容示例：
```
{"sda": {"util_pct": 82, "avg_await_ms": 14.7, "queue_depth": 3.2}}
```
njs 用 fs.readFileSync() 同步读取该文件（注意：仅限小文件 + 高频低开销；建议用 fs.openSync + fs.readSync 控制精度）
若文件不可读或解析失败，njs 应回退至默认缓存策略，避免中断请求

动态控制 proxy_cache 是否启用

在 location 块中使用 js_set 或 js_var 定义布尔变量，再通过 proxy_cache_bypass 和 proxy_no_cache 联动控制：

Expanso yaml-to-json

使用 Expanso Edge 管道将 YAML 输入转换为 JSON 格式。

下载

js_import /etc/nginx/io_cache.js;
js_set $use_cache io_cache.useCache;

location /api/assets/ {
    proxy_pass http://backend;
    proxy_cache my_cache;
    proxy_cache_bypass $use_cache;   # true → 不走缓存
    proxy_no_cache $use_cache;        # true → 不写缓存
}

对应 io_cache.js 示例逻辑：

function useCache(r) {
  try {
    const state = JSON.parse(fs.readFileSync('/run/nginx_io_state.json', 'utf8'));
    const sda = state.sda || {};
    // IO 利用率 > 75% 或平均延迟 > 12ms 时临时禁用缓存，减轻磁盘压力
    return (sda.util_pct > 75 || sda.avg_await_ms > 12) ? 'true' : 'false';
  } catch (e) {
    return 'false'; // 默认启用缓存
  }
}
export default { useCache };

缓存层级与参数的运行时调整

njs 无法动态修改 proxy_cache_path 或 proxy_buffers 等全局指令，但可通过 js_var 输出不同缓存键前缀或过期时间，间接影响效果：

根据 IO 负载高低，返回不同 Cache-Control 响应头：

function cacheControl(r) {
  const load = getIoLoad(); // 封装好的读取+判断函数
  return load > 80 ? 'no-store, no-cache' : 'public, max-age=300';
}

在 add_header Cache-Control $cache_control; 中引用 $cache_control 变量，让客户端/CDN 配合降级

注意事项与边界约束

njs 是同步执行环境，fs.readFileSync 必须极快（毫秒级），否则阻塞整个 worker 事件循环
/run 是 tmpfs 文件系统，确保 IO 状态文件驻留内存，避免额外磁盘读取
不要尝试在 njs 中做实时 iostat -x 1 1 调用——子进程创建开销大，且 Nginx 会拒绝 fork
若需更高频更新（如 sub-second 级），改用 memcached 或 redis 存储 IO 指标，njs 通过 ngx.location.capture 发起本地 fastcgi 请求获取（需额外配置）

njs 的价值不是替代监控系统，而是把已知的系统状态，变成 Nginx 内部可决策的缓存开关。它轻量、嵌入式、无需 reload，适合做 IO 敏感型服务的“软性熔断”。