Add TCP prefix route option
Some checks are pending
Build / Calculate version (push) Waiting to run
Build / Build binary (push) Blocked by required conditions
Build / Build binary-1 (push) Blocked by required conditions
Build / Build binary-2 (push) Blocked by required conditions
Build / Build binary-3 (push) Blocked by required conditions
Build / Build binary-4 (push) Blocked by required conditions
Build / Build binary-5 (push) Blocked by required conditions
Build / Build binary-6 (push) Blocked by required conditions
Build / Build binary-7 (push) Blocked by required conditions
Build / Build binary-8 (push) Blocked by required conditions
Build / Build binary-9 (push) Blocked by required conditions
Build / Build binary-10 (push) Blocked by required conditions
Build / Build binary-11 (push) Blocked by required conditions
Build / Build binary-12 (push) Blocked by required conditions
Build / Build binary-13 (push) Blocked by required conditions
Build / Build binary-14 (push) Blocked by required conditions
Build / Build binary-15 (push) Blocked by required conditions
Build / Build binary-16 (push) Blocked by required conditions
Build / Build binary-17 (push) Blocked by required conditions
Build / Build binary-18 (push) Blocked by required conditions
Build / Build binary-19 (push) Blocked by required conditions
Build / Build binary-20 (push) Blocked by required conditions
Build / Build binary-21 (push) Blocked by required conditions
Build / Build binary-22 (push) Blocked by required conditions
Build / Build binary-23 (push) Blocked by required conditions
Build / Build binary-24 (push) Blocked by required conditions
Build / Build binary-25 (push) Blocked by required conditions
Build / Build binary-26 (push) Blocked by required conditions
Build / Build binary-27 (push) Blocked by required conditions
Build / Build binary-28 (push) Blocked by required conditions
Build / Build binary-29 (push) Blocked by required conditions
Build / Build binary-30 (push) Blocked by required conditions
Build / Build binary-31 (push) Blocked by required conditions
Build / Build binary-32 (push) Blocked by required conditions
Build / Build binary-33 (push) Blocked by required conditions
Build / Build binary-34 (push) Blocked by required conditions
Build / Build binary-35 (push) Blocked by required conditions
Build / Build binary-36 (push) Blocked by required conditions
Build / Build binary-37 (push) Blocked by required conditions
Build / Build Darwin binaries (push) Blocked by required conditions
Build / Build Darwin binaries-1 (push) Blocked by required conditions
Build / Build Darwin binaries-2 (push) Blocked by required conditions
Build / Build Windows binaries (push) Blocked by required conditions
Build / Build Windows binaries-1 (push) Blocked by required conditions
Build / Build Windows binaries-2 (push) Blocked by required conditions
Build / Build Android library (386) (push) Blocked by required conditions
Build / Build Android library (amd64) (push) Blocked by required conditions
Build / Build Android library (arm) (push) Blocked by required conditions
Build / Build Android library (arm64) (push) Blocked by required conditions
Build / Build Android (other) (push) Blocked by required conditions
Build / Build Android (other-legacy) (push) Blocked by required conditions
Build / Publish Android (push) Blocked by required conditions
Build / Build Windows client (arm64) (push) Blocked by required conditions
Build / Build Windows client (x64) (push) Blocked by required conditions
Build / Build Windows client (x86) (push) Blocked by required conditions
Build / Build Linux client (arm64) (push) Blocked by required conditions
Build / Build Linux client (armv7l) (push) Blocked by required conditions
Build / Build Linux client (x64) (push) Blocked by required conditions
Build / Build Apple library (ios-arm64) (push) Blocked by required conditions
Build / Build Apple library (macos-amd64) (push) Blocked by required conditions
Build / Build Apple library (macos-arm64) (push) Blocked by required conditions
Build / Build Apple library (tvos-arm64) (push) Blocked by required conditions
Build / Build Apple release clients (push) Blocked by required conditions
Build / Build Apple release clients-1 (push) Blocked by required conditions
Build / Build Apple App Store clients (push) Blocked by required conditions
Build / Build Apple App Store clients-1 (push) Blocked by required conditions
Build / Build Apple App Store clients-2 (push) Blocked by required conditions
Build / Upload builds (push) Blocked by required conditions
Build / Cache GC (push) Blocked by required conditions

This commit is contained in:
世界 2026-11-16 23:07:02 +08:00
parent 5cf1538748
commit ffe566e589
No known key found for this signature in database
GPG key ID: CD109927C34A63C4
9 changed files with 124 additions and 3 deletions

View file

