Cache bypass conditions in Nginx - Cheat Sheet & Quick Revision

Recall & Review

beginner

What is a cache bypass condition in nginx?

A cache bypass condition tells nginx when to skip using the cache and fetch fresh content directly from the server.

beginner

How can you bypass cache based on a request method in nginx?

You can bypass cache by checking if the request method is not GET or HEAD, since usually only these methods are cached.

beginner

What directive is used to define cache bypass conditions in nginx?

The directive 'proxy_cache_bypass' is used to specify conditions under which nginx will bypass the cache.

intermediate

Give an example of a cache bypass condition using a cookie in nginx.

You can bypass cache if a specific cookie exists, for example: proxy_cache_bypass $cookie_nocache;

intermediate

Why is it important to set cache bypass conditions carefully?

Because improper bypass conditions can cause stale content to be served or reduce cache efficiency, slowing down your site.

Which nginx directive controls when to skip the cache?

A proxy_cache_valid

B proxy_cache_path

C proxy_cache_bypass

D proxy_cache_key

The 'proxy_cache_bypass' directive tells nginx when to bypass the cache.

Which HTTP request methods are typically cached in nginx?

A GET and HEAD

B POST and PUT

C DELETE and PATCH

D OPTIONS and TRACE

Only GET and HEAD requests are usually cached because they are safe and idempotent.

How can you bypass cache when a user is logged in using nginx?

A Disable proxy_cache_path

B Use proxy_cache_valid 0

C Set proxy_cache_key to user ID

D Check for a session cookie and use proxy_cache_bypass

By checking a session cookie with proxy_cache_bypass, nginx can skip cache for logged-in users.

What happens if you do not set any cache bypass conditions?

A All requests may be served from cache, even when fresh content is needed

B Cache is always bypassed

C Cache is disabled

D Nginx will throw an error

Without bypass conditions, nginx may serve stale content from cache when fresh content is required.

Which variable can be used to bypass cache based on a query string?

A $host

B $arg_nocache

C $http_cookie

D $request_method

The variable '$arg_nocache' checks for a query string parameter to bypass cache.

Explain how to configure nginx to bypass cache for POST requests and logged-in users.

Think about conditions that tell nginx when to skip cache.

Describe why cache bypass conditions are important for website performance and content freshness.

Consider the balance between speed and freshness.

Practice

1. What is the main purpose of cache bypass conditions in nginx?

easy

A. To increase the cache size automatically

B. To compress cached content before serving

C. To delete cached files periodically

D. To tell nginx when to skip serving cached content

Solution

1. Step 1: Understand cache bypass meaning

   Cache bypass conditions define when nginx should not use cached content.

2. Step 2: Identify the main purpose

   The main goal is to skip cached content under certain conditions, like logged-in users.

3. Final Answer:

   To tell nginx when to skip serving cached content -> Option D

4. Quick Check:

   Cache bypass = skip cache [OK]

Hint: Cache bypass means skipping cache, not managing size or deletion [OK]

Common Mistakes:

• Confusing bypass with cache size management
• Thinking bypass deletes cache
• Assuming bypass compresses content

2. Which of the following is the correct syntax to bypass cache in nginx when a cookie named skip_cache is set?

easy

A. set $skip_cache 1 if ($cookie_skip_cache);

B. set $skip_cache 1 if ($cookie_skip_cache = 1);

C. set $skip_cache 1 if ($cookie_skip_cache != '');

D. set $skip_cache 1 if ($cookie_skip_cache == 'true');

Solution

1. Step 1: Understand cookie variable usage

   In nginx, $cookie_name holds the cookie value or empty if not set.

2. Step 2: Check correct condition to detect cookie presence

   Checking if $cookie_skip_cache is not empty string means cookie is set.

3. Final Answer:

   set $skip_cache 1 if ($cookie_skip_cache != ''); -> Option C

4. Quick Check:

   Check cookie not empty = bypass cache [OK]

Hint: Use != '' to check if cookie exists, not equality to 1 or 'true' [OK]

Common Mistakes:

• Using = instead of != for condition
• Comparing cookie to 1 or 'true' incorrectly
• Missing quotes around empty string

3. Given this nginx config snippet:

set $skip_cache 0;
if ($request_method = POST) {
  set $skip_cache 1;
}
if ($arg_nocache = 1) {
  set $skip_cache 1;
}

proxy_cache_bypass $skip_cache;

What happens when a POST request with ?nocache=1 is sent?

medium

A. Cache is used because $skip_cache remains 0

B. Cache is bypassed because $skip_cache is set to 1

C. Cache is bypassed only if request method is GET

D. Configuration causes syntax error and no caching

Solution

