Cache bypass conditions in Nginx - Step-by-Step Execution

Process Flow - Cache bypass conditions

Request Received

↓

Check Bypass Conditions

↓

Bypass?

↓

Fetch from

↓

Send Response

↓

End

When a request comes in, nginx checks if any bypass conditions apply. If yes, it skips cache and fetches fresh content. Otherwise, it serves cached content.

Execution Sample

Nginx

proxy_cache_bypass $http_cache_control;
proxy_no_cache $cookie_nocache;

location / {
  proxy_pass http://backend;
}

This config bypasses cache if the client sends Cache-Control header or a specific cookie.

Process Table

Step	Request Header	Cookie	Bypass Condition	Cache Used?	Action
1	Cache-Control: no-cache	nocache=0	Cache-Control triggers bypass	No	Fetch fresh content from backend
2	Cache-Control: max-age=3600	nocache=1	Cookie triggers bypass	No	Fetch fresh content from backend
3	Cache-Control: max-age=3600	nocache=0	No bypass condition met	Yes	Serve content from cache
4	No Cache-Control header	nocache=0	No bypass condition met	Yes	Serve content from cache
5	No Cache-Control header	nocache=1	Cookie triggers bypass	No	Fetch fresh content from backend

💡 Execution ends after deciding to serve from cache or fetch fresh content based on bypass conditions.

Status Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	After Step 4	After Step 5
$http_cache_control	undefined	no-cache	max-age=3600	max-age=3600	undefined	undefined
$cookie_nocache	undefined	0	1	0	0	1
Bypass?	false	true	true	false	false	true
Cache Used?	false	false	false	true	true	false

Key Moments - 3 Insights

Why does the cache get bypassed when Cache-Control header is 'no-cache'?

Because the proxy_cache_bypass variable checks $http_cache_control header. When it contains 'no-cache', the condition is true (see execution_table step 1), so cache is bypassed.

If the cookie 'nocache' is set to 1, why does cache get bypassed even if Cache-Control header allows caching?

The proxy_no_cache directive checks the cookie. If $cookie_nocache equals 1 (step 2 and 5), it triggers bypass regardless of Cache-Control header.

What happens if neither Cache-Control header nor cookie triggers bypass?

Cache is used to serve the response (steps 3 and 4). This is the normal fast path.

Visual Quiz - 3 Questions

Look at the execution table, at which step is the cache used despite a Cache-Control header being present?

A Step 2

B Step 3

C Step 1

D Step 5

💡 Hint

Check the 'Cache Used?' column for steps with Cache-Control header.

According to the variable tracker, what is the value of $cookie_nocache at step 5?

A 1

B 0

C undefined

D no-cache

💡 Hint

Look at the $cookie_nocache row under 'After Step 5'.

If the cookie 'nocache' is removed, which steps in the execution table would change their 'Bypass Condition' to 'No bypass condition met'?

A Steps 1 and 3

B Steps 4 and 5

C Steps 2 and 5

D Steps 1 and 2

💡 Hint

Check which steps have cookie triggering bypass.

Concept Snapshot

nginx cache bypass conditions:
- Use proxy_cache_bypass and proxy_no_cache to define when to skip cache
- Common triggers: HTTP headers (e.g., Cache-Control) and cookies
- If bypass condition true, request goes to backend
- Otherwise, cached content is served
- Helps serve fresh content when needed without disabling cache globally

Full Transcript

When nginx receives a request, it checks cache bypass conditions such as specific HTTP headers or cookies. If any condition matches, nginx skips the cache and fetches fresh content from the backend server. Otherwise, it serves the cached content for faster response. For example, if the client sends a Cache-Control header with 'no-cache' or a cookie named 'nocache' with value 1, nginx bypasses the cache. This selective bypass allows fresh content delivery without disabling caching for all requests. The execution table shows different request scenarios and whether cache is used or bypassed. The variable tracker follows key variables like $http_cache_control and $cookie_nocache through each step. Understanding these conditions helps configure nginx caching effectively.