Skip to content

Latest commit

 

History

History
89 lines (56 loc) · 3.77 KB

README-en.md

File metadata and controls

89 lines (56 loc) · 3.77 KB

UA Cyber SHIELD

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!

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

Release

The volunteer cyber defense system of Ukraine

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. It doesn't affect Windows

How it works

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. Targets being attacked are changed automatically and are downloaded from the control center/server.

Program interface

A working example

How to build 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 if you want to use a proxy or not

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 if you want to use a proxy or not

Deploy on Raspberry Pi

balena deploy button

Deploy with Ansible

tools/ansible/README.md

Deploy to 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. From time to time buying servers for new infastructure

When we win the war and there is peace in Ukraine, funds will be transfered to voluntary associations to help victims of this war.

You can help us using:

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

Also, here are some variants if you want to help developers with some coffee, so we can continue to skip work and keep investing time in the project all nights:

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

We will add more variants in future :)