dumbwareio/dumbwhois repository overview

⁠DumbWhois

A simple web application for looking up WHOIS, IP, and ASN information using free APIs. The application automatically detects the type of query and provides formatted results with a clean, modern UI that supports both light and dark modes.

⁠Features

• 🔍 Automatic detection of query type (Domain, IP, or ASN)
• 🌐 Direct WHOIS domain lookup with support for all TLDs
• 🌍 IP geolocation with multiple fallback services
• 🔢 ASN (Autonomous System Number) details
• 🎨 Clean and modern UI with dark mode support
• 📱 Responsive design for mobile and desktop
• 🚫 No authentication required
• ⚙️ Environment variable configuration
• 🔄 Automatic service fallback for IP lookups
• 🌐 Full IPv6 support
• 📋 Clear source attribution for all lookups
• 🔍 DNS resolution for domain IP addresses
• 🔗 URL query parameter support for direct lookups
• 🔖 Permalink anchors for sharing specific result sections
• 🔒 CORS support for cross-origin requests
• 🌐 PWA Support

⁠APIs Used

The application uses the following free services:

• WHOIS Lookup: Direct WHOIS protocol

  • Native WHOIS queries to authoritative servers
  • Support for all TLDs including ccTLDs
  • DNS resolution for IPv4 and IPv6 addresses
  • No API key required
  • No rate limits

• IP Lookup: Multiple services with automatic fallback

  1. ipapi.co⁠
     • Primary service for IP geolocation
     • Free tier with rate limits
     • No API key required
  2. ip-api.com⁠
     • First fallback service
     • Free for non-commercial use
     • No API key required
  3. ipwho.is⁠
     • Second fallback service
     • Free with no rate limits
     • No API key required

• ASN Lookup: BGPView API⁠

  • Provides ASN details and related information
  • Free to use
  • No authentication required

⁠Setup

⁠Standard Setup

1. Clone the repository:

git clone https://github.com/dumbwareio/dumbwhois.git
cd dumbwhois

1. Install dependencies:

npm install

1. Configure environment variables:

cp .env.example .env
# Edit .env to set your desired port (default is 3000)

1. Start the server:

npm start

For development with auto-reload:

npm run dev

⁠Docker Setup

1. Build the Docker image:

docker build -t dumbwhois .

1. Run the container:

docker run -p 3000:3000 -d dumbwhois

Or using Docker Compose:

docker-compose up -d

docker-compose.yml:

services:
   dumbwhois:
      image: dumbwareio/dumbwhois:latest
      container_name: dumbwhois
      restart: unless-stopped
      ports:
      - ${DUMBWHOIS_PORT:-3000}:3000
      environment:
      - SITE_TITLE=${DUMBWHOIS_SITE_TITLE:-DumbWhois}
      # (Optional) Restrict origins - ex: https://subdomain.domain.tld,https://auth.proxy.tld,http://internalip:port' (empty/default is '*')
      # - ALLOWED_ORIGINS=${DUMBWHOIS_ALLOWED_ORIGINS:-*}

⁠Usage

1. Visit http://localhost:3000 in your browser
2. Enter any of the following:
   • Domain name (e.g., yahoo.com, europa.eu)
   • IP address (IPv4 or IPv6, e.g., 8.8.8.8, 2001:4860:4860::8888)
   • ASN number (e.g., AS13335 or just 13335)
3. The application will automatically detect the type of query and display formatted results
4. Toggle between light and dark modes using the moon icon in the top-right corner

You can also perform direct lookups by using the lookup query parameter in the URL:

• Domain lookup: http://localhost:3000/?lookup=google.com
• IP lookup: http://localhost:3000/?lookup=8.8.8.8
• ASN lookup: http://localhost:3000/?lookup=AS13335

⁠Permalink Anchors

Each section of the results now has a permalink anchor that allows direct linking to specific information:

• Click the link icon (🔗) next to any section header to copy a direct link to that section
• Share links to specific sections, like nameservers or IP addresses: http://localhost:3000/?lookup=google.com#nameservers
• When following a permalink, the page will automatically scroll to the relevant section
• Sections are briefly highlighted when accessed via permalink for better visibility

⁠Example Queries

• Domain Lookup: google.com, europa.eu, bbc.co.uk
• IPv4 Lookup: 8.8.8.8, 1.1.1.1, 140.82.121.4
• IPv6 Lookup: 2001:4860:4860::8888, 2606:4700:4700::1111
• ASN Lookup: AS13335, AS15169, AS8075

⁠Rate Limits

Please note that some APIs used have rate limits:

• WHOIS: No rate limits (uses direct protocol)
• ipapi.co: 1000 requests per day (free tier)
• ip-api.com: 45 requests per minute
• ipwho.is: No rate limits
• BGPView: unknown rate limit waiting for reply.

The application automatically handles rate limits by falling back to alternative services when needed.

⁠Contributing

Contributions are welcome! Please feel free to submit a Pull Request.