dwww Home | Manual pages | Find package

socks(8)                     Universal proxy server                    socks(8)

NAME
       socks - SOCKS 4/4.5/5 gateway service

SYNOPSIS
       socks [-d] [-l[[@]logfile]] [-pport] [-iinternal_ip] [-eexternal_ip]

DESCRIPTION
       socks  is  SOCKS server. It supports SOCKSv4, SOCKSv4.5 (extension to v4
       for server side name resolution) and SOCKSv5. SOCKSv5 specification  al-
       lows both outgoing and reverse TCP connections and UDP portmapping.

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. External IP must be specified  if  you
              need  incoming  connections.   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.

       -Ne    External NAT address 3proxy reports to client  for  CONNECT/BIND.
              This  is  external  address of NAT between 3proxy and destination
              server.  By default, the external address is reported. It's  only
              useful  in  the  case  of  IP-IP  NAT and does not work with port
              translation.

       -Ni    Internal NAT address 3proxy reports to client for UDPASSOC.  This
              is external address of the NAT between  3proxy  and  the  client,
              client  uses  to connect to 3proxy.  By default, the internal ad-
              dress is reported. It's only useful in the case of IP-IP NAT  and
              does not work with port translation.

       -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/socks.sock). On
              Linux, abstract sockets use -iunix:@socketname syntax.

       -p     Port. Port proxy listens for  incoming  connections.  Default  is
              1080.

       -l     Log.  By  default  logging  is to stdout. If logfile is specified
              logging is to file. Under Unix, if ´@´ preceeds  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 SOCKS support or  use  some  socksification
       support  (for example SocksCAP or FreeCAP).  Configure client to use in-
       ternal_ip and port.  SOCKS allows you to use almost any application pro-
       tocol without limitation. This implementation also allows  you  to  open
       privileged  ports on the server (if socks has sufficient privileges). If
       you need to control access, use 3proxy(8) instead.

BUGS
       Report all bugs to 3proxy@3proxy.org

SEE ALSO
       3proxy(8), proxy(8), ftppr(8), pop3p(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                           socks(8)

Generated by dwww version 1.16 on Wed Nov 11 10:03:38 CET 2026.