1. Step 1: Analyze conditions setting $skip_cache

   Both if blocks set $skip_cache to 1 if request method is POST or arg_nocache=1.

2. Step 2: Evaluate given request

   Request is POST and has nocache=1, so both conditions set $skip_cache=1.

3. Final Answer:

   Cache is bypassed because $skip_cache is set to 1 -> Option B

4. Quick Check:

   POST or nocache=1 sets skip_cache=1 [OK]

Hint: If any bypass condition matches, $skip_cache becomes 1 [OK]

Common Mistakes:

• Assuming POST requests use cache
• Ignoring query parameter condition
• Thinking config syntax is invalid

4. You wrote this nginx config to bypass cache for logged-in users:

set $skip_cache 0;
if ($http_cookie ~* "user_logged_in=1") {
  set $skip_cache 1;
}
proxy_cache_bypass $skip_cache;

But cache is still used for logged-in users. What is the likely error?

medium

A. The if condition does not reliably support regex matching

B. The variable $skip_cache is not initialized before if

C. The regex in if condition is incorrect syntax

D. The proxy_cache_bypass directive is missing a semicolon

Solution

1. Step 1: Understand nginx if limitations

   nginx if does not reliably support regex matching with ~ or ~* operators for cache bypass.

2. Step 2: Identify common pitfall with if in nginx

   nginx if inside server/location blocks can be tricky; better to use map for cache bypass.

3. Step 3: Recognize that if with regex may not work as expected for cache bypass

   Using if with regex in this way often fails for cache bypass.

4. Final Answer:

   The if condition does not reliably support regex matching -> Option A

5. Quick Check:

   nginx if regex often unreliable for cache bypass [OK]

Hint: Use map directive instead of if for reliable cache bypass [OK]

Common Mistakes:

• Assuming if regex always works for cache bypass
• Forgetting to initialize variables
• Missing semicolons causing errors

5. You want to bypass cache only if the request method is POST or the URL contains nocache=1, but not for logged-in users with cookie user_logged_in=1. Which nginx config snippet correctly implements this?

hard

A. set $skip_cache 0;
if ($request_method = POST) {
set $skip_cache 1;
}
if ($arg_nocache = 1) {
set $skip_cache 1;
}
if ($http_cookie ~* "user_logged_in=1") {
set $skip_cache 0;
}
proxy_cache_bypass $skip_cache;

B. map $http_cookie $skip_cache {
default 1;
~user_logged_in=1 0;
}
if ($request_method = POST) {
set $skip_cache 1;
}
if ($arg_nocache = 1) {
set $skip_cache 1;
}
proxy_cache_bypass $skip_cache;

C. map $http_cookie $skip_cache {
default 0;
~user_logged_in=1 1;
}
if ($request_method = POST) {
set $skip_cache 1;
}
if ($arg_nocache = 1) {
set $skip_cache 1;
}
proxy_cache_bypass $skip_cache;

D. map $http_cookie $skip_cache {
default 0;
~user_logged_in=1 0;
}
if ($request_method = POST) {
set $skip_cache 1;
}
if ($arg_nocache = 1) {
set $skip_cache 1;
}
proxy_cache_bypass $skip_cache;

Solution

1. Step 1: Understand the requirement

   Bypass cache if POST or nocache=1, but do NOT bypass if user_logged_in=1 cookie is present.

2. Step 2: Analyze each option

   Options A and B use map but do not reset skip_cache correctly for logged-in users. map $http_cookie $skip_cache { default 0; ~user_logged_in=1 1; } if ($request_method = POST) { set $skip_cache 1; } if ($arg_nocache = 1) { set $skip_cache 1; } proxy_cache_bypass $skip_cache; sets skip_cache=1 for logged-in users, which is opposite. set $skip_cache 0; if ($request_method = POST) { set $skip_cache 1; } if ($arg_nocache = 1) { set $skip_cache 1; } if ($http_cookie ~* "user_logged_in=1") { set $skip_cache 0; } proxy_cache_bypass $skip_cache; sets skip_cache=1 for POST or nocache=1, then resets to 0 if user_logged_in=1 cookie exists, correctly preventing bypass.

3. Final Answer:

   set $skip_cache 0; if ($request_method = POST) { set $skip_cache 1; } if ($arg_nocache = 1) { set $skip_cache 1; } if ($http_cookie ~* "user_logged_in=1") { set $skip_cache 0; } proxy_cache_bypass $skip_cache; -> Option A

4. Quick Check:

   Set bypass then reset for logged-in users [OK]

Hint: Set bypass first, then reset skip_cache to 0 for logged-in users [OK]

Common Mistakes:

• Setting skip_cache=1 for logged-in users by mistake
• Using map incorrectly without reset logic
• Not resetting skip_cache after conditions