mirror of
https://github.com/fosrl/docs-v2.git
synced 2026-04-16 06:46:42 +00:00
Merge pull request #83 from LaurenceJJones/docs/custom-headers-proxy-settings
enhance(public): document custom proxy headers
This commit is contained in:
@@ -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
|
||||
|
||||
## Additional Proxy Settings
|
||||
|
||||
In the public resource **Proxy** tab, Pangolin also provides additional proxy settings for how requests are 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.
|
||||
|
||||
Reference in New Issue
Block a user