CBTT:Documentation

From Depthstrike Entertainment
Jump to: navigation, search

Configuration File

Peer ID/User Agent Client Banning

  • When on in blacklist mode, Peer IDs and User Agents defined in the ban file (one per line) are denied access to the tracker and all others are allowed
  • When on in VIP mode, Peer IDs and User Agents defined in the ban file (one per line) are allowed access to the tracker and all others are denied

cbtt_ban_mode

  • Values:
    • 0 - Off (Default)
    • 1 - Banlist (bans if present)
    • 2 - VIP List (bans if not present, not recommended)

cbtt_ban_file

  • Accepts any valid filesystem file reference
  • Default value: clientbans.bnbt
  • Peer IDs and User Agents are stored 1 per line in the file.

Client spoofing detection

  • When on, this forces specific Peer ID prefixes to be associated with specific user agents.
    • This feature is still under development and may accidentally ban legitimate clients. Please contact me if this happens.

cbtt_restricted_peer_spoofing

  • Values:
    • 0 - Off (Default)
    • 1 - On

Returned torrents sent uncompressed

  • When on, torrents returned to the client through the /torrent.html and /torrents/ interfaces are returned without being passed through ZLib first.

cbtt_dont_compress_torrents

  • Values:
    • 0 - Off (Default)
    • 1 - On

Restricted overflow attack limits

  • When active, if a client reports either uploaded or downloaded (in bytes) above the specified overflow limit, it will be rejected.

cbtt_restrict_overflow

  • Values:
    • 0 - Off (Default)
    • 1 - On

cbtt_restrict_overflow_limit

  • Values: any valid 64bit integer above 107374182400 ( 1099511627776 default )

IP Banning

  • When on in blacklist mode, IP Addresses defined in the ban file (one per line) are denied access to the tracker and all others are allowed.
  • When on in VIP mode, IP Addresses defined in the ban file (one per line) are allowed access to the tracker and all others are denied.

cbtt_ip_ban_mode

  • Values:
    • 0 - Off (Default)
    • 1 - Banlist (bans if present)
    • 2 - VIP List (bans if not present)

cbtt_ipban_file

  • Accepts any valid filesystem file reference
  • Default value: bans.bnbt
  • IP addresses are stored 1 per line in the file.

Private IP Spoofing Blocking

  • When on, if the ip= parameter in an announce is a loopback (127.0.0.1) or a private IP (RFC1918) that parameter is ignored.

cbtt_block_private_ip

  • Values:
    • 0 - Off (Default)
    • 1 - On

Public IP Spoofing Blocking

  • When on, if the announcing client reports an ip= parameter in their announce and their IP is not a loopback (127.0.0.1) or private IP (RFC1918) that parameter is ignored.

only_local_override_ip

  • Values:
    • 0 - Off (Default)
    • 1 - On

MySQL Update instead of overwrite support

  • When on, the MySQL behaviour when override dstate is disabled changes to update existing fields instead of clearing the database and rewriting it. This function requires MySQL version 4.1 or newer (4.01 and older do NOT support the query syntax used for this)

mysql_cbtt_ttrader_support

  • Values:
    • 0 - Off (Default)
    • 1 - On

Port Blacklisting

  • When on, ports within several common p2p ranges are blacklisted and will be rejected by the tracker.
  • The current ranges are: 411-413, 1214, 4662, 6346-6347, 6881-6999
  • Blacklisting below Port 1024 to prevent e-mail scanners from detecting.

cbtt_blacklist_common_p2p_ports

  • Values:
    • 0 - Off (Default)
    • 1 - On

cbtt_blacklist_below_1024

  • Values:
    • 0 - Off (Default)
    • 1 - On

XML Dump modification

  • Seed and Downloader counts have been added to the individual torrent's tag.

bnbt_dump_xml_peers

  • Controls wether individual peer information is included in XML dumps.
  • Values:
    • 0 - Off
    • 1 - On (Default)

Private Tracker Flag

  • When on, the tracker will include a '"private" = 1' value in the announce response

bnbt_private_tracker_flag

  • Values:
    • 0 - Off (Default)
    • 1 - On

Custom Tracker Title

bnbt_tracker_title

  • Value controls the tracker's displayed title.

Swap Torrent Download and Stats Link

bnbt_swap_torrent_link

  • Values:
    • 0 - Off (Default)
    • 1 - On

Download and Statistics Link Images

cbtt_download_link_image

  • Web Accessible location for image to use for download link

cbtt_stats_link_image

  • Web Accessible location for image to use for statistics link

Compact/No Peer ID Announce Support Requirement

cbtt_require_no_peer_id

  • Values:
    • 0 - Off (Default)
    • 1 - On

cbtt_require_compact

  • Values:
    • 0 - Off (Default)
    • 1 - On

Allow/Disallow Global Scrape

bnbt_allow_scrape_global

  • Values:
    • 0 - Deny (Default)
    • 1 - Allow

Announce 'key' paramater support

  • Enables Support for/requirement of the announce 'key' paramater for authentication of a peer in case of IP changes.

bnbt_use_announce_key

  • Values:
    • 0 - Off
    • 1 - On (Default)

bnbt_require_announce_key

  • Values:
    • 0 - Off
    • 1 - On (Default)