dumbwareio/dumbwhois

DumbWhois

一个用于查询WHOIS、IP和ASN信息的简单Web应用，使用免费API。该应用自动检测查询类型，并提供格式化结果，具有简洁现代的UI，支持明暗两种模式。

!https://github.com/user-attachments/assets/a4f84c05-c8f8-4e75-9788-dc70adc2ad9b

核心功能和特性

• 🔍 自动检测查询类型（域名、IP或ASN）
• 🌐 直接WHOIS域名查询，支持所有顶级域名
• 🌐 IP地理定位，带有多个备用服务
• 🔢 ASN（自治系统编号）详细信息
• 🎨 简洁现代的UI，支持深色模式
• 📱 响应式设计，适配移动设备和桌面端
• 🚫 无需认证
• ⚙️ 环境变量配置
• 🔄 IP查询的自动服务回退
• 🌐 完整IPv6支持
• 📋 所有查询的明确来源归属
• 🔍 域名IP地址的DNS解析
• 🔗 URL查询参数支持直接查询
• 🔖 用于分享特定结果部分的永久链接锚点
• 🔒 跨域请求的CORS支持
• 🌐 PWA支持

使用的API

该应用使用以下免费服务：

WHOIS查询

• 直接WHOIS协议
  • 对权威服务器的原生WHOIS查询
  • 支持所有顶级域名，包括国家代码顶级域名
  • IPv4和IPv6地址的DNS解析
  • 无需API密钥
  • 无速率限制

IP查询

• 多个服务，自动回退
  1. ipapi.co
     • IP地理定位的主要服务
     • 免费 tier 有速率限制
     • 无需API密钥
  2. ip-api.com
     • 第一个备用服务
     • 非商业用途免费
     • 无需API密钥
  3. ipwho.is
     • 第二个备用服务
     • 免费，无速率限制
     • 无需API密钥

ASN查询

• BGPView API
  • 提供ASN详情及相关信息
  • 免费使用
  • 无需认证

使用场景和适用范围

适用于需要快速查询域名WHOIS信息、IP地理定位或ASN详情的用户，无需注册或认证，适合个人、开发者或小型团队使用。支持移动和桌面设备，可通过URL直接分享查询结果，适合需要快速获取网络信息的场景。

使用方法和配置说明

标准设置

1. 克隆仓库：

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

2. 安装依赖：

bash
npm install

3. 配置环境变量：

bash
cp .env.example .env
# 编辑.env设置所需端口（默认3000）

4. 启动服务器：

bash
npm start

开发环境（自动重载）：

bash
npm run dev

Docker设置

1. 构建Docker镜像：

bash
docker build -t dumbwhois .

2. 运行容器：

bash
docker run -p 3000:3000 -d dumbwhois

或使用Docker Compose：

bash
docker-compose up -d

docker-compose.yml配置示例：

yaml
services:
   dumbwhois:
      image: dumbwareio/dumbwhois:latest
      container_name: dumbwhois
      restart: unless-stopped
      ports:
      - ${DUMBWHOIS_PORT:-3000}:3000
      environment:
      - SITE_TITLE=${DUMBWHOIS_SITE_TITLE:-DumbWhois}
      # （可选）限制来源 - 例如：https://subdomain.domain.tld,https://auth.proxy.tld,http://internalip:port'（空值/默认是'*'）
      # - ALLOWED_ORIGINS=${DUMBWHOIS_ALLOWED_ORIGINS:-*}

使用说明

1. 在浏览器中访问 http://localhost:3000
2. 输入以下任意内容：
   • 域名（例如：yahoo.com、europa.eu）
   • IP地址（IPv4或IPv6，例如：8.8.8.8、2001:4860:4860::8888）
   • ASN编号（例如：AS13335 或仅 13335）
3. 应用将自动检测查询类型并显示格式化结果
4. 使用右上角的月亮图标切换明暗模式

直接查询链接

可通过URL查询参数进行直接查询：

• 域名查询：http://localhost:3000/?lookup=google.com
• IP查询：http://localhost:3000/?lookup=8.8.8.8
• ASN查询：http://localhost:3000/?lookup=AS13335

永久链接锚点

结果的每个部分都有永久链接锚点：

• 点击任何部分标题旁的链接图标（🔗）复制该部分的直接链接
• 分享特定部分的链接，如名称服务器或IP地址：http://localhost:3000/?lookup=google.com#nameservers
• 访问永久链接时，页面将自动滚动到相关部分
• 通过永久链接访问时，部分会短暂高亮以提高可见性

示例查询

• 域名查询：google.com、europa.eu、bbc.co.uk
• IPv4查询：8.8.8.8、1.1.1.1、140.82.121.4
• IPv6查询：2001:4860:4860::8888、2606:4700:4700::1111
• ASN查询：AS13335、AS15169、AS8075

速率限制

使用的部分API有速率限制：

• WHOIS查询：无速率限制（使用直接协议）
• ipapi.co：每天1000次请求（免费 tier）
• ip-api.com：每分钟45次请求
• ipwho.is：无速率限制
• BGPView：速率限制未知，等待回复

应用通过在需要时回退到替代服务来自动处理速率限制。

贡献

欢迎贡献！请随时提交Pull Request。