Nginx之memcached_module模块解读

深碍√TFBOYSˉ_ 2023-10-16 13:21 50阅读 0赞

**目录**

基本介绍

安装添加模块

模块配置指令

--------------------

#### 基本介绍 ####

nginx的memcached\_module模块可以直接从memcached服务器中读取内容后输出，后续的请求不再经过应用程序处理，如php-fpm、django，大大的提升动态页面的速度。nginx只负责从memcached服务器中读取数据，要往memcached写入数据还得需要后台的应用程序来完成，主动的将要缓存的页面缓存到memcached中，可以通过404重定向到后端去处理的。

> nginx 只负责'从memcached'读取'指定'的'缓存数据' --> nginx'只负责从memcached读'
> 
> 后台'应用程序'通过'相关逻辑'将要'缓存的页面'推送到memcached,方便nginx'去调用' -->'后台程序负责写'

![61de234aba884a229ce6be515096a2cc.png][]

> Nginx 的 ngx\_http\_memcached\_module 模块本身并没有提供缓存功能，它只是一个将用户请求转发到 Memcached 服务器的代理模块。

#### 安装添加模块 ####

安装第三方模块：ngx\_http\_php\_memcache\_standard\_balancer-master

*  解压到path/ngx\_module
 *  配置：`./configure --prefix=/xxx/xxx-add_module=path/ngx_module`
 *  编译安装：`make && make install`

#### 模块配置指令 ####

server {
        location / {
            set            $memcached_key "$uri?$args";  # 设置Memcached缓存key
            memcached_pass 127.0.0.1:11211;              # 设置被代理Memcached地址
            error_page     404 502 504 = @fallback;      # 返回状态码404、502、504时跳入内部请求
        }
    
        location @fallback {
            proxy_pass     http://backend;               # 将请求转发给后端服务器
        }
    }

<table> 
 <tbody> 
  <tr> 
   <th style="width:201px;">指令名称</th> 
   <th style="width:157px;">指令值格式</th> 
   <th style="width:94px;">默认值</th> 
   <th>指令说明</th> 
  </tr> 
  <tr> 
   <td style="width:201px;">memcached_bind</td> 
   <td style="width:157px;">address[transparent]<br> 或 off</td> 
   <td style="width:94px;">--</td> 
   <td>设置从指定的本地 IP 地址及端口与 Memcached 服务器建立连接，指令值可以是变量。指令值参数为 transparent 时，允许将客户端的真实 IP 透传给被代理服务器，并以客户端真实 IP 为访问被代理服务器的源 IP，指令值为 off 时，则取消上一层指令域同名指令的配置</td> 
  </tr> 
  <tr> 
   <td style="width:201px;">memcached_buffer_size</td> 
   <td style="width:157px;">size</td> 
   <td style="width:94px;">4k 或 8k</td> 
   <td>设置用于读取 Memcached 服务器，读取响应数据缓冲区的大小，当 Nginx 收到响应数据后，将同步传递给客户端</td> 
  </tr> 
  <tr> 
   <td style="width:201px;">memcached_connect_timeout</td> 
   <td style="width:157px;">time</td> 
   <td style="width:94px;">60s</td> 
   <td>Nginx 与 Memcached 服务器建立连接的超时时间，通常不应超过 75s</td> 
  </tr> 
  <tr> 
   <td style="width:201px;">memcached_force_ranges</td> 
   <td style="width:157px;">on 或 off</td> 
   <td style="width:94px;">off</td> 
   <td>启用来自 Memcached 服务器的缓存和未缓存响应的 byte-range 请求支持，而不考虑这些响应头中的 Accept-Ranges 字段</td> 
  </tr> 
  <tr> 
   <td style="width:201px;">memcached_gzip_flag</td> 
   <td style="width:157px;">flag</td> 
   <td style="width:94px;">--</td> 
   <td>启用对 Memcached 服务器缓存数据 fags 的测试，flags 为客户端写入缓存时的自定义标记，此处用以判断缓存数据是否被压缩存储，如果数据被压缩存储，则将响应头字段 Content-Encoding 设置为 gzip</td> 
  </tr> 
  <tr> 
   <td style="width:201px;">memcached_next_upstream</td> 
   <td style="width:157px;">error、timeout、<br> invalid_header、<br> not found 或 off...</td> 
   <td style="width:94px;">error timeout</td> 
   <td>当出现指令值中指定的条件时，将未返回响应的客户请求传递给 upstream 中的下一个服务器</td> 
  </tr> 
  <tr> 
   <td style="width:201px;">memcached_next_upstream_timeout</td> 
   <td style="width:157px;">time</td> 
   <td style="width:94px;">0</td> 
   <td>设置将符合条件的客户端请求传递给 upstream 中下一个服务器的超时时间。0 为不做超时限制，遍历完所有上游服务器组中的服务器为止</td> 
  </tr> 
  <tr> 
   <td style="width:201px;">memcached_next_upstream_tries</td> 
   <td style="width:157px;">number</td> 
   <td style="width:94px;">0</td> 
   <td>设置符合条件的客户端请求传递给upstream中下一个服务器的尝试次数，包括第一次失败的次数。0为不做尝试次数限制，遍历完所有上游服务器组中的服务器为止</td> 
  </tr> 
  <tr> 
   <td style="width:201px;">memcached_pass</td> 
   <td style="width:157px;">address</td> 
   <td style="width:94px;">--</td> 
   <td>设置 Memcached 服务器的地址及端口，地址可以是 IP、域名或 UNIX 套接字</td> 
  </tr> 
  <tr> 
   <td style="width:201px;">memcached_read_timeout</td> 
   <td style="width:157px;">time</td> 
   <td style="width:94px;">60s</td> 
   <td>在连续两个从 Memcached 服务器接收数据的读操作之间的间隔时间超过设置的时间时，将关闭连接</td> 
  </tr> 
  <tr> 
   <td style="width:201px;">memcached_send_timeout</td> 
   <td style="width:157px;">time</td> 
   <td style="width:94px;">60s</td> 
   <td>在连续两个发送到 Memcached 服务器的写操作之间的间隔时间超过设置的时间时，将关闭连接</td> 
  </tr> 
  <tr> 
   <td style="width:201px;">memcached_socket_keepalive</td> 
   <td style="width:157px;">on 或 off</td> 
   <td style="width:94px;">off</td> 
   <td>设置 Nginx 与 Memcached 服务器的 TCP keepalive 行为的心跳检测机制，默认使用操作系统的 socket 配置，若指令值为 on，则开启 SO_KEEPALIVE 选项进行心跳检测</td> 
  </tr> 
 </tbody> 
</table>

>  **$memcached\_key**
> 
> 定义从 memcached 服务器获取响应的键。

[61de234aba884a229ce6be515096a2cc.png]: https://img-blog.csdnimg.cn/61de234aba884a229ce6be515096a2cc.png