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
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
Targets have sites associated with them. This provides significant benefits for reliability and load distribution described below.