{"id":13681669,"url":"https://github.com/opengs/uashield","last_synced_at":"2025-03-18T00:46:19.650Z","repository":{"id":37933453,"uuid":"464172545","full_name":"opengs/uashield","owner":"opengs","description":"Voluntary Ukraine security platform to protect us from Russian forces in the Internet","archived":false,"fork":false,"pushed_at":"2024-06-19T11:59:47.000Z","size":2825,"stargazers_count":1094,"open_issues_count":33,"forks_count":177,"subscribers_count":33,"default_branch":"master","last_synced_at":"2025-03-10T23:53:04.265Z","etag":null,"topics":["cybersecurity","ukraine","ukraine-invasion"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/opengs.png","metadata":{"files":{"readme":"README-en.md","changelog":"news.json","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-02-27T15:17:52.000Z","updated_at":"2025-03-09T17:58:06.000Z","dependencies_parsed_at":"2024-12-20T04:00:45.072Z","dependency_job_id":"f9548dc0-c2fc-44fb-9ba1-bfea684fcf66","html_url":"https://github.com/opengs/uashield","commit_stats":{"total_commits":265,"total_committers":40,"mean_commits":6.625,"dds":0.5962264150943396,"last_synced_commit":"cd3f96034ab1c01b3fb964c617cd22e788b9975e"},"previous_names":[],"tags_count":43,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengs%2Fuashield","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengs%2Fuashield/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengs%2Fuashield/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengs%2Fuashield/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opengs","download_url":"https://codeload.github.com/opengs/uashield/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244135898,"owners_count":20403797,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cybersecurity","ukraine","ukraine-invasion"],"created_at":"2024-08-02T13:01:34.070Z","updated_at":"2025-03-18T00:46:19.625Z","avatar_url":"https://github.com/opengs.png","language":"TypeScript","readme":"# New version of tool is available.\nUACyberShield V2 is available under https://github.com/opengs/itarmykit . This repository will be archived when the stable version of the new tool will be released.\n\n# UA Cyber SHIELD\n\n*CAUTION! We do not support unlawful attacks or malware campaigns that cause technical harm. We provide you with a tool which you can use, but we are not telling or advising you on what to do with it. YOU are responsible of what you choose to do with it !!!! We are just providing a tool JUST LIKE thousand others on Github. If we give you a hammer - YOU are responsible of what you choose to knock with it !*\n\n*Дивись цю сторінку [українською](README.md)*\n\n[![Release](https://img.shields.io/badge/Release-latest-blue)](https://github.com/opengs/uashield/releases/latest)\n\n## For cyber defenders\n\n1. You can find binaries on [releases page](https://github.com/opengs/uashield/releases)\n2. Find the [latest release](https://github.com/opengs/uashield/releases/latest) and your platform\n3. Download and run the binary file\n\n**Running on Linux may require an additional `--no-sandbox` argument. Windows doesn't require any additional arguments to run.**\n\n## How it works\n\nOur volunteer defense center does all the hard work: monitoring targets, running technical infrastructure, coordinating attack targets, syncronizing it with client applications, etc.\nWhen an attack is performed, the application gets the data it needs automatically.\nThe only thing you need to do is to install and run it.\nTargets being attacked are changed automatically and are downloaded from the control center/server.\n\n## Program interface\n\n![A working example](docs/working.png)\n\n## Run from source code\n\n1. Clone the repo: `git clone https://github.com/opengs/uashield.git`\n2. Install dependencies: `cd uashield \u0026\u0026 npm install`\n3. Run build: `npm run build:electron`\n4. Run the binary from `./dist/electron` or electron version: `npm run start:electron`\n\n## Headless version (Docker)\n\n1. Build an image: `docker build . -t uashield`\n2. Run: `docker run uashield --workers=512 --withProxy=true` - where --workers=`512` - threads count, and --withProxy=`true` | `false` whether you want to use proxies\n\nComplete command help: `docker run uashield --help`\n\nOr use [pre-built image](https://github.com/opengs/uashield/pkgs/container/uashield):\n\n```bash\ndocker run ghcr.io/opengs/uashield:master --workers=512 --withProxy=true\n```\n\n## Docker-compose version\n\n1. Run: `docker-compose up -d`\n2. Edit variables `WORKERS` and `USEPROXY` in file `docker-compose.yml` - where `256` - threads count, and `true` | `false` whether you want to use proxies\n\n## Deploy on Raspberry Pi\n\n[![balena deploy button](https://www.balena.io/deploy.svg)](https://dashboard.balena-cloud.com/deploy?repoUrl=https://github.com/opengs/uashield)\n\n## Deploy with Ansible\n\n[tools/ansible/README.md](tools/ansible/README.md)\n\n## Deploy on Kubernetes\n\n[tools/helm/README.md](tools/helm/README.md)\n\n## Deploy with Play With Docker - free instance for 4 hours\n\n[![Try in PWD](https://raw.githubusercontent.com/play-with-docker/stacks/master/assets/images/button.png)](https://labs.play-with-docker.com/?stack=https://raw.githubusercontent.com/opengs/uashield/master/pwd-docker-compose.yml)\n\n## Donations\nDonations will be used exclusively to fund our operations:\n1. Expenses on constantly buying new proxy servers\n2. Occasionally buying servers for IT infastructure\n\nWhen we win the war and there is peace in Ukraine, funds left will be transferred to charity funds to help casualties of the war.\n\nYou can help us through:\n- BTC: bc1q7e6ew74x56vdpsev5ycqq8ke3tk4yv5452l25g\n- ETH: 0x9472538607eE28F69FE7dAcD6C4cC17B9A20664F\n- USDT (ETH): 0x9472538607eE28F69FE7dAcD6C4cC17B9A20664F **this is address on ETH network**\n\nAlso, you can treat developers with some coffee so they can continue to skip work and keep investing time in the project all night long:\n- BTC: bc1q7g5s3c89lymc9vtrf0y8tqyx4mg0hefeyr6zsv\n- ETH: 0x75A291AB6795f747177975bac250B47A33ee54Ed\n- USDT (ETH): 0x75A291AB6795f747177975bac250B47A33ee54Ed **this is address on ETH network**\n\nWe will add more options in future :)\n","funding_links":[],"categories":["\u003e 1K ⭐️","TypeScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopengs%2Fuashield","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopengs%2Fuashield","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopengs%2Fuashield/lists"}