Skip to content

Latest commit

 

History

History
178 lines (137 loc) · 5.12 KB

README_TW.md

File metadata and controls

178 lines (137 loc) · 5.12 KB

🧪 Next Whois UI

😎 現代代 Whois 查詢工具

English · 簡體中文 · 繁體中文

Deploy to Vercel

Deploy to Netlify

😎 特性

無需多言，直接試試吧！🥳

  1. ✨ 美觀界麵：採用現代簡約設計的 Shadcn UI 風格。
  2. 📱 響應式設計：適配手機端✅ / Pad✅ / 桌麵端✅，並支持 PWA 應用。
  3. 🌈 多主題支持：支持亮/暗色切換，自動檢測繫統主題。
  4. 🚀 靈活查詢：基於 Next.js，支持無服務器部署，更快查詢速度。
  5. 📚 曆史記錄：曆史記錄存儲在本地存儲中，方便查看和查詢曆史。
  6. 📡 開放接口：提供簡單的 whois 查詢 API，易於與其他服務集成。
  7. 🌍 強大支持：支持 IPv4、IPv6、域名、ASN、CIDR 的 Whois 查詢。
  8. 📦 結果分享：支持獲取 Whois 查詢結果，方便分享和保存。
  9. 📡 結果緩存：支持基於 Redis 的 Whois 緩存，提昇查詢速度。
  10. 🌍 [計劃] 國際化：支持多語言 (#6)

👉 貢獻代碼

部署

1 🚀 雲平颱部署（推薦）

Vercel / Netlify / Zeabur

2 🐳 Docker 部署

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

3 🔨 源碼部署

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

npm install -g pnpm
pnpm install
pnpm dev

📏 環境變量

SEO

  • NEXT_PUBLIC_SITE_TITLE: 站點標題
  • NEXT_PUBLIC_SITE_DESCRIPTION: 站點描述
  • NEXT_PUBLIC_SITE_KEYWORDS: 站點關鍵詞

WHOIS

  • NEXT_PUBLIC_HISTORY_LIMIT: 曆史記錄限製（默認值：6）
  • NEXT_PUBLIC_MAX_WHOIS_FOLLOW: 最大域名 Whois 跟隨數（默認值：0）
  • NEXT_PUBLIC_MAX_IP_WHOIS_FOLLOW: 最大 IP Whois 跟隨數（默認值：5）

緩存

  • REDIS_HOST: Redis 主機（如果爲空則禁用緩存）
  • REDIS_PORT: Redis 端口（默認值：6379）
  • REDIS_PASSWORD: Redis 密碼（可選）
  • REDIS_DB: Redis 數據庫（默認值：0）
  • REDIS_CACHE_TTL: Redis 緩存 TTL 秒數（默認值：3600）

📝 API 文檔

GET /api/lookup?query=google.com

響應 OK (200) 
{
  "time": 1.547,
  "status": true,
  "cached": false,
  "result": {
    "domain": "GOOGLE.COM",
    "registrar": "MarkMonitor Inc.",
    "registrarURL": "http://www.markmonitor.com",
    "ianaId": "292",
    "whoisServer": "whois.markmonitor.com",
    "updatedDate": "2019-09-09T15:39:04.000Z",
    "creationDate": "1997-09-15T04:00:00.000Z",
    "expirationDate": "2028-09-14T04:00:00.000Z",
    "status": [
      {
        "status": "clientDeleteProhibited",
        "url": "https://icann.org/epp#clientDeleteProhibited"
      },
      {
        "status": "clientTransferProhibited",
        "url": "https://icann.org/epp#clientTransferProhibited"
      },
      {
        "status": "clientUpdateProhibited",
        "url": "https://icann.org/epp#clientUpdateProhibited"
      },
      {
        "status": "serverDeleteProhibited",
        "url": "https://icann.org/epp#serverDeleteProhibited"
      },
      {
        "status": "serverTransferProhibited",
        "url": "https://icann.org/epp#serverTransferProhibited"
      },
      {
        "status": "serverUpdateProhibited",
        "url": "https://icann.org/epp#serverUpdateProhibited"
      }
    ],
    "nameServers": [
      "NS1.GOOGLE.COM",
      "NS2.GOOGLE.COM",
      "NS3.GOOGLE.COM",
      "NS4.GOOGLE.COM"
    ],
    "registrantOrganization": "Unknown",
    "registrantProvince": "Unknown",
    "registrantCountry": "Unknown",
    "registrantPhone": "+1 2086851750",
    "registrantEmail": "Unknown",
    "rawWhoisContent": "..."
  }
}
錯誤響應 Internal Server Error (500) 
{
  "time": 0.609,
  "status": false,
  "error": "No match for domain google.notfound (e.g. domain is not registered)"
}
錯誤響應 Bad Request (400) 
{
  "time": -1,
  "status": false,
  "error": "Query is required"
}

🧠 技術棧

  • Next.js
  • Shadcn UI & Tailwind CSS
  • Whois Core Lib (@whois-raw)

💪 TLDs 支持

👉 TLDs Whois 解析器庫源碼

❤ 提示: 部分 TLDs 的 Whois 解析器可能暫不兼容，感謝您提交 貢獻 以便支持更多 TLDs！