@ -77,6 +77,7 @@ type InboundContext struct {
LastInbound string
OriginDestination M.Socksaddr
RouteOriginalDestination M.Socksaddr
TCPPrefix []byte
UDPDisableDomainUnmapping bool
UDPConnect bool
UDPTimeout time.Duration

View file

@ -2,6 +2,10 @@
icon: material/new-box
---
!!! quote "Changes in sing-box 1.15.0"
:material-plus: [tcp_prefix](#tcp_prefix)
!!! quote "Changes in sing-box 1.13.0"
:material-plus: [bypass](#bypass)
@ -146,6 +150,7 @@ Not available when `method` is set to drop.
"override_port": 0,
"network_strategy": "",
"fallback_delay": "",
"tcp_prefix": "",
"udp_disable_domain_unmapping": false,
"udp_connect": false,
"udp_timeout": "",
@ -186,6 +191,14 @@ See [Dial Fields](/configuration/shared/dial/#fallback_network_type) for details
See [Dial Fields](/configuration/shared/dial/#fallback_delay) for details.
#### tcp_prefix
!!! question "Since sing-box 1.15.0"
Prepend data to each TCP connection.
Specify a Base64 string or a byte array.
#### udp_disable_domain_unmapping
If enabled, for UDP proxy requests addressed to a domain,

View file

@ -2,6 +2,10 @@
icon: material/new-box
---
!!! quote "sing-box 1.15.0 中的更改"
:material-plus: [tcp_prefix](#tcp_prefix)
!!! quote "sing-box 1.13.0 中的更改"
:material-plus: [bypass](#bypass)
@ -139,6 +143,7 @@ icon: material/new-box
"override_port": 0,
"network_strategy": "",
"fallback_delay": "",
"tcp_prefix": "",
"udp_disable_domain_unmapping": false,
"udp_connect": false,
"udp_timeout": "",
@ -183,6 +188,14 @@ icon: material/new-box
详情参阅 [拨号字段](/zh/configuration/shared/dial/#fallback_delay)。
#### tcp_prefix
!!! question "自 sing-box 1.15.0 起"
在每个 TCP 连接的开头添加数据。
使用 Base64 字符串或字节数组。
#### udp_disable_domain_unmapping
如果启用,对于地址为域的 UDP 代理请求,将在响应中发送原始包地址而不是映射的域。

View file

@ -15830,6 +15830,21 @@
"minimum": 0,
"maximum": 4294967295
},
"tcp_prefix": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 255
}
}
]
},
"udp_disable_domain_unmapping": {
"type": "boolean"
},
@ -15890,6 +15905,21 @@
"minimum": 0,
"maximum": 4294967295
},
"tcp_prefix": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 255
}
}
]
},
"udp_disable_domain_unmapping": {
"type": "boolean"
},
@ -15957,6 +15987,21 @@
"minimum": 0,
"maximum": 4294967295
},
"tcp_prefix": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 255
}
}
]
},
"udp_disable_domain_unmapping": {
"type": "boolean"
},

View file

