Skip to content

LB: document proxy_protocol_from and external_sources #306

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
gmelikov merged 2 commits into from
Apr 24, 2026
Merged

LB: document proxy_protocol_from and external_sources #306

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4ab6a2c
LB: document proxy_protocol_from and external_sources
gmelikov Apr 24, 2026
a5c676c
Update docs/network/load_balancer.md
gmelikov Apr 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 17 additions & 2 deletions docs/network/load_balancer.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -123,6 +123,21 @@ Routing rules that define how traffic is handled:
"protocol": "http",
"port": 80,
"domains": ["example.com", "www.example.com"],
}
```

#### External sources

You may use external sources to forward traffic from LB to remote systems (use proxy_protocol_from to enable the PROXY protocol and pass the real client IP to the backend; Nginx will be started on the remote system):

```json
{
"name": "web-vhost",
"description": "Web server vhost",
"protocol": "http",
"port": 80,
"domains": ["example.com", "www.example.com"],
"proxy_protocol_from": "127.0.0.1/32",
"external_sources": [
{
"kind": "ssh_forward",
Expand All @@ -135,9 +150,9 @@ Routing rules that define how traffic is handled:
}
```

#### External sources requirements
##### Requirements

##### SSH
###### SSH

Tested on Ubuntu 24, prepare remote system:

Expand Down
Loading