docs: document custom proxy headers

Split from #76 (https://github.com/fosrl/docs-v2/pull/76).
This commit is contained in:
Laurence
2026-03-23 10:32:12 +00:00
parent 8d7d06af77
commit 4d116f486f

View File

@@ -22,6 +22,37 @@ Targets function as destination endpoints for your resources:
3. **Network Access**: Newt proxy routes traffic to the local network through the tunnel 3. **Network Access**: Newt proxy routes traffic to the local network through the tunnel
4. **Direct Connection**: No additional routing is necessary on the remote network 4. **Direct Connection**: No additional routing is necessary on the remote network
## Proxy Header Settings
In the public resource **Proxy** tab, Pangolin also lets you control the headers sent to the upstream target.
### Custom Host Header
Use **Custom Host Header** when the upstream application expects a specific `Host` value instead of the public resource hostname.
This is commonly needed for virtual-hosted backends that route traffic based on `Host`.
### Custom Headers
Use **Custom Headers** to add static headers to every proxied request for the resource.
- Enter one header per line.
- Use the format `Header-Name: value`.
- Save the change with **Save Proxy Settings**.
Example:
```text
X-Example-Header: example-value
X-Environment: production
```
Typical uses include upstream shared-secret headers, feature flags, or tenant-routing headers that your application expects on every request.
<Note>
Custom headers are static resource-level headers. If you need Pangolin to pass user identity to the upstream app, use [Forwarded Headers](/manage/access-control/forwarded-headers) instead.
</Note>
## Multi-Site Targets ## Multi-Site Targets
Targets have sites associated with them. This provides significant benefits for reliability and load distribution described below. Targets have sites associated with them. This provides significant benefits for reliability and load distribution described below.