Skip to content

zmh-program/next-whois

Repository files navigation

Next Whois

Next Whois

A fast, modern WHOIS/RDAP lookup tool built with Next.js.

English · 简体中文 · 繁體中文 · Русский · 日本語 · Deutsch · Français · 한국어

Deploy to Vercel Deploy to Netlify

Banner

Features

  • WHOIS & RDAP - Domain, IPv4, IPv6, ASN, CIDR lookup with RDAP-first, WHOIS fallback
  • Dynamic OG Images - Satori-based Open Graph image generation via /api/og
  • Responsive UI - Shadcn UI + Tailwind CSS, works across mobile, tablet, and desktop. PWA support.
  • Dark / Light Theme - System detection with manual toggle
  • History & Shortcuts - Local history with search, filter, and keyboard shortcuts
  • EPP Status Codes - Human-readable status descriptions with ICANN references
  • Registrar & NS Branding - Auto-detected icons for major registrars and nameserver providers
  • Domain Metrics - Moz DA/PA/Spam Score integration (optional)
  • Redis Caching - Server-side result caching with Cache-Control headers
  • Open API - /api/lookup for programmatic access, /api/og for image generation
  • i18n - English, Chinese (Simplified/Traditional), German, Russian, Japanese, French, Korean
  • API Documentation - Built-in /docs page with interactive examples

Community Forks

See great work from brilliant builders extending this project:

Deploy

Platforms (Recommended)

Vercel / Netlify / Zeabur

Docker

docker run -d -p 3000:3000 programzmh/next-whois-ui

Source Code

git clone https://github.com/zmh-program/next-whois-ui
cd next-whois-ui
pnpm install
pnpm dev

Environment Variables

Variable Description Default
NEXT_PUBLIC_SITE_TITLE Site title Next Whois
NEXT_PUBLIC_SITE_DESCRIPTION Site description
NEXT_PUBLIC_SITE_KEYWORDS Site keywords
NEXT_PUBLIC_HISTORY_LIMIT Max history items (-1 = unlimited) -1
NEXT_PUBLIC_MAX_WHOIS_FOLLOW Max domain WHOIS follow depth 0
MOZ_ACCESS_ID Moz API Access ID
MOZ_SECRET_KEY Moz API Secret Key
REDIS_HOST Redis host (empty = cache disabled)
REDIS_PORT Redis port 6379
REDIS_PASSWORD Redis password
REDIS_DB Redis database index 0
REDIS_CACHE_TTL Cache TTL in seconds 3600

API

See the built-in API Documentation page, or:

GET /api/lookup?query=google.com — WHOIS/RDAP lookup (parallel, merged results, includes raw responses)

GET /api/og?query=google.com — Dynamic OG image generation

Tech Stack

  • Next.js 14 (Pages Router, Edge Runtime for OG)
  • Whoiser + RDAP client
  • Satori (via next/og) for image generation

About

🧪 Your Next-Gen Whois Lookup Tool With Modern UI. Support Domain/IPv4/IPv6/ASN/CIDR Whois Lookup And Powerful Features. Support RDAP protocol.

Topics

Resources

License

Stars

Watchers

Forks

Contributors