Merge pull request #83 from LaurenceJJones/docs/custom-headers-proxy-settings

enhance(public): document custom proxy headers
This commit is contained in:
Owen Schwartz
2026-03-27 14:37:46 -07:00
committed by GitHub
+31
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
## 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 ## 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.