Config.yaml

# p2proxy configuration. Copy / edit / mount this file into the daemon.
# See README.md for the full reference; the values below are a working
# minimal example that exposes a single SOCKS5 endpoint on :1080 routed
# through any peer with >= 50 Mbps available bandwidth.

# UDP port the libp2p stack listens on. Does NOT need to be port-forwarded
# for the proxy to work, but forwarding it improves peer connectivity and
# reduces relay reliance. Defaults to 0 (any port)
# port: 45445

# Logging verbosity: trace | debug | info | warn | error
log_level: info

# Optional top-level overrides (all have sensible defaults):
# keypair_path: node_keypair.bin       # where the node identity is persisted

# One or more proxy endpoints. Each entry opens a local listener and
# routes traffic through peers matching the filter.
servers:
  - protocol: Socks5
    port: 1080
    # Minimum advertised bandwidth a peer must have to be selected.
    # Lower values = more peer options but potentially slower throughput.
    min_bandwidth: 50Mbps

    # Optional: pin to a country (ISO-3166 alpha-2). Omit for any country.
    country: NL
  - protocol: Socks5
    port: 1081
    # Minimum advertised bandwidth a peer must have to be selected.
    # Lower values = more peer options but potentially slower throughput.
    min_bandwidth: 20Mbps

    # Optional: pin to a country (ISO-3166 alpha-2). Omit for any country.
    country: AU

    # Optional: ordered pinned-peer preference list for stable egress IPs.
    # Entries are bare peer ids (preferred — the current route is resolved
    # through the hub on every connect, so the peer stays reachable even
    # when it moves hubs) or full multiaddrs ending in /p2p/<peer-id>.
    # The FIRST entry is always tried first; later entries are failovers.
    #
    # destination_peers:
    #   - 12D3KooWPrimaryPeerId...
    #   - 12D3KooWBackupPeerId...

    # When every pinned peer is offline: false (default) keeps retrying the
    # list and surfaces an error — the egress IP never silently changes;
    # true falls back to country/min_bandwidth discovery.
    #
    # fallback_to_discovery: false

    # Remember the discovered exit peer in sticky_peers.json and reconnect
    # to it across restarts for a stable egress IP (default: true). Only
    # applies to servers without destination_peers. Set false to get a
    # fresh exit on every restart.
    #
    # sticky: true

    # Optional: per-server stream tuning. (Not a connection pool — streams
    # are not kept warm.) Both fields have defaults; uncomment to override.
    #
    # pool:
    #   max_total: 30          # max concurrent stream opens per peer; also
    #                          # bounds the remembered sticky exit pool
    #   open_timeout_secs: 20  # give up opening a stream after this long