tlspr(8) Universal proxy server tlspr(8)
NAME
tlspr - SNI proxy gateway service
SYNOPSIS
tlspr [-d][-a] [-l[[@]logfile]] [-plistening_port] [-Pdestination_port]
[-ctls_check_level] [-iinternal_ip] [-eexternal_ip]
DESCRIPTION
tlspr is an SNI gateway service (destination host is taken from TLS
handshake). The destination port must be specified via the -P option (or
it may be detected with the Transparent plugin). tlspr does not support
user authentication; use ACLs by client IP or a parent proxy with au-
thentication if access control is required.
OPTIONS
-I Inetd mode. Standalone service only.
-d Daemonize. Detach service from console and run in the background.
-t Be silenT. Do not log start/stop/accept error records.
-u Never ask for username authentication
-e External address. IP address of the interface the proxy should
initiate connections from. By default, the system will decide
which address to use in accordance with the routing table.
-niPATH
(Linux only) Switch to the network namespace identified by PATH
before opening the listening socket. The current namespace is
saved and restored immediately after binding, so outgoing connec-
tions run in the original namespace unless -ne is also given.
-nePATH
(Linux only) Switch to the network namespace identified by PATH
after the listening socket has been bound (and after restoring
from -ni if applicable). Both options accept any namespace file
path (e.g. /var/run/netns/myns or /proc/PID/ns/net) and require
CAP_SYS_ADMIN.
-i Internal address. IP address the proxy accepts connections to.
By default, connections to any interface are accepted. It´s usu-
ally unsafe. Unix domain sockets can be specified with -iu-
nix:/path/to/socket syntax (e.g., -iunix:/var/run/tlspr.sock). On
Linux, abstract sockets use -iunix:@socketname syntax.
-a Anonymous. Hide information about client.
-a1 Anonymous. Show fake information about client.
-p listening_port. Port proxy listens for incoming connections. De-
fault is 1443.
-P destination_port. Port to establish outgoing connections. Re-
quired unless the Transparent plugin is used, because the TLS
handshake does not contain port information. Default is 443.
-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 re-
quest and the client sends a certificate (not compatible with TLS
1.3)
-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() -s does the same; with splice() (Linux)
-s is splice, see 3proxy.cfg(5).
-Ximap | -Xpop3 | -Xsmtp
STARTTLS mode for the given protocol. The proxy speaks the plain-
text protocol with the client (greeting, capability advertisement
with STARTTLS only, STARTTLS command), then, after the client is-
sues STARTTLS and sends a TLS Client HELLO, connects to the des-
tination taken from SNI (default port 143/110/587), performs
STARTTLS negotiation with the destination server and transpar-
ently passes TLS traffic. If the destination server does not sup-
port STARTTLS, the TLS handshake with the client fails.
-l Log. By default logging is to stdout. If logfile is specified
logging is to file. Under Unix, if ´@´ precedes logfile, syslog
is used for logging.
-S Increase or decrease stack size. You may want to try something
like -S8192 if you experience 3proxy crashes.
CLIENTS
You should use a client with TLS support or configure a router to redi-
rect TLS traffic to the proxy (transparent proxy). Configure the client
to connect to internal_ip and port. If you need to limit clients, use
3proxy(8) instead.
BUGS
Report all bugs to 3proxy@3proxy.org
SEE ALSO
3proxy(8), ftppr(8), proxy(8), socks(8), pop3p(8), smtpp(8), tcppm(8),
udppm(8), syslogd(8),
https://3proxy.org/
AUTHORS
3proxy is designed by Vladimir Dubrovin <vlad@3proxy.org>
3proxy 0.9 May 2026 tlspr(8)
Generated by dwww version 1.16 on Fri Nov 13 13:43:20 CET 2026.