@ -262,7 +262,7 @@ func unmarshalDefaultRuleContext(ctx context.Context, data []byte, rule *Default
if err != nil {
return err
}
if depth > 0 && rawAction == "" && routeOptions == (RouteActionOptions{}) {
if depth > 0 && rawAction == "" && reflect.DeepEqual(routeOptions, RouteActionOptions{}) {
rule.RuleAction = RuleAction{}
}
return nil
@ -286,7 +286,7 @@ func unmarshalLogicalRuleContext(ctx context.Context, data []byte, rule *Logical
if err != nil {
return err
}
if depth > 0 && rawAction == "" && routeOptions == (RouteActionOptions{}) {
if depth > 0 && rawAction == "" && reflect.DeepEqual(routeOptions, RouteActionOptions{}) {
rule.RuleAction = RuleAction{}
}
return nil

View file

@ -169,6 +169,7 @@ type RawRouteOptionsActionOptions struct {
NetworkStrategy *NetworkStrategy `json:"network_strategy,omitempty"`
FallbackDelay uint32 `json:"fallback_delay,omitempty"`
TCPPrefix []byte `json:"tcp_prefix,omitempty"`
UDPDisableDomainUnmapping bool `json:"udp_disable_domain_unmapping,omitempty"`
UDPConnect bool `json:"udp_connect,omitempty"`
UDPTimeout badoption.Duration `json:"udp_timeout,omitempty"`
@ -187,7 +188,10 @@ func (r *RouteOptionsActionOptions) UnmarshalJSON(data []byte) error {
if err != nil {
return err
}
if *r == (RouteOptionsActionOptions{}) {
if len(r.TCPPrefix) == 0 {
r.TCPPrefix = nil
}
if reflect.DeepEqual(*r, RouteOptionsActionOptions{}) {
return E.New("empty route option action")
}
if r.TLSFragment && r.TLSRecordFragment {

View file

@ -133,6 +133,31 @@ func (m *ConnectionManager) NewConnection(ctx context.Context, this N.Dialer, co
m.logger.ErrorContext(ctx, err)
return
}
if len(metadata.TCPPrefix) > 0 {
writeContext, cancel := context.WithTimeout(ctx, C.TCPTimeout)
writeClosed := make(chan struct{})
stop := context.AfterFunc(writeContext, func() {
remoteConn.Close()
close(writeClosed)
})
var n int
n, err = remoteConn.Write(metadata.TCPPrefix)
if !stop() {
<-writeClosed
err = writeContext.Err()
}
cancel()
if err == nil && n < len(metadata.TCPPrefix) {
err = io.ErrShortWrite
}
if err != nil {
err = E.Cause(err, "write TCP prefix")
remoteConn.Close()
N.CloseOnHandshakeFailure(conn, onClose, err)
m.logger.ErrorContext(ctx, err)
return
}
}
err = N.ReportConnHandshakeSuccess(conn, remoteConn)
if err != nil {
err = E.Cause(err, "report handshake success")

View file

@ -394,11 +394,20 @@ func (r *Router) PreMatch(metadata adapter.InboundContext, firstPacket []byte) a
r.logger.DebugContext(ctx, "sniffed packet protocol: ", metadata.Protocol)
}
case *R.RuleActionRouteOptions:
if metadata.Network == N.NetworkTCP && len(action.TCPPrefix) > 0 {
return continueResult
}
applyRouteOptionsOverride(&metadata, action)
case *R.RuleActionRoute:
if metadata.Network == N.NetworkTCP && len(action.TCPPrefix) > 0 {
return continueResult
}
applyRouteOptionsOverride(&metadata, &action.RuleActionRouteOptions)
return r.preMatchFlow(ctx, &metadata, packetDestination, currentRule, action.Outbound)
case *R.RuleActionBypass:
if metadata.Network == N.NetworkTCP && len(action.TCPPrefix) > 0 {
return continueResult
}
applyRouteOptionsOverride(&metadata, &action.RuleActionRouteOptions)
if action.Outbound == "" {
if metadata.Destination.IsDomain() || metadata.Destination != packetDestination {
@ -658,6 +667,9 @@ match:
if routeOptions.FallbackDelay != 0 {
metadata.FallbackDelay = routeOptions.FallbackDelay
}
if len(routeOptions.TCPPrefix) > 0 {
metadata.TCPPrefix = routeOptions.TCPPrefix
}
if routeOptions.UDPDisableDomainUnmapping {
metadata.UDPDisableDomainUnmapping = true
}

View file

@ -32,6 +32,7 @@ func newRuleActionRouteOptions(options option.RawRouteOptionsActionOptions) (Rul
OverridePort: options.OverridePort,
NetworkStrategy: (*C.NetworkStrategy)(options.NetworkStrategy),
FallbackDelay: time.Duration(options.FallbackDelay),
TCPPrefix: options.TCPPrefix,
UDPDisableDomainUnmapping: options.UDPDisableDomainUnmapping,
UDPConnect: options.UDPConnect,
UDPTimeout: time.Duration(options.UDPTimeout),
@ -63,6 +64,9 @@ func NewRuleAction(logger logger.ContextLogger, action option.RuleAction) (adapt
}
return &routeOptions, nil
case C.RuleActionTypeBypass:
if action.BypassOptions.Outbound == "" && len(action.BypassOptions.TCPPrefix) > 0 {
return nil, E.New("tcp_prefix requires an outbound for bypass")
}
routeOptions, err := newRuleActionRouteOptions(action.BypassOptions.RawRouteOptionsActionOptions)
if err != nil {
return nil, err
@ -205,6 +209,7 @@ type RuleActionRouteOptions struct {
NetworkType []C.InterfaceType
FallbackNetworkType []C.InterfaceType
FallbackDelay time.Duration
TCPPrefix []byte
UDPDisableDomainUnmapping bool
UDPConnect bool
UDPTimeout time.Duration
@ -243,6 +248,9 @@ func (r *RuleActionRouteOptions) Descriptions() []string {
if r.FallbackDelay > 0 {
descriptions = append(descriptions, F.ToString("fallback-delay=", r.FallbackDelay.String()))
}
if len(r.TCPPrefix) > 0 {
descriptions = append(descriptions, "tcp-prefix")
}
if r.UDPDisableDomainUnmapping {
descriptions = append(descriptions, "udp-disable-domain-unmapping")
}