Skip to content
Script that allows to inspect the Nginx cache
Branch: master
Clone or download
Pull request Compare This branch is 3 commits ahead of perusio:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Bash script for inspecting an item or set of items from Nginx cache


This simple script inspects an item or set of items from Nginx cache, be it fastcgi or proxy.

It accepts a grep pattern as argument to search for cached items in the given cache directory.

It prints the cache key, Time To Live (TTL) and expire date. Both TTL and expire are printed in UNIX time.

This script uses grep basic regular expressions. Pressuposes the use of GNU grep.

The script requires r (read) access to the cache directory.


  1. Inspect foobar.css from the /var/cache/nginx/baz cache.

    nginx-cache-inspector "foobar.cs" /var/cache/nginx/baz
  2. Inspect all JPEG files from the /var/cache/nginx/img cache.

    nginx-cache-inspector "\.jpe*g" /var/cache/nginx/img 


  1. Clone the repo:

    git clone git://
  2. Place the script in a convenient place.

  3. Done.

See also

There's another script on github for purging items from the cache.

You can’t perform that action at this time.