{"id":31287202,"url":"https://github.com/daghlar/fuckdomain","last_synced_at":"2025-09-24T11:02:58.149Z","repository":{"id":316088723,"uuid":"1061900612","full_name":"daghlar/fuckdomain","owner":"daghlar","description":"Fuck Domain Finder","archived":false,"fork":false,"pushed_at":"2025-09-22T15:29:02.000Z","size":10894,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-22T17:25:51.071Z","etag":null,"topics":["domain","golang","hacker","hacking","subdomain","subdomain-scanner"],"latest_commit_sha":null,"homepage":"https://www.daghlar.me","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/daghlar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-22T14:34:36.000Z","updated_at":"2025-09-22T15:29:06.000Z","dependencies_parsed_at":"2025-09-22T17:27:14.877Z","dependency_job_id":"e3f42865-8758-4b4e-a9b5-1463b6a99496","html_url":"https://github.com/daghlar/fuckdomain","commit_stats":null,"previous_names":["daghlar/fuckdomain"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/daghlar/fuckdomain","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daghlar%2Ffuckdomain","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daghlar%2Ffuckdomain/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daghlar%2Ffuckdomain/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daghlar%2Ffuckdomain/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daghlar","download_url":"https://codeload.github.com/daghlar/fuckdomain/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daghlar%2Ffuckdomain/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276737524,"owners_count":25695700,"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","status":"online","status_checked_at":"2025-09-24T02:00:09.776Z","response_time":97,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["domain","golang","hacker","hacking","subdomain","subdomain-scanner"],"created_at":"2025-09-24T11:01:02.869Z","updated_at":"2025-09-24T11:02:58.143Z","avatar_url":"https://github.com/daghlar.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Professional Subdomain Finder\n\nA comprehensive, modular subdomain enumeration and security analysis tool written in Go with advanced features and real-time web interface.\n\n## 🚀 Features\n\n### Core Functionality\n- **Modular Architecture**: Clean separation of concerns with dedicated modules\n- **DNS Resolution**: Multiple DNS record types support (A, CNAME, MX, TXT, NS, SOA)\n- **HTTP/HTTPS Checking**: Advanced response analysis with status codes, headers, and content\n- **Wordlist Support**: Built-in comprehensive wordlist with custom wordlist support\n- **Concurrent Processing**: Multi-threaded subdomain enumeration with configurable threads\n- **Multiple Output Formats**: Plain text, JSON, XML, and HTML report support\n- **Real-time Web Interface**: Modern web UI for live monitoring and scanning\n\n### Advanced Security Analysis\n- **Port Scanning**: Comprehensive port scanning with service detection\n- **SSL/TLS Analysis**: Certificate validation, expiration checks, and security grading\n- **Technology Detection**: Automatic detection of web technologies and frameworks\n- **Vulnerability Scanning**: Common web vulnerability detection and assessment\n- **Screenshot Capture**: Automatic screenshot capture for visual analysis\n- **Directory Brute-forcing**: Directory and file enumeration capabilities\n- **Risk Assessment**: Automated risk level calculation and confidence scoring\n\n### Professional Features\n- **Progress Tracking**: Real-time progress bars and statistics\n- **Rate Limiting**: Configurable rate limiting to avoid overwhelming targets\n- **Retry Logic**: Intelligent retry mechanisms for failed requests\n- **Error Handling**: Comprehensive error handling and logging\n- **Configuration Management**: YAML-based configuration with CLI overrides\n- **Docker Support**: Containerized deployment with Docker and Docker Compose\n- **CI/CD Pipeline**: Automated testing and deployment with GitHub Actions\n\n## 📦 Installation\n\n### Prerequisites\n\n- Go 1.21 or higher\n- Internet connection for DNS resolution\n- Chrome/Chromium for screenshot functionality (optional)\n\n### Quick Start\n\n```bash\ngit clone https://github.com/daghlar/fuckdomain.git\ncd fuckdomain\ngo mod tidy\ngo build -o subdomain-finder\n```\n\n### Docker Installation\n\n```bash\ngit clone https://github.com/daghlar/fuckdomain.git\ncd fuckdomain\ndocker-compose up --build\n```\n\n### Binary Download\n\nDownload pre-compiled binaries from the [Releases](https://github.com/daghlar/fuckdomain/releases) page.\n\n## 🎯 Usage\n\n### CLI Usage\n\n#### Basic Subdomain Enumeration\n```bash\n./subdomain-finder scan example.com\n```\n\n#### Advanced Security Scan\n```bash\n./subdomain-finder scan example.com --wordlist custom-wordlist.txt --threads 20 --timeout 10 --output results.txt --verbose --json\n```\n\n#### Web Interface\n```bash\n./subdomain-finder web --port 8080\n```\nThen open http://localhost:8080 in your browser\n\n### Command Line Options\n\n#### Scan Command\n- `--domain`: Target domain to find subdomains for (required)\n- `--wordlist`: Path to custom wordlist file (default: wordlists/common.txt)\n- `--threads`: Number of concurrent threads (default: 10)\n- `--timeout`: Timeout in seconds for DNS/HTTP requests (default: 5)\n- `--output`: Output file to save results (optional)\n- `--verbose`: Enable verbose output (default: false)\n- `--json`: Save results as JSON format (default: false)\n- `--xml`: Save results as XML format (default: false)\n- `--progress`: Show progress bar (default: true)\n- `--stats`: Show detailed statistics (default: false)\n- `--no-color`: Disable colored output (default: false)\n- `--user-agent`: Custom User-Agent string\n- `--headers`: Custom HTTP headers (format: \"Header:Value\")\n- `--retries`: Number of retries for failed requests (default: 3)\n- `--delay`: Delay between requests in milliseconds (default: 100)\n- `--rate-limit`: Maximum requests per second (default: 10)\n\n#### Web Command\n- `--port`: Web interface port (default: 8080)\n- `--host`: Web interface host (default: localhost)\n\n#### Config Command\n- `--init`: Initialize configuration file\n- `--show`: Show current configuration\n\n## 📋 Examples\n\n### Basic Subdomain Enumeration\n```bash\n./subdomain-finder scan google.com\n```\n\n### Using Custom Wordlist\n```bash\n./subdomain-finder scan example.com --wordlist /path/to/wordlist.txt\n```\n\n### High Performance Security Scan\n```bash\n./subdomain-finder scan example.com --threads 50 --timeout 3 --verbose --stats\n```\n\n### Save Results in Multiple Formats\n```bash\n./subdomain-finder scan example.com --output results.txt --json --xml\n```\n\n### Web Interface with Custom Port\n```bash\n./subdomain-finder web --port 9090\n```\n\n### Comprehensive Security Analysis\n```bash\n./subdomain-finder scan target.com --threads 20 --timeout 10 --verbose --json --stats --progress\n```\n\n### Docker Deployment\n```bash\ndocker-compose up -d\n# Web interface available at http://localhost:8080\n```\n\n## 🏗️ Project Structure\n\n```\nfuckdomain/\n├── main.go                    # Main entry point\n├── go.mod                     # Go module file\n├── go.sum                     # Go module checksums\n├── Dockerfile                 # Docker container definition\n├── docker-compose.yml         # Multi-container setup\n├── Makefile                   # Build automation\n├── .github/workflows/         # CI/CD pipeline\n├── cmd/                       # CLI commands\n│   ├── root.go               # Root command\n│   ├── scan.go               # Scan command\n│   ├── web.go                # Web interface command\n│   └── config.go             # Configuration command\n├── internal/                  # Internal modules\n│   ├── finder/               # Main orchestration\n│   ├── dns/                  # DNS resolution\n│   ├── http/                 # HTTP/HTTPS checking\n│   ├── portscanner/          # Port scanning\n│   ├── ssl/                  # SSL/TLS analysis\n│   ├── techdetect/           # Technology detection\n│   ├── vulnscanner/          # Vulnerability scanning\n│   ├── screenshot/           # Screenshot capture\n│   ├── bruteforce/           # Directory brute-forcing\n│   ├── wordlist/             # Wordlist management\n│   ├── output/               # Output formatting\n│   ├── reporter/             # Report generation\n│   ├── web/                  # Web interface\n│   ├── types/                # Data structures\n│   ├── config/               # Configuration management\n│   ├── logger/               # Logging system\n│   ├── limiter/              # Rate limiting\n│   ├── progress/             # Progress tracking\n│   └── errors/               # Error handling\n├── wordlists/                 # Wordlist files\n│   └── common.txt            # Default wordlist\n└── README.md                 # This file\n```\n\n## 🔧 Modules\n\n### Core Modules\n- **Finder**: Main orchestration logic, coordinates all modules\n- **DNS**: A, CNAME, MX, TXT, NS, SOA record resolution\n- **HTTP**: HTTP/HTTPS response checking, status codes, headers\n- **Wordlist**: Built-in and custom wordlist management\n\n### Security Analysis Modules\n- **Port Scanner**: Comprehensive port scanning with service detection\n- **SSL Analyzer**: Certificate validation, expiration checks, security grading\n- **Tech Detector**: Automatic technology and framework detection\n- **Vuln Scanner**: Common web vulnerability detection and assessment\n\n### Advanced Modules\n- **Screenshot**: Automatic screenshot capture for visual analysis\n- **Brute Force**: Directory and file enumeration capabilities\n- **Reporter**: HTML, PDF, and other format report generation\n- **Web Interface**: Real-time web UI for monitoring and scanning\n\n### Utility Modules\n- **Output**: Colored terminal output, multiple file formats\n- **Config**: YAML-based configuration management\n- **Logger**: Structured logging with multiple levels\n- **Limiter**: Rate limiting and retry mechanisms\n- **Progress**: Real-time progress bars and statistics\n- **Types**: Comprehensive data structures and types\n\n## 📦 Dependencies\n\n### Core Dependencies\n- `github.com/spf13/cobra`: CLI framework\n- `github.com/spf13/viper`: Configuration management\n- `github.com/sirupsen/logrus`: Structured logging\n- `github.com/miekg/dns`: DNS client library\n- `github.com/fatih/color`: Terminal color output\n\n### Security \u0026 Analysis\n- `github.com/chromedp/chromedp`: Screenshot capture\n- `crypto/tls`: SSL/TLS analysis\n- `crypto/x509`: Certificate parsing\n\n### Utilities\n- `github.com/cheggaaa/pb/v3`: Progress bars\n- `github.com/go-playground/validator/v10`: Input validation\n- `gopkg.in/yaml.v3`: YAML configuration\n- `github.com/gobwas/ws`: WebSocket support\n\n## 🚀 Quick Start\n\n1. **Clone the repository**:\n   ```bash\n   git clone https://github.com/daghlar/fuckdomain.git\n   cd fuckdomain\n   ```\n\n2. **Build the tool**:\n   ```bash\n   go mod tidy\n   go build -o subdomain-finder\n   ```\n\n3. **Run a basic scan**:\n   ```bash\n   ./subdomain-finder scan example.com\n   ```\n\n4. **Start web interface**:\n   ```bash\n   ./subdomain-finder web\n   # Open http://localhost:8080\n   ```\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Make your changes\n4. Add tests if applicable\n5. Commit your changes (`git commit -m 'Add amazing feature'`)\n6. Push to the branch (`git push origin feature/amazing-feature`)\n7. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## ⚠️ Disclaimer\n\nThis tool is for **educational and authorized testing purposes only**. Always ensure you have explicit permission to test the target domain before using this tool. Unauthorized scanning may violate laws and terms of service.\n\n## 🆘 Support\n\n- **Issues**: [GitHub Issues](https://github.com/daghlar/fuckdomain/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/daghlar/fuckdomain/discussions)\n- **Documentation**: [Wiki](https://github.com/daghlar/fuckdomain/wiki)\n\n## 🌟 Features Roadmap\n\n- [ ] Database integration for result storage\n- [ ] REST API endpoints\n- [ ] Email/Slack notifications\n- [ ] Performance optimizations\n- [ ] Additional vulnerability checks\n- [ ] Machine learning-based subdomain prediction\n- [ ] Integration with popular security tools\n\n---\n\n**Made with ❤️ by [daghlar](https://github.com/daghlar)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaghlar%2Ffuckdomain","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaghlar%2Ffuckdomain","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaghlar%2Ffuckdomain/lists"}