mirror of
https://github.com/go-gost/x.git
synced 2026-10-19 16:16:32 +00:00
ginuerzh
4bbf81c9f4
The tun link needs the tunnel network "ip" rather than the "udp" its dialer
would otherwise derive: "ip" is the datagram link, marked session-scoped on
the host so it ends on a lost peer session and the consumer re-dials (see
the p2p companion change). Add WithTunnelNetwork to override the derived
network and MDKeyP2PNetwork ("p2p.network") for a chain node to set it, and
have streamconn frame "ip" like "udp" so the GOST-side conn owns the 2-byte
framing on both carriers. An empty network keeps the derived value, so every
existing node is unchanged.
Gate: go build ./... and go vet ./... clean.
110 lines
4.1 KiB
Go
110 lines
4.1 KiB
Go
// Package parsing converts user-facing configuration structs into registered
|
|
// runtime components. Each sub-package (service, hop, chain, auth, …) owns the
|
|
// parsing logic for its corresponding core interface.
|
|
//
|
|
// Metadata keys defined below bridge the gap between named config fields and
|
|
// generic key-value metadata. When a value is not represented by an explicit
|
|
// field on a config struct it flows through the metadata system instead and
|
|
// these keys are used to look it up at component Init time.
|
|
package parsing
|
|
|
|
const (
|
|
// MDKeyProxyProtocol sets the HAProxy proxy-protocol version on a listener.
|
|
MDKeyProxyProtocol = "proxyProtocol"
|
|
|
|
// MDKeyInterface binds the outbound connection to a specific network interface.
|
|
MDKeyInterface = "interface"
|
|
|
|
// MDKeySoMark sets the SO_MARK socket option on outbound connections.
|
|
MDKeySoMark = "so_mark"
|
|
|
|
// MDKeyHash selects the hash source used by hash-based selectors.
|
|
MDKeyHash = "hash"
|
|
|
|
// MDKeyPreUp is a shell command executed when a service starts listening.
|
|
MDKeyPreUp = "preUp"
|
|
|
|
// MDKeyPreDown is a shell command executed immediately before a service
|
|
// stops listening.
|
|
MDKeyPreDown = "preDown"
|
|
|
|
// MDKeyPostUp is a shell command executed after a service has successfully
|
|
// started listening.
|
|
MDKeyPostUp = "postUp"
|
|
|
|
// MDKeyPostDown is a shell command executed after a service has stopped
|
|
// listening.
|
|
MDKeyPostDown = "postDown"
|
|
|
|
// MDKeyIgnoreChain disables chain routing for a service. When set the
|
|
// listener/handler will not prepend a chain, which is useful for services
|
|
// that handle routing themselves (e.g. DNS, TUN).
|
|
MDKeyIgnoreChain = "ignoreChain"
|
|
|
|
// MDKeyEnableStats enables per-service connection statistics collection.
|
|
MDKeyEnableStats = "enableStats"
|
|
|
|
// MDKeyRecorderDirection toggles whether traffic direction (client→server or
|
|
// server→client) is recorded alongside the payload.
|
|
MDKeyRecorderDirection = "direction"
|
|
|
|
// MDKeyRecorderTimestampFormat sets the timestamp layout used in recorder
|
|
// output (Go time.Format layout).
|
|
MDKeyRecorderTimestampFormat = "timeStampFormat"
|
|
|
|
// MDKeyRecorderHexdump enables hexadecimal dump output in recorders.
|
|
MDKeyRecorderHexdump = "hexdump"
|
|
|
|
// MDKeyRecorderHTTPBody enables capturing the HTTP request/response body in
|
|
// HTTP-based recorders.
|
|
MDKeyRecorderHTTPBody = "http.body"
|
|
|
|
// MDKeyRecorderHTTPMaxBodySize limits the maximum body size (in bytes) that
|
|
// an HTTP recorder will capture.
|
|
MDKeyRecorderHTTPMaxBodySize = "http.maxBodySize"
|
|
|
|
// MDKeyLimiterRefreshInterval sets how often a limiter reloads its
|
|
// configuration from an external source.
|
|
MDKeyLimiterRefreshInterval = "limiter.refreshInterval"
|
|
|
|
// MDKeyLimiterCleanupInterval sets how often a limiter purges expired
|
|
// entries from its internal state.
|
|
MDKeyLimiterCleanupInterval = "limiter.cleanupInterval"
|
|
|
|
// MDKeyLimiterScope controls whether a cached traffic limiter's scope is
|
|
// per-service ("service") or per-client ("client").
|
|
MDKeyLimiterScope = "limiter.scope"
|
|
|
|
// MDKeyObserverResetTraffic requests a traffic counter reset each time the
|
|
// observer reports.
|
|
MDKeyObserverResetTraffic = "observer.resetTraffic"
|
|
|
|
// MDKeyObserverPeriod sets the interval between observer reports.
|
|
MDKeyObserverPeriod = "observer.period"
|
|
|
|
// MDKeyNetns is the network namespace name or path used for the listener
|
|
// side (inbound).
|
|
MDKeyNetns = "netns"
|
|
|
|
// MDKeyNetnsOut is the network namespace name or path used for the handler
|
|
// (outbound) side.
|
|
MDKeyNetnsOut = "netns.out"
|
|
|
|
// MDKeyDialTimeout sets the dial timeout for outbound connections.
|
|
MDKeyDialTimeout = "dialTimeout"
|
|
|
|
// MDKeyLabels holds static key/value labels attached to a service's
|
|
// records and logs.
|
|
MDKeyLabels = "labels"
|
|
|
|
// MDKeyP2P selects the p2p tunnel provider for a chain node's base
|
|
// transport. The value is the name of a registered p2ps: component.
|
|
MDKeyP2P = "p2p"
|
|
|
|
// MDKeyP2PNetwork overrides the tunnel network a p2p-wrapped node asks the
|
|
// provider for (see xp2p.WithTunnelNetwork). Empty derives it from the inner
|
|
// dialer. A tun link sets it to "ip": datagram-shaped like udp, but
|
|
// session-scoped on the host, so the link ends on a lost peer session.
|
|
MDKeyP2PNetwork = "p2p.network"
|
|
)
|