Nginx代理Memcached通过内存缓存API响应实现低延迟高并发，需启用memcached模块、配置键名规则、使用memcached_pass读取缓存并以error_page 404回退至后端，命中时返回HIT且响应时间显著降低。
用Nginx代理Memcached，本质是把高频读取的API响应结果缓存在内存中，让Nginx在转发请求前先查缓存——命中则直接返回，跳过后端服务，显著降低延迟和负载。
确认Nginx已启用memcached模块
Nginx需编译时包含--with-http_memcached_module，或使用主流发行版预编译包（如Ubuntu的nginx-full）。运行以下命令验证：
nginx -V 2>&1 | grep -o with-http_memcached_module
若无输出，需重新编译或换用支持该模块的版本。注意：OpenResty默认支持，但标准Nginx Mainline/Alpine镜像可能不带此模块。
配置Memcached服务与键名规则
Memcached本身无需特殊配置，但Nginx访问它依赖两点：
- 确保Memcached监听在Nginx可访问的地址（如
0.0.0.0:11211），防火墙放行端口 - 缓存键（key）必须与API请求特征严格对应，常用组合：
$scheme$host$request_uri（含查询参数）或自定义哈希如md5($host$request_uri) - 后端应用写入缓存时，务必使用相同key规则，并设置合理过期时间（如
set mykey "data" 60缓存60秒）
在location中启用memcached_pass代理
在server块内添加一个专用location，将缓存未命中时的兜底行为设为透传到上游（如FastAPI/Node.js）：
location /api/ {
set $memcached_key "$scheme$host$request_uri";
memcached_pass 127.0.0.1:11211;
error_page 404 = @fallback;
<pre class="brush:php;toolbar:false;"># 可选：添加缓存命中标识头便于调试
add_header X-Cache-Status $upstream_cache_status;
}
location @fallback { proxy_pass https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; }
关键点：
– memcached_pass仅负责读取，不写入；写入由后端完成
– error_page 404 = @fallback表示Memcached未找到key时交由@fallback处理
– 不要混用proxy_pass和memcached_pass在同一location，会冲突
验证与调优建议
部署后通过curl观察响应头和耗时：
curl -I https://example.com/api/users?limit=10
关注：
– 首次请求应返回X-Cache-Status: MISS，后续相同请求变为HIT
– 响应时间从后端的~200ms降至（纯内存读取）<br>
– 若持续MISS，检查key是否含动态内容（如时间戳、CSRF token）导致不一致<br>
– Memcached内存不足时会LRU淘汰旧数据，监控<code>curr_items和evictions指标
