Skip to content

Latest commit

 

History

History
103 lines (70 loc) · 4.42 KB

README-en.md

File metadata and controls

103 lines (70 loc) · 4.42 KB

UA Cyber SHIELD

<<<<<<< HEAD ALERT!!! We not supporting unlawful active attacks or malware campaigns that are causing technical harm. Use only for educational purposes. You can only try this platform on your own website!

ALERT!!! We are not supporting unlawful active attacks or malware campaings that are causing technical harms. Use only for educational purposes. You can only try this platform on your own website!

master

Дивись цю сторінку українською

Release

<<<<<<< HEAD The volunteer cyber defense system of Ukraine

Volunteer cyber defense system of Ukraine

master

For cyber defenders

  1. You can find binaries on releases page
  2. Find the latest release and your platform
  3. Download and run the binary file

Running on Linux may require an additional --no-sandbox argument. Windows doesn't require any additional arguments to run.

How it works

<<<<<<< HEAD Our volunteer defense center does all the hard work: monitoring the targets, running the technical infrastructure, coordinating the attack targets, coordinating with the client applications, etc. When the attack is performed, the application gets the data that it needs automatically. The only thing you need to do is to install it.

Our volunteer defense center does all the hard work: monitoring targets, running technical infrastructure, coordinating attack targets, syncronizing it with client applications, etc. When an attack is performed, the application gets the data it needs automatically. The only thing you need to do is to install and run it.

master Targets being attacked are changed automatically and are downloaded from the control center/server.

Program interface

A working example

Run from source code

  1. Clone the repo: git clone https://github.com/opengs/uashield.git
  2. Install dependencies: cd uashield && npm install
  3. Run build: npm run build:electron
  4. Run the binary from ./dist/electron or electron version: npm run start:electron

Headless version (Docker)

  1. Build an image: docker build . -t uashield
  2. Run: docker run uashield 512 true - where 512 - threads count, and true | false whether you want to use proxies

Or use pre-built image:

docker run -d ghcr.io/opengs/uashield:master 512 true

Docker-compose version

  1. Run: docker-compose up -d
  2. Edit variables WORKERS and USEPROXY in file docker-compose.yml - where 256 - threads count, and true | false whether you want to use proxies

Deploy on Raspberry Pi

balena deploy button

Deploy with Ansible

tools/ansible/README.md

Deploy on Kubernetes

tools/helm/README.md

Deploy with Play With Docker - free instance for 4 hours

Try in PWD

Donations

Donations will be used exclusively to fund our operations:

  1. Expenses on constantly buying new proxy servers
  2. Occasionally buying servers for IT infastructure

When we win the war and there is peace in Ukraine, funds left will be transferred to charity funds to help casualties of the war.

You can help us through:

  • BTC: bc1q7e6ew74x56vdpsev5ycqq8ke3tk4yv5452l25g
  • ETH: 0x9472538607eE28F69FE7dAcD6C4cC17B9A20664F
  • USDT (ETH): 0x9472538607eE28F69FE7dAcD6C4cC17B9A20664F this is address on ETH network

Also, you can treat developers with some coffee so they can continue to skip work and keep investing time in the project all night long:

  • BTC: bc1q7g5s3c89lymc9vtrf0y8tqyx4mg0hefeyr6zsv
  • ETH: 0x75A291AB6795f747177975bac250B47A33ee54Ed
  • USDT (ETH): 0x75A291AB6795f747177975bac250B47A33ee54Ed this is address on ETH network

We will add more options in future :)