在 linux 中配置 nginx 的 memcached 缓存模块,核心步骤是编译安装带有 --with-http_memcached_module 参数的 nginx,并在配置文件中使用 memcached_pass 指令将请求转发给 memcached 服务。具体做法是在 location 块中指定 memcached 服务器的地址和端口,nginx 会自动根据 uri 作为 key 进行查询,若命中则直接返回内容,未命中时通常配合 error_page 回源到后端服务器。

Nginx 如何编译启用 Memcached 模块
要使用 Memcached 功能,必须确保 Nginx 二进制文件包含该模块。默认编译通常不包含此模块,因此需要重新编译源码。执行 ./configure --with-http_memcached_module 命令即可启用支持,随后运行 make 和 make install 完成安装。这一步是后续所有配置的基础,缺少该模块会导致 Nginx 启动时报错或忽略相关指令。

# 假设源码目录为 /usr/local/src/nginx-1.24.0
cd /usr/local/src/nginx-1.24.0
./configure --prefix=/etc/nginx \
--sbin-path=/usr/sbin/nginx \
--conf-path=/etc/nginx/nginx.conf \
--with-http_memcached_module
make
make install
上述代码展示了标准的编译流程。关键参数是 --with-http_memcached_module。编译完成后,可以通过 nginx -V 查看已加载的模块列表,确认输出中包含 http_memcached_module。如果使用的是包管理器安装的 Nginx(如 apt 或 yum),某些发行版的非核心包可能已预编译该模块,但源码编译是最可控的方式。
Location 块中如何配置 memcached_pass
在 Nginx 配置文件中,需要在 server 块内的 location 中使用 memcached_pass 指令。该指令接受一个地址字符串,格式通常为 host:port。Nginx 会将当前请求的 URI 作为 Key 发送给 Memcached 服务器。如果 Memcached 中存在该 Key,Nginx 直接返回存储的内容;如果不存在,Nginx 会返回错误码 404,此时需要通过 error_page 指令将请求重定向到后端应用服务器以获取数据并填充缓存。

server {
listen 80;
server_name example.com;
location / {
# 设置 Memcached 服务器地址
set $memcached_key $uri;
memcached_pass 127.0.0.1:11211;
# 当 Memcached 未命中时,回源到后端
error_page 404 = @backend;
}
location @backend {
proxy_pass http://127.0.0.1:8080;
}
}
这段配置定义了完整的缓存回源逻辑。set $memcached_key $uri; 显式指定了使用 URI 作为缓存键,虽然这是默认行为,但显式声明更清晰。memcached_pass 127.0.0.1:11211; 指向本地运行的 Memcached 实例。error_page 404 = @backend; 处理缓存未命中的情况,将请求内部重定向到 @backend 位置,由 proxy_pass 转发给后端 Web 服务。这种模式实现了典型的 Cache-Aside 或 Read-Through 缓存策略。
Memcached 未命中时如何正确回源并更新缓存
当 Memcached 中没有请求对应的数据时,Nginx 返回 404 状态码。为了保持缓存一致性,后端服务器在处理完请求后需要将结果写入 Memcached。然而,Nginx 的 memcached_pass是只读的,它无法主动写入数据。因此,回源逻辑必须由后端应用负责。后端应用在生成响应后,应计算相同的 Key(即 URI)并将内容存入 Memcached。这样,下一次相同 URI 的请求就能直接从 Nginx 的缓存层获取数据,无需再次访问后端。


















