Skip to main content

Public Bind Address

The server has two kinds of listeners:

PurposeConfigWho connects
Control channellisten (and quicPort / kcpPort)The client (orbien) connects to build tunnels
Public trafficproxyAddr + remotePort / httpGwPort / httpsGwPortPublic visitors access the services you exposed

proxyAddr chooses which NIC / address visitor traffic binds to. It is independent of where the client connects. The config key remains proxyAddr (historical name); it means the public bind address”.

Typical case: on a multi-homed host, bind the control channel to the private network and public listeners to the public IP — or the reverse, to isolate management from traffic.

Default is 0.0.0.0 (all interfaces). If empty, it falls back to the host part of listen.

Example​

Control channel and public listeners on all interfaces (default):

# orbien-server.toml
listen = "0.0.0.0:9527"
proxyAddr = "0.0.0.0"

Serve public traffic only on the public NIC (example IP):

# orbien-server.toml
listen = "10.0.0.2:9527"
proxyAddr = "203.0.113.10"

The client then connects to 10.0.0.2:9527; visitors reach remotePort / httpGwPort / httpsGwPort on 203.0.113.10.

Parameters​

ParameterRequiredDefaultDescription
proxyAddrNo0.0.0.0Public bind address; empty falls back to the host part of listen