WHOIS domain lookup

A simple WHOIS domain lookup website with strong TLD compatibility.

简体中文 README

Live Demo

Features

• Simple, Clear UI
• Strong TLD compatibility, including most ccTLDs and a few private domains
• WHOIS and RDAP support
• Display prices, age, remaining days, and other information
• Highlight url and email in raw data
• API support
• Access control

Deployment

Vercel

Docker Compose

Deploy

mkdir whois-domain-lookup
cd whois-domain-lookup
wget https://raw.githubusercontent.com/reg233/whois-domain-lookup/main/docker-compose.yml
docker compose up -d

Update

docker compose down
docker compose pull
docker compose up -d

Web Hosting

Requirements:

• PHP >= 8.1

Download the release, unzip it, and then upload it to the root directory of your website.

Env Variables

Key	Description	Example	Default
DEFAULT_EXTENSION	The default extension when no extension is entered.	com
SITE_TITLE	Title of the website.	WHOIS lookup	WHOIS domain lookup
SITE_SHORT_TITLE	Short title of the website, used for the mobile home screen.	RDAP	WHOIS
SITE_DESCRIPTION	Description of the website, used for SEO	A simple WHOIS domain lookup website.	A simple WHOIS domain lookup website with strong TLD compatibility.
SITE_KEYWORDS	Keywords of the website, used for SEO	whois, rdap, domain lookup	whois, rdap, domain lookup, open source, api, tld, cctld, .com, .net, .org
SITE_PASSWORD	Password of the website, used for access control	233
BASE	The href attribute of the base tag in the HTML.	/whois/	/
CUSTOM_HEAD	Custom content to insert before </head> on the home page (e.g., styles or meta tags).	<style>h1{color:red}</style>
CUSTOM_SCRIPT	Custom content to insert before </body> on the home page (e.g., JS scripts).	<script>alert('Welcome')</script>
CUSTOM_HEAD_LOGIN	Custom content to insert before </head> on the login page (e.g., styles or meta tags).	<style>h1{color:red}</style>
CUSTOM_SCRIPT_LOGIN	Custom content to insert before </body> on the login page (e.g., JS scripts).	<script>alert('Welcome')</script>
HOSTED_ON	Name of the hosting platform, displayed at the bottom of the page.	Serv00
HOSTED_ON_URL	URL of the hosting platform, used together with HOSTED_ON .	https://serv00.com

If you deploy using web hosting, you should modify the config/config.php file, like this:

<?php
define("DEFAULT_EXTENSION", getenv("DEFAULT_EXTENSION") ?: "com");

...

API

URL: https://whois.233333.best/api/

Params: domain , whois , rdap , whois-server , rdap-server

Method: GET

Example 1: https://whois.233333.best/api/?domain=233333.best

Example 2: https://whois.233333.best/api/?domain=233333.best&whois=1

Example 3: https://whois.233333.best/api/?domain=233333.best&rdap=1

Example 4: https://whois.233333.best/api/?domain=233333.best&whois-server=whois.spaceship.com

Example 5: https://whois.233333.best/api/?domain=233333.best&rdap-server=https://rdap.spaceship.com/

If you have set a SITE_PASSWORD , you need to add Authorization in the request headers, like this:

Authorization: Bearer <SHA256(SITE_PASSWORD)>

Example: Authorization: Bearer c0509a487a18b003ba05e505419ebb63e57a29158073e381f57160b5c5b86426

SHA256 online tool

TODO

• Improve reserved domain detection

Thanks

• Gandi
• tian.hu

Collaboration

If you know the missing WHOIS or RDAP server addresses for this project, feel free to collaborate with us!

If you encounter any issues, feel free to open a new issue.