Skip to content

Latest commit

 

History

History
85 lines (52 loc) · 3.48 KB

README-en.md

File metadata and controls

85 lines (52 loc) · 3.48 KB
Raw

UA Cyber SHIELD

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

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

Release

The voluntary Ukrainian cyber defense system

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 voluntary defense center works are doing 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 to fund our operations:

  1. Expenses on constantly buying new proxy servers
  2. From time to time buying servers for new infastructure

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

You can help us using:

  • BTC: 11wxDarouPfY6P3misLvFuJ8k8oWhd4qb

Also, here are some variants if you want to help developers with some cofee. So we can continue to skip work and keep invest time in project all nights:

  • BTC: 12CcLYn6zrBcnmvK5fRSAQcJre5jknyTxH

We will add more variants in future :)