From 248af1412d756f22e4dd757b9a0f12a8f4b4090d Mon Sep 17 00:00:00 2001 From: Vladimir Dubrovin <3proxy@3proxy.ru> Date: Sun, 25 Oct 2026 18:53:26 +0300 Subject: [PATCH] -B: the TLS ClientHello split at the SNI, which -s is taken for splice tlspr splits the ClientHello it passes in the middle of the server name (SNI) when the service has s_option, set by -s. In builds with splice() (Linux, the default there) -s is splice for every service but UDP ones and admin, so the split was never made, and the How-To's SNI break did nothing on Linux. -B sets it whatever the build: for TCP services but admin, where s_option has a meaning of its own. -s still does it where it is not splice. The How-To, 3proxy.cfg(5) and tlspr(8) give -B. Fixes #1283 Co-Authored-By: Claude Opus 5.5 --- doc/html/howtoe.html | 4 ++-- doc/html/howtor.html | 4 ++-- man/3proxy.cfg.5 | 7 +++++++ man/tlspr.8 | 4 ++-- src/proxymain.c | 9 +++++++++ 5 files changed, 22 insertions(+), 6 deletions(-) diff --git a/doc/html/howtoe.html b/doc/html/howtoe.html index 3c71249..a994799 100644 --- a/doc/html/howtoe.html +++ b/doc/html/howtoe.html @@ -646,13 +646,13 @@ see How to set up a DNS proxy (dnspr).
tlspr can be used as a parent with the "tls" type to implement SNI splitting for DPI bypass (similar to NoDPI/GoodByeDPI). The client sends the first part of the TLS ClientHello, tlspr splits it at the SNI extension and sends it in two TCP packets, which can bypass some DPI systems that look for blocked hostnames in TLS handshakes. -
To enable SNI break, use parent ... tls 0.0.0.0 0 and the -s option on the listening service with TCP_NODELAY: +
To enable SNI break, use parent ... tls 0.0.0.0 0 and the -B option on the listening service with TCP_NODELAY: 

 auth iponly
 allow *
 parent 1000 tls 0.0.0.0 0
 allow *
-proxy -s -i127.0.0.1 -ocTCP_NODELAY -osTCP_NODELAY -p1443
+proxy -B -i127.0.0.1 -ocTCP_NODELAY -osTCP_NODELAY -p1443

TCP_NODELAY is required to prevent the kernel from merging the split packets. diff --git a/doc/html/howtor.html b/doc/html/howtor.html index 0182a6c..4f0c049 100644 --- a/doc/html/howtor.html +++ b/doc/html/howtor.html @@ -654,13 +654,13 @@ iptables -t nat -A PREROUTING -p tcp -m multiport --dports 443,993,465 -j REDIRE
tlspr может использоваться как родительский прокси типа "tls" для реализации SNI-фрагментации (аналог NoDPI/GoodByeDPI). Клиент отправляет первую часть TLS ClientHello, tlspr разбивает его на расширении SNI и отправляет двумя TCP-пакетами, что позволяет обойти некоторые DPI-системы, ищущие заблокированные имена хостов в TLS-рукопожатиях. -
Для включения SNI break используйте parent ... tls 0.0.0.0 0 и опцию -s на слушающем сервисе с TCP_NODELAY: +
Для включения SNI break используйте parent ... tls 0.0.0.0 0 и опцию -B на слушающем сервисе с TCP_NODELAY: 

 auth iponly
 allow *
 parent 1000 tls 0.0.0.0 0
 allow *
-proxy -s -i127.0.0.1 -ocTCP_NODELAY -osTCP_NODELAY -p1443
+proxy -B -i127.0.0.1 -ocTCP_NODELAY -osTCP_NODELAY -p1443

TCP_NODELAY необходим, чтобы ядро не объединяло разделенные пакеты. diff --git a/man/3proxy.cfg.5 b/man/3proxy.cfg.5 index 15dbc21..449a4dc 100644 --- a/man/3proxy.cfg.5 +++ b/man/3proxy.cfg.5 @@ -190,6 +190,13 @@ any protocol-specific data. .B -g(\fIGRACE_TRAFF\fB,\fIGRACE_NUM\fB,\fIGRACE_DELAY\fR) delay GRACE_DELAY milliseconds before polling if average polling size is below GRACE_TRAFF bytes and GRACE_NUM read operations in a single direction are detected within 1 second. Useful to minimize polling .br +.B -B +(for TCP services) split the TLS ClientHello across two TCP segments in the +middle of the server name (SNI) when it is passed through tlspr, as with +\fBparent ... tls 0.0.0.0 0\fR: some DPI systems looking for blocked host names +do not reassemble it. Use with \fB-ocTCP_NODELAY -osTCP_NODELAY\fR, or the kernel +may join the segments again. In builds without splice() \fB-s\fR does the same. +.br .B -s (for admin) secure, allow only secure operations, currently only traffic counters view without ability to reset. diff --git a/man/tlspr.8 b/man/tlspr.8 index 6bd903d..db3e0c5 100644 --- a/man/tlspr.8 +++ b/man/tlspr.8 @@ -76,8 +76,8 @@ destination_port. Port to establish outgoing connections. Required unless the Tr .B -c TLS_CHECK_LEVEL. 0 (default) - allow non-TLS traffic to pass, 1 - require TLS, only check client HELLO packet, 2 - require TLS, check both client and server HELLO, 3 - require TLS, check that the server sends a certificate (not compatible with TLS 1.3), 4 - require mutual TLS, check that the server sends a certificate request and the client sends a certificate (not compatible with TLS 1.3) .TP -.B -s -Split the TLS Client HELLO packet across multiple TCP segments to make SNI-based DPI detection harder. An optional numeric value can follow (e.g. \fB-s1\fR) to control the splitting behaviour. +.B -B +Split the TLS Client HELLO packet across two TCP segments, in the middle of the SNI, to make SNI-based DPI detection harder. In builds without splice() \fB-s\fR does the same; with splice() (Linux) \fB-s\fR is splice, see \fB3proxy.cfg\fR(5). .TP .B -Ximap | -Xpop3 | -Xsmtp STARTTLS mode for the given protocol. The proxy speaks the plaintext protocol diff --git a/src/proxymain.c b/src/proxymain.c index f78b31b..9485d0f 100644 --- a/src/proxymain.c +++ b/src/proxymain.c @@ -364,6 +364,8 @@ int MODULEMAINFUNC (int argc, char** argv){ " association: 1 - log, 2 - authorize, 3 - both (default), 0 (same as -U) -\n" " neither. The first destination is always authorized and logged\n" #endif + " -B split the TLS ClientHello passed through tlspr at the SNI (DPI bypass),\n" + " with -ocTCP_NODELAY -osTCP_NODELAY\n" "-g(GRACE_TRAFF,GRACE_NUM,GRACE_DELAY) - delay GRACE_DELAY milliseconds before polling if average polling size below GRACE_TRAFF bytes and GRACE_NUM read operations in single directions are detected within 1 second to minimize polling\n" " -fFORMAT logging format (see documentation)\n" " -l log to stderr\n" @@ -639,6 +641,13 @@ int MODULEMAINFUNC (int argc, char** argv){ case 'U': srv.udpauth = *(argv[i]+2)? atoi(argv[i]+2) : 0; break; + case 'B': + /* the TLS ClientHello split at the SNI (tlspr), which -s is + where -s is not splice; s_option means something else + for these */ + if(!isudp && srv.service != S_ADMIN) + srv.s_option = 1 + atoi(argv[i]+2); + break; case 's': #ifdef WITHSPLICE if(isudp || srv.service == S_ADMIN)