ginuerzh
31878a72ec
- Add package-level architecture doc in handler.go covering: - NAT traversal reverse proxy architecture - CmdBind/CmdConnect roles and data flow - Connector lifecycle and waitClose semantics - Entrypoint protocol dispatch (first-byte sniffing) - SD fallback behavior - Add data-flow-oriented doc comments to all business files: - entrypoint.go: protocol dispatch, dial flow - connector.go: Connector/ConnectorPool semantics - dialer.go: two-phase dial strategy - tunnel.go: MaxWeight semantics, selection algorithm - bind.go: 6-step CmdBind flow - connect.go: CmdConnect flow with relay framing - ephttp.go, eptls.go, eprelay.go: per-protocol entrypoint flow - Fix observeStats: after successful error retry, also flush new events instead of skipping the current tick (handler.go:261-271) - Add test for observeStats retry-then-flush (handler_test.go)
30 lines
805 B
Go
30 lines
805 B
Go
// Package tunnel implements the GOST relay tunnel handler for NAT traversal,
|
|
// connecting public entrypoints to internal services behind NAT/firewall.
|
|
//
|
|
// See handler.go for a full architecture overview.
|
|
package tunnel
|
|
|
|
import (
|
|
"github.com/go-gost/relay"
|
|
"github.com/google/uuid"
|
|
)
|
|
|
|
// parseTunnelID parses a tunnel ID from a string.
|
|
// If s is empty or contains an invalid UUID, the returned tunnel ID is zero
|
|
// (callers must check IsZero). A leading '$' prefix marks the tunnel as private.
|
|
func parseTunnelID(s string) (tid relay.TunnelID) {
|
|
if s == "" {
|
|
return
|
|
}
|
|
private := false
|
|
if s[0] == '$' {
|
|
private = true
|
|
s = s[1:]
|
|
}
|
|
u, _ := uuid.Parse(s) // zero ID on error — caller checks IsZero
|
|
|
|
if private {
|
|
return relay.NewPrivateTunnelID(u[:])
|
|
}
|
|
return relay.NewTunnelID(u[:])
|
|
} |