is a bittorrent tracker that implements announce and scrape actions over the
UDP and the plain http protocol, aiming for minimal resource usage.
.Pp
When invoked with parameters, it binds to TCP and UDP port 6969 on all
interfaces. The recommended way to configure opentracker is by providing a
config file using the
@ -29,17 +28,14 @@ option. See
@@ -29,17 +28,14 @@ option. See
.Xropentracker.conf4
for details.
.Pp
.ShOPTIONS
The following options are available:
.Bl-tag-width-indent=8
.ItFlfArconfig
Parse a config file with a list of options. Consecutive command options
will override options from the config file. See
.Xropentracker.conf4
for details.
.ItFliArip-select
Select an ip address that will be used with the next
.OpFlp
@ -90,15 +86,11 @@ or
@@ -90,15 +86,11 @@ or
.BrWANT_ACCESSLIST_WHITE
options, this option sets the location of the accesslist.
.El
.ShEXAMPLES
Start
.Nm
bound on UDP and TCP ports 6969 on IPv6 localhost.
.Dl#./opentracker-i::1-p6969-P6969
.Pp
Start
.Nm
@ -106,12 +98,9 @@ bound on UDP port 6868 and TCP port 6868 on IPv4 localhost and allow
@@ -106,12 +98,9 @@ bound on UDP port 6868 and TCP port 6868 on IPv4 localhost and allow
privileged access from the network 192.168/16 while redirecting
HTTP clients accessing the root directory, which is not covered by the
bittorrent tracker protocol, to https://my-trackersite.com/.
@ -14,59 +14,59 @@ configuration file specifies various options for configuring the behavior of the
@@ -14,59 +14,59 @@ configuration file specifies various options for configuring the behavior of the
Lines starting with '#' are comments and are ignored. Options are specified as 'keyword value' pairs.
.Pp
The following options are available:
.Pp
.Bl-tag-width".It access.proxy"-compact
.Itlisten.tcp_udpAraddress
Specifies an address opentracker will listen on for both TCP and UDP connections. If none are specified, opentracker listens on 0.0.0.0:6969 by default. Can be added more than once.
.Pp
.Itlisten.tcpAraddress
Specifies the address opentracker will listen on for TCP connections. Can be added more than once.
.Pp
.Itlisten.udpAraddress
Specifies the address opentracker will listen on for UDP connections. Can be added more than once.
.Pp
.Itlisten.udp.workersArthreads
Specifies how many threads will be spawned to handle UDP connections. Defaults to 4.
.Pp
.Itaccess.whitelistArpath/to/whitelist
Specifies the path to the whitelist file containing all torrent hashes that opentracker will serve. Use this option if opentracker runs in a non-open mode.
.Pp
.Itaccess.blacklistArpath/to/blacklist
Specifies the path to the blacklist file containing all torrent hashes that opentracker will not serve. Use this option if opentracker was compiled to allow blacklisting.
.Pp
.Itaccess.fifo_addArpath/to/adder.fifo
Specifies the path to the FIFO (named pipe) used for dynamic changesets to accesslists. Info hashes written to this FIFO will be added to the main accesslist file.
.Pp
.Itaccess.fifo_deleteArpath/to/deleter.fifo
Specifies the path to the FIFO (named pipe) used for dynamic changesets to accesslists. Info hashes written to this FIFO will be removed from the main accesslist file.
.Pp
.Itaccess.statsArip_address_or_network
Specifies the IP address or network in CIDR notation allowed to fetch stats from opentracker.
.Pp
.Itaccess.stats_pathArpath
Specifies the path to the stats location. You can configure opentracker to appear anywhere on your tracker. Defaults to /stats.
.Pp
.Itaccess.proxyArip_address_or_network
Specifies the IP address or network of the reverse proxies. Opentracker will take the X-Forwarded-For address instead of the source IP address. Can be added more than once.
.Pp
.Itlivesync.cluster.listenArip_address:port
Specifies the IP address and port opentracker will listen on for incoming live sync packets to keep a cluster of opentrackers synchronized.
.Pp
.Itlivesync.cluster.node_ipArip_address
Specifies one trusted IP address for sync between trackers running in a cluster. Can be added more than once.
.Pp
.Itbatchsync.cluster.admin_ipArip_address
Specifies the admin IP address for old-style (HTTP-based) asynchronous tracker syncing.
.Pp
.Ittracker.rootdirArpath
Specifies the directory opentracker will chroot/chdir to. All black/white list files must be located in this directory.
.Pp
.Ittracker.userArusername
Specifies the user opentracker will setuid to after binding to potentially privileged ports.
.Pp
.Ittracker.redirect_urlArURL
Specifies the URL opentracker will redirect to in response to a "GET / HTTP" request.
.El
.ShEXAMPLES
To specify the address opentracker will listen on for both TCP and UDP connections:
.Dllisten.tcp_udp0.0.0.0:6969
@ -76,11 +76,11 @@ To specify the address opentracker will listen on for TCP connections:
@@ -76,11 +76,11 @@ To specify the address opentracker will listen on for TCP connections:
.Pp
To specify the address opentracker will listen on for UDP connections: