{"id":40334795,"url":"https://github.com/pikpikcu/nodesub","last_synced_at":"2026-01-20T08:31:53.211Z","repository":{"id":173179713,"uuid":"650351732","full_name":"pikpikcu/nodesub","owner":"pikpikcu","description":"Nodesub is a command-line tool for finding subdomains in bug bounty programs","archived":false,"fork":false,"pushed_at":"2024-08-01T15:42:53.000Z","size":1184,"stargazers_count":136,"open_issues_count":6,"forks_count":24,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-08-01T17:45:57.568Z","etag":null,"topics":["bugbounty","recon","subdomains"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/pikpikcu.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":"2023-06-06T22:19:54.000Z","updated_at":"2024-08-01T15:42:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"935d2308-0c46-40ae-9195-76028d5423b4","html_url":"https://github.com/pikpikcu/nodesub","commit_stats":null,"previous_names":["pikpikcu/nodesub"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pikpikcu/nodesub","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pikpikcu%2Fnodesub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pikpikcu%2Fnodesub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pikpikcu%2Fnodesub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pikpikcu%2Fnodesub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pikpikcu","download_url":"https://codeload.github.com/pikpikcu/nodesub/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pikpikcu%2Fnodesub/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28598992,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T02:08:49.799Z","status":"ssl_error","status_checked_at":"2026-01-20T02:08:44.148Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["bugbounty","recon","subdomains"],"created_at":"2026-01-20T08:31:53.136Z","updated_at":"2026-01-20T08:31:53.196Z","avatar_url":"https://github.com/pikpikcu.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  NODESUB\n  \u003cbr\u003e\n\u003c/h1\u003e\n\nNodesub is a command-line tool for finding subdomains in bug bounty programs. It supports various subdomain enumeration techniques and provides flexible options for customization.\n\n# Features\n\n\u003ch1 align=\"left\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/pikpikcu/nodesub/main/nodesub.png\" alt=\"nodesub\" width=\"700px\"\u003e\u003c/a\u003e\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n- Perform subdomain enumeration using CIDR notation (Support input list).\n- Perform subdomain enumeration using ASN (Support input list).\n- Perform subdomain enumeration using a list of domains.\n\n## Installation\n\nTo install Nodesub, use the following command:\n\n`npm install -g nodesub`\n\n**NOTE:**\n\n- Edit File `~/.config/nodesub/config.ini`\n\n# ✔️ Usage\n\n```\nnodesub -h\n```\n\nThis will display help for the tool. Here are all the switches it supports.\n\n```\nUsage: nodesub [options]\n\nNodesub is a command-line tool for finding subdomains in bug bounty programs.\n\nOptions:\n  -u, --url \u003cdomain\u003e                     Main domain\n  -l, --list \u003cfile\u003e                      File with list of domains\n  -c, --cidr \u003ccidr/file\u003e                 Perform subdomain enumeration using CIDR\n  -a, --asn \u003casn/file\u003e                   Perform subdomain enumeration using ASN\n  -dns, --dnsenum                        Enable DNS Enumeration (if you enable this the enumeration process will be slow)\n  -rl, --rate-limit \u003climit\u003e              Rate limit for DNS requests (requests per second) (default: \"0\")\n  -ip, --ips                             Ekstrak IPs in Subdomain Resolved\n  -wl, --wildcard                        Filter subdomains by wildcard DNS resolution Default:(False)\n  -r, --recursive                        Enable recursive subdomain enumeration\n  -p, --permutations                     Enable subdomain permutations\n  -re,--resolver \u003cfile\u003e                  File with list of resolvers\n  -w, --wordlist \u003cfile\u003e                  Wordlist file\n  -pr, --proxy \u003cproxy\u003e                   Proxy URL\n  -pa, --proxy-auth \u003cusername:password\u003e  Proxy authentication credentials\n  -s, --size \u003csize\u003e                      Max old space size heap Default:(10048 MB)\n  -d, --debug                            Show DNS resolution details\n  -v, --verbose                          Enable verbose output\n  -o, --output \u003cfile\u003e                    Output file\n  -f, --format \u003cformat\u003e                  Output file format (txt, json, csv, pdf) (default: \"txt\")\n  -h, --help                             display help for command\n```\n\n## ✔️ Examples\n\n- Enumerate subdomains for a single domain:\n  \t```\n\tnodesub -u example.com\n\t```\n\n- Enumerate subdomains for a list of domains from a file:\n\t```\n\tnodesub -l domains.txt\n\t```\n- Perform subdomain enumeration using CIDR:\n\n  ```\n  node nodesub.js -c 192.168.0.0/24 -o subdomains.txt\n\n  ```\n\n  ```\n  node nodesub.js -c CIDR.txt -o subdomains.txt\n\n  ```\n- Perform subdomain enumeration using ASN:\n  ```\n  node nodesub.js -a AS12345 -o subdomains.txt\n  ```\n\n  ```\n  node nodesub.js -a ASN.txt -o subdomains.txt\n  ```\n- Enable recursive subdomain enumeration and output the results to a JSON file:\n\t```\n\tnodesub -u example.com -r -o output.json -f json\n\t```\n## Output\n\nThe tool provides various output formats for the results, including:\n- Text (txt)\n- JSON (json)\n- CSV (csv)\n- PDF (pdf)\n\nThe output file contains the resolved subdomains, failed resolved subdomains, or all subdomains based on the options chosen.\n\n### ✔️ ***Contribution\n\nYou can contribute in following ways:\n  - Give suggestions to make it better\n  - Fix issues \u0026 submit a pull request\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpikpikcu%2Fnodesub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpikpikcu%2Fnodesub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpikpikcu%2Fnodesub/lists"}