Trapster Documentation

Appearance

Configuration ​

Trapster uses a configuration file located at trapster/data/trapster.conf. Ensure the configuration file is correctly set up before running the daemon. You can add as many services as you want, even multiple services of the same type.

The configuration file is a JSON file that contains the configuration for the trapster daemon.

Change the configuration file using the -c flag:

bash
cd trapster-community
python3 main.py -c /path/to/config.json

Configuration Options ​

Network Settings ​

  • whitelist_ips: List of IP addresses to whitelist

    • IP addresses in this list will be ignored by Trapster to avoid false positives

  • interface: Network interface to bind to

    • Defaults to 0.0.0.0 (all interfaces) if not specified
    • Can be set to a specific interface name (e.g., eth0, wlan0)
    • To find your interface name on Linux:
      bash
      ifconfig  # or
ip a
    • Or use Trapster's built-in command:
      bash
      python3 main.py -i

Service Configuration ​

  • services: Array of service configurations
    • Multiple services can be configured
    • Duplicate service types are allowed

For example, you can configure multiple FTP services:

json
"services": {
    "ftp": [
        {
        "port": 21,
        "username": null,
        "password": null,
        "banner": "Microsoft FTP Service"
        },
        {
        "port": 2121,
        "username": null,
        "password": null,
        "banner": "(vsftpd 3.0.3)"
        }
    ]
}

For a specific detailed example, you can refer to each service's documentation: