Questions about attributes

[Ferrox12]

Hi,
is there a page that explains every options available when I create a new record? For example Cache assets, Websockets support...

[tigran-sargsyan-w]

I don't know of a single page that documents every checkbox down to the exact generated Nginx directives, but the NPM templates make the important ones fairly clear.

For example:

Websockets Support

This adds:

proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $http_connection;
proxy_http_version 1.1;

So enable it when the upstream application uses WebSocket connections.

Cache Assets

This enables NPM's asset-cache configuration for file extensions such as:

css
js
jpg/jpeg
gif
png
webp
woff/woff2
ttf
svg
ico
...

Those assets go through Nginx's proxy_cache.

One thing worth knowing is that this cache configuration is quite aggressive: it ignores some upstream cache-related headers, including Cache-Control, Expires and Set-Cookie, and caches assets for around 30 minutes.

So I wouldn't blindly enable "Cache Assets" for every application, especially if it serves user-specific/dynamic content using file-looking URLs.

Block Common Exploits

This includes NPM's block-exploits.conf, which contains several query-string/user-agent filters for common SQL/file/script injection patterns and some known bad user agents.

A useful way to learn exactly what NPM generated for a particular Proxy Host is to inspect the generated Nginx configuration inside the container after toggling an option.

That makes it very easy to compare:

option OFF

vs.

option ON

and see exactly which directives/includes NPM added.