{"id":26820399,"url":"https://github.com/zvdy/goldeneye","last_synced_at":"2025-09-09T18:31:16.133Z","repository":{"id":262588150,"uuid":"886832012","full_name":"zvdy/goldeneye","owner":"zvdy","description":null,"archived":false,"fork":false,"pushed_at":"2024-11-13T08:20:04.000Z","size":6,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-13T08:26:17.921Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zvdy.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2024-11-11T17:25:41.000Z","updated_at":"2024-11-13T07:29:36.000Z","dependencies_parsed_at":"2024-11-13T09:33:08.551Z","dependency_job_id":null,"html_url":"https://github.com/zvdy/goldeneye","commit_stats":null,"previous_names":["zvdy/goldeneye"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zvdy%2Fgoldeneye","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zvdy%2Fgoldeneye/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zvdy%2Fgoldeneye/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zvdy%2Fgoldeneye/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zvdy","download_url":"https://codeload.github.com/zvdy/goldeneye/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246285645,"owners_count":20752947,"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":[],"created_at":"2025-03-30T06:31:50.896Z","updated_at":"2025-03-30T06:32:10.501Z","avatar_url":"https://github.com/zvdy.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GoldenEye\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/zvdy/goldeneye)](https://goreportcard.com/report/github.com/zvdy/goldeneye)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://i.ibb.co/WV14jNj/logo.png\" alt=\"GoldenEye Logo\" width=\"170\" height=\"170\"\u003e\n\u003c/p\u003e\n\nGoldenEye is a powerful HTTP DoS (Denial of Service) attack tool designed to stress test web servers. It allows you to simulate multiple concurrent connections to a target URL, using various HTTP methods and user agents. This tool is intended for educational purposes and to test the robustness of your own web servers.\n\n## Features\n\n- Simulate multiple concurrent connections\n- Support for custom HTTP methods (GET, POST, RANDOM)\n- Option to disable SSL certificate verification\n- Customizable user agents\n- Debug mode for verbose output\n\n## Installation\n\nTo install GoldenEye, you need to have Go installed on your system. Clone the repository and build the project:\n\n```sh\ngit clone https://github.com/zvdy/goldeneye.git\ncd goldeneye\ngo build -o goldeneye ./cmd/goldeneye/main.go\n```\n\n## Usage\n\nTo run GoldenEye, use the following command:\n\n```sh\n./goldeneye \u003curl\u003e [OPTIONS]\n```\n\n### Options\n\n| Flag           | Description                                         | Default                  |\n|----------------|-----------------------------------------------------|--------------------------|\n| `-u, --useragents` | File with user-agents to use                         | randomly generated       |\n| `-w, --workers`    | Number of concurrent workers                         | 50                       |\n| `-s, --sockets`    | Number of concurrent sockets                         | 30                       |\n| `-m, --method`     | HTTP Method to use ('get', 'post', 'random')         | get                      |\n| `-d, --debug`      | Enable Debug Mode (more verbose output)              | False                    |\n| `-n, --nosslcheck` | Do not verify SSL Certificate                        | True                     |\n| `-h, --help`       | Shows this help                                      |                          |\n\n### Example\n\n```sh\n./goldeneye http://example.com -w 100 -s 50 -m post -d\n```\n\nThis command will start a DoS attack on `http://example.com` with `100 workers`, each opening `50 sockets`, using the `POST` method, and enabling debug mode.\n\n### Docker\n\nTo build and run the application using Docker, follow these steps:\n\n1. **Build the Docker image**\n\n   ```sh\n   docker build -t goldeneye .\n   ```\n\n2. **Run the Docker container**\n\n   ```sh\n   docker run -it --rm goldeneye \u003curl\u003e [OPTIONS]\n   ```\n\n   Replace `\u003curl\u003e` and `[OPTIONS]` with the appropriate values for your application.\n\n### Docker Hub Repository\n\nYou can also pull the pre-built Docker image from Docker Hub:\n\n```sh\ndocker pull zvdy/goldeneye\n```\n\nDocker Hub Repository: [zvdy/goldeneye](https://hub.docker.com/repository/docker/zvdy/goldeneye/general)\n\n### Example\n\nTo run the application with a specific URL and options:\n\n```sh\ndocker run -it --rm zvdy/goldeneye http://example.com \n```\n\n### Dockerfile\n\nEnsure you have the [Dockerfile](Dockerfile) in your cloned repository.\n\n### Testing\n\nYou can run the tests in order to check the functionality too:\n\n```sh\ngo test -v ./...\n```\n\n\n## Use Cases\n\n- **Stress Testing**: Test the robustness and performance of your web servers under heavy load.\n- **Educational Purposes**: Learn about HTTP DoS attacks and how to mitigate them.\n- **Security Testing**: Identify potential vulnerabilities in your web infrastructure.\n\n## Disclaimer\n\nGoldenEye is intended for educational purposes and testing your own web servers. Do not use this tool to attack websites without permission. Unauthorized use of this tool may violate local, state, and federal laws.\n\nRead [DISCLAIMER](DISCLAIMER.md) for more details.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Contributing\n\nContributions are welcome! Please open an issue or submit a pull request on GitHub.\n\n## Acknowledgements\n \nThis project is inspired by and based on the original [goldeneye](https://github.com/jseidl/GoldenEye) by [@jseidl](https://github.com/jseidl/). Special thanks to the original author for their work and inspiration.\n\n## Contact\n\nFor any questions or support, please open an issue on the GitHub repository.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzvdy%2Fgoldeneye","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzvdy%2Fgoldeneye","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzvdy%2Fgoldeneye/lists"}