---
title: 'antispam:plugin:redirectors'
url: 'https://docs.danami.com/warden/command-line-interface/antispam/antispam-plugin-redirectors'
markdown: 'https://docs.danami.com/warden/command-line-interface/antispam/antispam-plugin-redirectors.md'
date: '2026-10-07'
description: 'Check for redirected URLs in messages then add the URLs to a list of URIs which can then be scored and accessed by other plug-ins. warden --task=antispam:plugin:redirectors Option Value Default Description --url_redirector_cache_type <dbi|none> dbi The cache type that is being utiliz…'
taxonomy:
  category:
    - docs
  tag:
    - redirectors
---

[](#)  [ Basics ](https://docs.danami.com/warden/)     [ Command Line Interface ](https://docs.danami.com/warden/command-line-interface)      Antispam       antispam:plugin:redirectors    

# antispam:plugin:redirectors

Check for redirected URLs in messages then add the URLs to a list of URIs which can then be scored and accessed by other plug-ins.

```
warden --task=antispam:plugin:redirectors
```

| Option | Value | Default | Description |
|---|---|---|---|
| `--url_redirector_cache_type` | <dbi\|none> | dbi | The cache type that is being utilized. Most servers should use dbi to cache lookups to MariaDB/MySQL. |
| `--url_redirector_cache_ttl` | <digit> | 86400 | The length of time a cache entry will be valid for in seconds. |
| `--url_redirector_cache_autoclean` | <digit> | 1000 | Automatically purge old entries from database. The value describes a random run chance of 1/x. The default value of 1000 means that cleaning is run approximately once for every 1000 messages processed. A value of 1 would mean database is cleaned every time a message is processed. Set 0 to disable automatic cleaning and to do it manually. |
| `--url_redirector_loginfo` | <1\|0> | 0 | If this option is enabled then redirected URLs and the decoded URLs will be logged with info priority. |
| `--url_redirector_timeout` | <digit> | 5 | The maximum time a redirection URL HTTP request can take, in seconds. |
| `--max_redir_urls` | <digit> | 10 | The maximum amount of redirector URLs that will be looked up per message. Chained redirections are not counted, only initial redirection URLs found. Setting it to 0 disables HTTP requests, allowing only redir\_url() test to work and report any found redirector URLs. |
| `--max_redir_url_redirections` | <digit> | 10 | The maximum depth of chained redirections that a redirector can generate. |
| `--url_redirector_user_agent` | <string> | Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/101.0.4951.67 Safari/537.36 | The user-agent header for HTTP requests. Some services require it to look like a common browser. |
| `--url_redirector_params` | <string> | (?:adurl\|af\_web\_dp\|cm\_destination\|continue\|destination\|destURL\|goto\|h\|l\|login\|location\|p1\|pval\|r\|redir\|redirect\|redirectTo\|ret\_url\|return\|returnUrl\|referer\|service\|target\|tid\|u\|url)=(.\*) | The regexp used to parse URI parameters in order to detect redirectors and to get redirected domains. The regexp must match only the redirected domain. |
| `--url_redirector` | <string1,string2> |  | Domains that should be considered as a URL redirector. If the domain begins with a ".", 3rd level tld of the main domain will be checked. |
| `--url_redirector_add` | <string> |  | Add a single domain to url\_redirector. |
| `--url_redirector_del` | <string> |  | Remove a single domain from url\_redirector. |
| `--url_redirector_get` | <string1,string2> |  | Alias to url\_redirector. The HTTP request will be done with a GET method, instead of the default HEAD. |
| `--url_redirector_get_add` | <string> |  | Add a single domain to url\_redirector\_get. |
| `--url_redirector_get_del` | <string> |  | Remove a single domain from url\_redirector\_get. |
| `--clear_url_redirector` | <string1,string2> |  | Clear configured url\_redirector and url\_redirector\_get domains, for example to override default settings from an update channel. If domains are specified, then only those are removed from list. |
| `--clear_url_redirector_add` | <string> |  | Add a single domain to clear\_url\_redirector. |
| `--clear_url_redirector_del` | <string> |  | Remove a single domain from clear\_url\_redirector. |
| `--default` | <yes> |  | Reset all settings to their default values. |
| `--default_option` | <option> |  | Reset a specific setting to its default value. |
| `--reload` | <yes> |  | Reload the service after saving settings. |

## Examples

```
// set the url_redirector_cache_type to cache to MariaDB/MySQL
warden --task=antispam:plugin:redirectors --url_redirector_cache_type=dbi --reload=yes

// reset url_redirector_cache_type to its default value
warden --task=antispam:plugin:redirectors --default_option=url_redirector_cache_type --reload=yes

// reset all settings to their default values
warden --task=antispam:plugin:redirectors --default=yes --reload=yes

// look up up to 25 redirector URLs per message and log the decoded targets during an investigation
warden --task=antispam:plugin:redirectors --max_redir_urls=25 --url_redirector_loginfo=1 --reload=yes
```

## Related Pages

- [Redirectors Settings](https://docs.danami.com/warden/settings/antispam/plugin-settings/redirectors "Redirectors Settings")
- [Redirectors](https://docs.danami.com/warden/user-guide/antispam-plugins/redirectors "Redirectors")

 [ ](https://docs.danami.com/warden/user-guide/antispam-plugins/redirectors) [](https://docs.danami.com/warden/settings/antispam/plugin-settings/redirectors)

---

## Navigation

- Previous: [antispam:plugin:razor2](https://docs.danami.com/warden/command-line-interface/antispam/antispam-plugin-razor2.md)
- Next: [antispam:plugin:relaycountry](https://docs.danami.com/warden/command-line-interface/antispam/antispam-plugin-relaycountry.md)