StopPropaganda

Russia has invaded Ukraine and commited various war crimes. Russian media says that Russia has not commited any war crimes, has no casualties and they doing this "special operation" to protect Ukrainians from...Ukraine.

I believe that Russian propaganda websites should be down for their propaganda, therefore I created a simple DOS application that can be deployed almost anywhere.

DISCLAIMER: (D)DOS'ing is illegal! Usage of this tool is intended for educational purposes only.

It will DOS the following sites:

Usage

Docker

Easiest way is to use Docker:

docker run -d -p "8049:8049/tcp" erikmnkl/stoppropaganda

Use environment variables to change settings (for example --env SP_WORKERS=50) to change configuration. Available environment variables (and their defaults):

SP_BIND=":8049"
SP_WORKERS="20"
SP_TIMEOUT="10s"
SP_USERAGENT="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.102 Safari/537.36"

You can also use docker-compose:

services:
  stoppropaganda:
    image: erikmnkl/stoppropaganda
    container_name: stoppropaganda
    restart: unless-stopped
    ports:
      - "8049:8049/tcp"
    environment:
      SP_BIND: ":8049"
      SP_WORKERS: "20"
      SP_TIMEOUT: "10s"
      SP_USERAGENT: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.102 Safari/537.36"

NOTE: SP_WORKERS means workers per website, not in total. For example, 19 websites * 20 workers = 380 workers in total.

Then you can see status in this URL: http://<ip>:8049/status

Binaries

Download binary from releases.

Use from terminal:

# Show help
$ ./stoppropaganda_v0.0.1_linux_x86_64 --help

# Use with defaults
./stoppropaganda_v0.0.1_linux_x86_64

# Use with increased workers count (you might experience "too many open files" error on some systems)
./stoppropaganda_v0.0.1_linux_x86_64 --workers 50

Then open in your browser to see the status: http://127.0.0.1:8049/status

You might want to create SystemD script (Linux only) to autostart this on boot. Create /etc/systemd/system/stoppropaganda.service with below contents:

[Unit]
Description=Stoppropaganda service
After=network-online.target

[Service]
ExecStart=/path/to/binary --workers 50
Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target

Then systemctl daemon-reload && systemctl enable --now stoppropaganda.service. To stop, use systemctl stop stoppropaganda.service.

Building from source

Uninstall any existing Golang installations if you installed from official Linux repos. They are usually outdated and might not work at all.

Download and install Golang using these instructions. Validate if Golang binary works:

$ go version
go version go1.17.7 linux/amd64

Download this repo:

git clone https://github.com/erkexzcx/stoppropaganda.git
cd stoppropaganda

Now you have 2 options to run this application:

# Run without compiling to binary
go run stoppropaganda.go --help

# Build binary and run it
go build -o stoppropaganda stoppropaganda.go
./stoppropaganda --help

You can also build for other architectures/platforms as well, see build.sh file.

Recommendations

Increase workers count from 100 (default) to e.g. 500 for greater effect, but check the logs if you are not getting too many open files. If so, see this.
Change useragent to yours. See this.
General recommendation is to use VPN, but this is not necesarry. Remember - DOS/DDOS is illegal.

Inspiration

This application was inspired by the following projects:

About

DOS application to stop Russian propaganda websites. Support Ukraine!

Languages

Language:Go 61.4%Language:Shell 30.4%Language:Dockerfile 8.2%