nginx-proxy-manager/docs
Tom Winnerl 6d02ea2168 fix(review): keep stored forward hosts that combine text and a variable
A location saved before v2.17 with forward host `app-$stage` (and
`set $stage prod;` in its advanced config) answered 503 after the startup
regeneration: preflightLocation() only allowed a host that is exactly one
`$name` and quarantined every other host with a `$`. The renderer before
custom location modes, and develop, write any stored value that can't add
directives literally (`proxy_pass http://app-$stage:80;`), which works.

isVariableHost() now accepts a forward host with an nginx variable that has
none of the characters that would break out of the directive, the same
structural rule as lib/nginx-values.js applies to stored rows: such a host
is rendered literally (static, no DNS check, no rewrite) as `$backend` is,
also with NPM_LOCATION_DYNAMIC_DNS=false. Braces (`app-${stage}`), spaces
and `;` are still quarantined. The API refuses `$` in a forward host since
v2.17, so this only concerns rows saved before. The frontend's
isVariableHost() follows the same rule (no upstream check for such hosts).

Tests: unit tests for the preflight, mode and rendering; nginx semantics
harness cases /varmix/, /varmixfp/ and /vmrx/ (`ec$semhost`) compared with
the legacy rendering (they answered 503 before, DIFFS=0 now).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-14 09:03:56 +01:00
..
.vitepress docs: custom location modes and statuses 2026-11-14 09:03:56 +01:00
scripts Docs update, use package version instead of latest, refer to better mariadb image 2026-02-19 08:36:41 +10:00
src fix(review): keep stored forward hosts that combine text and a variable 2026-11-14 09:03:56 +01:00
.gitignore Migrate from vuepress to vitepress for docs site 2024-05-10 23:00:27 +10:00
package.json Docs update, use package version instead of latest, refer to better mariadb image 2026-02-19 08:36:41 +10:00
yarn.lock Update dependencies 2026-11-09 11:55:20 +10:00