<p class="shortdesc">file-cache用户将后端文件缓存到Kong端，减少对后端服务的访问。</p> <p class="p"><strong class="ph b">注意</strong>：如果缓存的文件比较多，比较大则需要添加NAS盘映射，避免POD因为磁盘比较大出现异常。缓存默认是保存到/usr/share/kong/webroot/file_cache目录下。</p> <p class="p"><strong class="ph b">2.0.4版本及以后支持</strong></p> <section class="section" id="file-cache__section_gtx_4xc_fsb"><h2 class="doc-tairway">插件配置字段说明</h2> <div class="p"> <table class="table" id="file-cache__table_erd_cyc_fsb"><caption></caption><colgroup><col><col><col><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry align-left" id="file-cache__table_erd_cyc_fsb__entry__1">参数名</th> <th class="entry align-left" id="file-cache__table_erd_cyc_fsb__entry__2">参数类型</th> <th class="entry align-left" id="file-cache__table_erd_cyc_fsb__entry__3">是否必须</th> <th class="entry align-left" id="file-cache__table_erd_cyc_fsb__entry__4">默认值</th> <th class="entry align-left" id="file-cache__table_erd_cyc_fsb__entry__5">参数说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__1 ">rules</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__2 ">array</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__3 ">Y</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__4 "></td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__5 ">可缓存请求的匹配规则</td> </tr> <tr class="row"> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__1 ">uri</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__2 ">array</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__3 ">Y</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__4 "></td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__5 ">rules数组下对象内的字段，用于声明可以缓存的链接地址。支持正则表达式。</td> </tr> <tr class="row"> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__1 ">request_method</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__2 ">array</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__3 ">Y</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__4 ">GET,HEAD</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__5 ">用于声明可以缓存的请求方法。</td> </tr> <tr class="row"> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__1 ">vary_query_params</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__2 ">array</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__3 ">Y</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__4 ">[]</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__5 ">用于生成缓存Key的请求字段名列表</td> </tr> <tr class="row"> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__1 ">vary_headers</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__2 ">array</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__3 ">N</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__4 ">[]</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__5 ">用于生成缓存Key的header字段名列表</td> </tr> <tr class="row"> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__1 ">response_code</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__2 ">array</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__3 ">Y</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__4 ">200, 301, 304</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__5 ">返回结果状态码，只有状态码在这个列表内才可以缓存</td> </tr> <tr class="row"> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__1 ">storage_ttl</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__2 ">number</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__3 ">Y</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__4 ">600</td> <td class="entry align-left" headers="file-cache__table_erd_cyc_fsb__entry__5 ">缓存有效时间，过期后会重新从后台获取数据</td> </tr> </tbody></table> </div> </section> <section class="section" id="file-cache__section_qjp_cyc_fsb"><h2 class="doc-tairway">插件配置示例</h2> <p class="p"><img class="image" id="file-cache__image_ttq_5pd_fsb" src="https://obs-cn-shanghai.fincloud.pinganyun.com/pacloud/20220910180811-19fb9f4a9594.png" width="800"></p> </section>