{"id":19508048,"url":"https://github.com/ngn13/ezcat","last_synced_at":"2025-08-20T22:08:53.983Z","repository":{"id":193733610,"uuid":"689393264","full_name":"ngn13/ezcat","owner":"ngn13","description":"an easy interface for managing multiple linux \u0026 windows reverse shells over DNS","archived":false,"fork":false,"pushed_at":"2024-09-08T00:49:51.000Z","size":5079,"stargazers_count":6,"open_issues_count":2,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-09-08T01:42:39.056Z","etag":null,"topics":["netcat","reverse-shell-generator","reverse-shell-handler","revshell","shell"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ngn13.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2023-09-09T16:59:39.000Z","updated_at":"2024-09-08T00:49:47.000Z","dependencies_parsed_at":"2024-02-24T12:26:51.145Z","dependency_job_id":"8a278a3c-1adb-4c1e-9b32-2adc778fd53d","html_url":"https://github.com/ngn13/ezcat","commit_stats":null,"previous_names":["ngn13/ezcat"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngn13%2Fezcat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngn13%2Fezcat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngn13%2Fezcat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngn13%2Fezcat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ngn13","download_url":"https://codeload.github.com/ngn13/ezcat/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224024057,"owners_count":17243011,"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":["netcat","reverse-shell-generator","reverse-shell-handler","revshell","shell"],"created_at":"2024-11-10T23:03:05.849Z","updated_at":"2025-04-26T02:33:50.324Z","avatar_url":"https://github.com/ngn13.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ezcat 🐱 easy reverse shell handler\nhttps://github.com/ngn13/ezcat/assets/78868991/75c3c7c5-6768-47e4-9ef1-0a9e66710773\n\n---\n\n### 📋 Features\n- Easy to install\n- Simple web interface\n- Agent communication over TCP\n- Receive TCP reverse shells\n- Linux \u0026 Windows support\n- Self deletion because why not\n\n### 🚀 Install\nYou can easily install ezcat with docker:\n```\ndocker run --rm --network host       \\\n    -e EZCAT_PASSWORD=securepassword \\\n    ghcr.io/ngn13/ezcat\n```\n\n### ⚙️ Configuration\nConfiguration is handled with environment variables, here are all the options:\n\n- **`EZCAT_PASSWORD`**: Used to change the login password, by default it's `ezcat`, and for security, you should\ndefinitely change it\n- **`EZCAT_SHELLIP`**: By default ezcat will try to detect your interface IP address (giving priority to tunnel interfaces).\nIf you want set this IP address to something else by default, you can use this environment variable\n- **`EZCAT_DISABLE_MEGAMIND`**: When set to `1`, it disables the \"no shells?\" megamind meme that's displayed on the dashboard if you don't have\nany active shells\n- **`EZCAT_HTTP_PORT`**: Used to change the port that the API server will listen on, default is 5566\n- **`EZCAT_AGENT_PORT`**: Used to change the agent communication port, default is 1053\n- **`EZCAT_API_URL`**: Used to change the API URL for the front-end application\n- **`EZCAT_DIST_DIR`**: Directory that the server will use to store payload/stage builds, default is `./data`\n- **`EZCAT_STATIC_DIR`**: Used to change the front-end application (static) directory, it's pre-set in the Dockerfile,\nyou don't need to worry about it unless you are working on something\n- **`EZCAT_PAYLOAD_DIR`**: Specifies the directory that contains the payloads, it's pre-set in the Dockerfile, just like\nthe `EZCAT_STATIC_DIR` option, don't worry about it\n- **`EZCAT_DEBUG`**: When set to `1`, it enables debug output for the server and the stage builds\n\n### ⚒️ Build\nTo build ezcat, install a recent version go. Then download and [extract the latest release](http://github.com/ngn13/ezcat/releases/latest).\n- To build the server, install a recent version of go, change directory into the `server/` directory and run:\n```bash\ngo build\n```\n\n- To build the front-end application, install a recent version of node and npm change directory into the `app/` directory and run:\n```bash\nnpm i\nnpm run build\n```\n\nTo build different payloads during runtime, you will need GNU `coreutils` and `bash`, `build-essential` tools and optionally `mingw`\nfor windows builds. After installing these tools, you can run the `server/` binary with the desired configuration.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fngn13%2Fezcat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fngn13%2Fezcat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fngn13%2Fezcat/lists"}