81db46b725
refactor(handler/tunnel): code review fixes and entrypoint subpackage extraction
...
- Fix dead-code branch in bind.go host assignment (always use endpoint hash)
- Return descriptive error on bypass match in connect.go (was masking as success)
- Update bypass test in connect_test.go for new error behavior
- Extract entrypoint subpackage from monolithic entrypoint.go (6 files)
- Fix observeStats event-loss bug (break -> fallthrough on retry success)
- Add 47 unit tests across handler, connect, bind, metadata packages
- Add architecture doc comments to all key files
- Build and vet clean, 173 tests pass with -race
2026-06-02 23:51:55 +08:00
31878a72ec
docs(handler/tunnel): add architecture documentation and fix observeStats event loss
...
- 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)
2026-06-02 18:36:52 +08:00
e791ba47e2
refactor(handler/tunnel): split 794-line entrypoint.go into 6 files, fix 3 bugs, add 48 tests
...
Breaking Change: moves Connector, ConnectorPool, parseTunnelID from
tunnel.go into dedicated connector.go and id.go.
Bug Fixes:
- dialer.go: clear stale retry err so SD fallback is not masked (nil err
from pool.Get() left previous iteration's error live)
- connect.go: check WriteTo errors in both mux and non-mux paths
- eprelay.go: use fresh relay.Response for features sent over mux
(previously reused same resp struct after resp.WriteTo(muxConn))
Refactor:
- entrypoint.go: split ~790 lines into 6 files (ephttp, eptls, eprelay,
epwebsocket, eplistener, entrypointsvc), moved to dedicated package
- handler.go: moved initEntrypoints/createEntrypointService to
entrypointsvc.go
- tunnel.go: moved Connector/ConnectorPool/parseTunnelID to
connector.go and id.go
- connect.go: moved entrypoint-originated handleConnect to eprelay.go
(handler-side handleConnect kept in connect.go)
Tests (48 new, 88 total):
- id_test.go: parseTunnelID variants (empty, UUID, private '$', invalid)
- tunnel_test.go: Tunnel lifecycle (AddConnector, GetConnector
weighted/closed filtering, CloseOnIdle, clean),
Connector (NewConnector nil-opts, GetConn nil/closed session, Close,
IsClosed), ConnectorPool (Add/Get/Close, idle cleanup, concurrency)
- dialer_test.go: SD error paths (sd.Get error, empty address)
- handler_test.go: observeStats (nil observer, cancelled context loop),
initEntrypoints (no entrypoints configured)
- helpers_test.go: testLogger, fakeConn for handler tests
- eprelay_test.go: handleConnect ingress/dial/SD round-trip
2026-06-01 22:20:43 +08:00
174bc082d1
fix(tunnel): data race in CloseOnIdle and goroutine leak in sniffingWebsocketFrame
...
- Use write lock (Lock) instead of read lock (RLock) in CloseOnIdle since
it modifies the close channel, preventing a race with Close() that could
panic on double-close of channel.
- Buffer sniffingWebsocketFrame errc to capacity 2 and close both
connections on first error to ensure the remaining copy goroutine
unblocks and exits cleanly.
2026-05-22 16:31:37 +08:00
06d993023f
add traffic reset for stats
2024-12-24 20:11:22 +08:00
6f001a779a
tunnel: fix tunnel routing for public entrypoint
2024-11-22 22:04:44 +08:00
f4d9a5f79b
tunnel: checking closed connector
2024-11-01 15:25:45 +08:00
31c482c649
add scope param for traffic limiter
2024-08-31 09:30:04 +08:00
ff20711c25
add stats support for tunnel handler
2024-08-28 13:34:05 +08:00
1a776dc759
fix connection state in tunnel entrypoint
2024-08-01 20:52:08 +08:00
5ee7746aab
fix tunnel connector selection
2024-01-28 18:56:19 +08:00
b5b39de62c
add weight for tunnel connector
2024-01-27 23:31:23 +08:00
d464be5fd0
update sd
2023-11-02 22:31:52 +08:00
68edeb2d59
update sd
2023-11-02 20:52:33 +08:00
a7166b8206
add sd for tunnel
2023-10-31 22:59:14 +08:00
0bef7c0cdf
improve tunnel handler
2023-10-27 22:11:11 +08:00
5dfbb59f8a
update forward handler
2023-10-16 23:16:47 +08:00
497915f465
add tunnel handler and connector
2023-10-15 15:39:25 +08:00
ginuerzh