https://github.com/jgmdev/stopspam
Anti-spam system that uses text ip databases from various sources to block spammers at firewall level.
https://github.com/jgmdev/stopspam
anti-spam daemon iptables ipv4 ipv6 spamhaus stopforumspam stopspam-script
Last synced: 3 months ago
JSON representation
Anti-spam system that uses text ip databases from various sources to block spammers at firewall level.
- Host: GitHub
- URL: https://github.com/jgmdev/stopspam
- Owner: jgmdev
- License: mit
- Created: 2015-11-30T05:18:40.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2019-05-24T17:37:05.000Z (over 6 years ago)
- Last Synced: 2025-05-15T11:33:32.806Z (5 months ago)
- Topics: anti-spam, daemon, iptables, ipv4, ipv6, spamhaus, stopforumspam, stopspam-script
- Language: Shell
- Homepage:
- Size: 21.5 KB
- Stars: 7
- Watchers: 4
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- License: LICENSE
Awesome Lists containing this project
README
# Stop Spam
Anti-spam system that helps minimize the amount of spammers that
connect to your server by banning their ip's using one of the ip text databases
provided by [stopforumspam.com](http://www.stopforumspam.com/downloads).
Also the script can optionally fetch the
[spamhaus.org](https://www.spamhaus.org/drop/) ip list text files.
**Stop Spam** also keeps these text databases updated by periodically
downloading latest version from the website or any other url that
you set on the configuration file.
To keep the iptable rules minimal, the script bans every ip that is found
to be used for spamming for a predefined period of 10 minutes. After
the 10 minutes are due the ip is unbanned in order to minimize the
amount of rules actively used.
### Features
* Auto updates the spam ip database
* On the fly banning of spam ip's
* Keeps iptable rules clean
* Whitelisting of ip's and hosts
* IPv6 support
## Installation
As root user execute the following commands:
```shell
wget https://github.com/jgmdev/stopspam/archive/master.zip -O stopspam.zip
unzip stopspam.zip
cd stopspam-master
./install.sh
```
## Uninstallation
As root user execute the following commands:
```shell
cd stopspam-master
./uninstall.sh
```
## Usage
The installer will automatically detect if your system supports
init.d scripts or systemd services. If one of them is found
it will install apropiate files and start the stopspam script.
Once you have Stop Spam installed proceed to modify the config
files to fit your needs.
**/etc/stopspam/white.ip.list**
A list of ipv4 or ipv6 ip's to white list.
**/etc/stopspam/white.host.list**
A list of domains/hosts to white list.
**/etc/stopspam/stopspam.conf**
The behaviour of the stopspam script is modified by this configuration file.
For more details see **man stopspam** which has documentation of the
different configuration options.
After you modify the config files you will need to restart the daemon.
If running on systemd:
> systemctl restart stopspam
If running as classical init.d script:
> /etc/init.d/stopspam restart
> or
> service stopspam restart
## CLI Usage
**stopspam** [OPTION]
#### OPTIONS
**-h | --help:**
Show the help screen.
**-d | --start:**
Initialize a daemon to monitor connections.
**-s | --stop:**
Stop the daemon.
**-t | --status:**
Show status of daemon and pid if currently running.
**-b | --bans:**
List banned ip addresses.
**-u | --update:**
Updates the spammers database file.