Summary
File Browser enforces per-user scope with afero.NewBasePathFs(afero.NewOsFs(), scope), set up in users/users.go. This blocks lexical ../ traversal, but it does not stop the HTTP file handlers from following symbolic links before they open, serve, write, share, or list a file. As a result, a scoped user, and in some cases an unauthenticated public-share recipient, can cross the intended scope boundary by following a symlink whose path is lexically inside their scope but whose target is outside it.
Two distinct shapes are covered here:
- Variant 1, symlink as the final path component. A symlink that lives inside the user's scoped tree and points to a file under the server root but outside the scope. The handlers record the symlink (
IsSymlink) but then resolve and operate on the target anyway. - Variant 2, file or directory reached through a symlinked ancestor. A regular file requested through a symlinked directory.
Read, write (including TUS resumable uploads), share creation, and public-share serving are all affected.
Technical details
Users are rooted with afero.NewBasePathFs(afero.NewOsFs(), scope). Base-path rooting blocks lexical ../ traversal but does not prevent ordinary filesystem operations from following a symlink whose path is lexically inside the base.
The metadata layer records symlinks but does not consistently re-check the resolved target against the user's real scope:
- In
files/file.go,stat()callsLstatIfPossible, setsIsSymlink, and only invokes theWithinScopecontainment check whenfile.IsSymlink == true. For Variant 1, this guard (where present) covers the final-element symlink; on the commit tested for Variant 1 the handler still resolved the target withopts.Fs.Stat(opts.Path)and served it. For Variant 2,LstatIfPossiblefollows a symlinked ancestor and returns the leaf as a regular file (IsSymlink == false), sostat()returns early and the scope check never runs at all. readListinginfiles/file.gofollows symlink entries to display the target's metadata.http/raw.gobuilds a file object for the requested path and serves non-directories; its archive walkergetFilesfollows symlinks viaStat/Open, pulling linked descendants into archive downloads.http/resource.gowrites request bodies withwriteFile(d.user.Fs, r.URL.Path, ...), and the destination open follows symlinks.http/tus_handlers.go(tusPostHandler,tusPatchHandler) callsMkdirAll/OpenFileon the request path directly with no containment check. Because a brand-new leaf does not stat an existing file, it skips the scope check entirely.http/share.gostores a share forr.URL.Pathwithout checking that the path is not a symlink escape;http/public.golater serves it for unauthenticated downloads (routed athttp/http.go:90-91).http/data.goapplies dotfile and rule checks to the request path string, but never compares the resolved symlink target against the user's real scope.
Proof of concept
Variant 1, symlink as final path component
Harness layout: server root is a temp directory; restricted user restricted is scoped to /u1 with create, modify, rename, share, and download permissions; a second scope /u2 holds the outside target /u2/secret.txt containing other-secret; and /u1/link-out is a symlink to /u2/secret.txt.
Confirmed bypasses (route-level tests against the real HTTP handlers):
GET /api/raw/link-out→200 OK, body containsother-secretfrom/u2/secret.txt.POST /api/resources/link-out?override=true→200 OK,/u2/secret.txtchanged topwn.POST /api/tus/link-out?override=true→201, thenPATCH /api/tus/link-out→204,/u2/secret.txtchanged.POST /api/share/link-out→200 OK, created a public share whoseGET /api/public/dl/{hash}returned a body containingother-secret.
Minimal core of the read proof:
root := t.TempDir()
os.MkdirAll(filepath.Join(root, "u1"), 0755)
os.MkdirAll(filepath.Join(root, "u2"), 0755)
os.WriteFile(filepath.Join(root, "u2", "secret.txt"), []byte("other-secret"), 0644)
os.Symlink(filepath.Join(root, "u2", "secret.txt"), filepath.Join(root, "u1", "link-out"))
// restricted is a File Browser user scoped to /u1 with Download permission.
rr := authenticatedRequest(t, restricted, http.MethodGet, "/api/raw/link-out", nil)
if rr.Code != http.StatusOK || !strings.Contains(rr.Body.String(), "other-secret") {
t.Fatalf("raw symlink exposed outside target: status=%d body=%q", rr.Code, rr.Body.String())
}
Variant 2, file reached through a symlinked ancestor
Authenticated scoped user whose scope contains a directory symlink escape_link -> /srv/users/otheruser:
# The symlink itself is correctly blocked
GET /api/resources/escape_link -> 403 Forbidden
# A regular file THROUGH the symlinked directory is not
GET /api/resources/escape_link/private.txt -> 200 OK {"content":"OTHER_USER_SECRET_DATA=...",...}
GET /api/raw/escape_link/private.txt -> 200 OK OTHER_USER_SECRET_DATA=...
# Create/overwrite THROUGH the symlinked directory (TUS)
POST /api/tus/escape_link/injected.txt (Upload-Length: 20) -> 201 Created
PATCH /api/tus/escape_link/injected.txt (Upload-Offset: 0) -> 204 No Content (written into /srv/users/otheruser/)
Public directory share for /shared, where /shared/link -> ../private and private/secret.txt lives outside the share:
GET /api/public/dl/<hash>/link/secret.txt -> 200 OK symlink-secret
GET /api/public/share/<hash>/link/secret.txt -> 200 OK {"path":"/link/secret.txt", ...}
Requesting the whole share as an archive pulls link/secret.txt into the zip, and listing the share root exposes the link entry with its resolved target metadata.
Controls that held
The same harness confirmed that ordinary traversal is still rejected, so this is not generic ../ traversal:
GET /api/resources/../u2/secret.txt?checksum=sha256did not succeed as the restricted user.GET /api/resources/%2e%2e/u2/secret.txtdid not succeed (encoded dot-dot).POST /api/resources/../u2/new.txtdid not create/u2/new.txt.PATCH /api/resources/own.txt?action=rename&destination=/../u2/moved.txtdid not move a file outside scope.
Affected code
users/users.go (scope setup); files/file.go (stat, readListing); http/raw.go (getFiles); http/resource.go (writeFile destination); http/tus_handlers.go (tusPostHandler, tusPatchHandler); http/share.go; http/public.go; http/http.go:90-91 (public routes); http/data.go (string-only path checks).
Limitations and non-claims
- This is not generic
../path traversal; dot-dot and encoded dot-dot controls held in the route-level tests. - This is not a proxy-auth confusion issue; the proofs use normal authenticated requests for a restricted user (and, for Variant 2's share case, an ordinary public-share recipient).
- The proofs assume the relevant symlink already exists inside the scoped tree, or that another allowed workflow in the deployment can place it there, for example an SMB/NFS export, a Docker bind-mount, or an admin-created link. Web-UI-only creation of the symlink from scratch was not demonstrated.
Impact
In a multi-user deployment, if a symlink (a file symlink for Variant 1, or a directory symlink for Variant 2) exists inside a restricted user's scoped tree and resolves to a location outside that scope but reachable by the server process, the boundary can be crossed. Concretely, a user holding only normal File Browser permissions can:
- Read out-of-scope file contents and metadata via
GET /api/raw/{path}andGET /api/resources/{path}. - Overwrite an out-of-scope target via
POST /api/resources/{path}?override=true. - Overwrite or create an out-of-scope target via the TUS resumable upload path:
POST /api/tus/{path}?override=truefollowed byPATCH /api/tus/{path}. - Create a public share for an out-of-scope target via
POST /api/share/{path}, exposing it throughGET /api/public/dl/{hash}.
For Variant 2, the same exposure reaches public-share recipients: a normal public directory share whose subtree contains a linked descendant lets an unauthenticated recipient read regular files behind the link, pull them into the share's archive download, and see the resolved target in directory listings.
This breaks the confidentiality and integrity guarantees that per-user scopes and password/anonymous shares are relied upon to provide, for any data the server process can reach.
Input manipulates file paths to reach files outside the intended directory, such as configuration or credential files. Typical impact: unauthorized file read or write outside the intended directory.
CVE-2026-54094 has a CVSS score of 6.8 (Medium). The vector is network-reachable, low privileges required, and no user interaction. A CVSS score reflects the worst-case severity of the vulnerability, not your specific exposure. Whether this affects your application depends on whether the vulnerable code is present and reachable in your environment. A fixed version is available (2.63.14); upgrading removes the vulnerable code path.
Affected versions
Security releases
Kodem intelligence
Severity tells you how bad this could be in the worst case. It does not tell you whether you are exposed. Exploitability and impact are functions of runtime truth: whether the vulnerable code is present, reachable, and actually executes in your application. A vulnerable package can sit in your dependency tree and never run.
Kodem, an Intelligent Application Security platform, uses runtime intelligence to reveal which vulnerabilities actually execute in production, so teams prioritize the ones that genuinely matter. Kodem's runtime-powered SCA identifies whether this CVE is reachable in your applications.
Remediation advice
Resolve symlinks and verify that the resolved target remains inside the user's real scoped root before any file operation, serving, sharing, writing, truncating, renaming, copying, or deleting. Specifically:
- Call
WithinScope(which resolves every path component withfilepath.EvalSymlinks) for all paths instat(), not only when the final element is a symlink. This closes the ancestor-symlink gap (Variant 2). - Add a
WithinScopecheck beforeMkdirAll/OpenFileintusPostHandlerandtusPatchHandler, so a not-yet-existing leaf cannot skip containment. - Omit entries whose resolved target escapes the scope from
readListing, and skip them ingetFilesbefore stat/open/recursion. - Apply the same resolved-path check consistently to public share creation and public share serving.
- As an alternative or defense-in-depth, reject symlinks for file operations unless an explicit administrator option enables them.
Add regression tests covering symlink reads, overwrites, TUS create/write, public shares (download, share-info, listing, and archive read paths), and the existing dot-dot controls, plus a positive test confirming that legitimately in-scope symlinks still resolve.
Frequently Asked Questions
- What is CVE-2026-54094? CVE-2026-54094 is a medium-severity path traversal vulnerability in github.com/filebrowser/filebrowser/v2 (go), affecting versions <= 2.63.13. It is fixed in 2.63.14. Input manipulates file paths to reach files outside the intended directory, such as configuration or credential files.
- How severe is CVE-2026-54094? CVE-2026-54094 has a CVSS score of 6.8 (Medium). This score reflects the worst-case severity of the vulnerability, not your specific exposure. Whether it represents real risk in your environment depends on whether the vulnerable code is present and reachable.
- Which packages are affected by CVE-2026-54094?
github.com/filebrowser/filebrowser/v2(go) (versions <= 2.63.13)github.com/filebrowser/filebrowser(go) (versions <= 1.11.0)
- Is there a fix for CVE-2026-54094? Yes. CVE-2026-54094 is fixed in 2.63.14. Upgrade to this version or later.
- Is CVE-2026-54094 exploitable, and should I be worried? Whether CVE-2026-54094 is exploitable in your environment depends on whether the vulnerable code is present and reachable. A CVSS score is a worst-case rating; it does not account for your specific deployment, configuration, or usage patterns. Kodem, an Intelligent Application Security platform, uses runtime intelligence to show which vulnerabilities actually execute in production, so you can focus on the ones that represent real risk. Get a demo
- What actually determines whether CVE-2026-54094 is exploitable, and how bad it is? Exploitability and impact are not fixed properties of a CVE. They depend on runtime truth: whether the vulnerable code is present, reachable, and actually executes in your application. A high CVSS score on a dependency that never runs is not the same as real risk. Kodem, an Intelligent Application Security platform, uses runtime intelligence to reveal which vulnerabilities actually execute in production, so teams prioritize the ones that genuinely matter.
- How do I fix CVE-2026-54094? Upgrade
github.com/filebrowser/filebrowser/v2to 2.63.14 or later.