dwww Home | Manual pages | Find package

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.