
├── api/                 # 后端API目录
│   ├── utils/           # 工具类
│   │   ├── rate_limit_storage.json  # 速率限制存储
│   │   ├── rate_limiter.php         # 速率限制器
│   │   ├── ssl.php                  # SSL检查工具
│   │   ├── validator.php            # 域名验证器
│   │   └── whois.php                # WHOIS查询工具
│   └── api.php          # 主API文件
├── src/                 # 前端源代码
│   ├── components/      # Vue组件
│   │   ├── SSLResult.vue            # SSL结果显示组件
│   │   ├── SearchComponent.vue      # 搜索组件
│   │   └── WhoisResult.vue          # WHOIS结果显示组件
│   ├── composables/     # 可复用的组合式函数
│   │   └── useApi.js                # API调用逻辑
│   ├── styles/          # 样式文件
│   │   └── App.css                  # 应用样式
│   ├── App.vue          # 主应用组件
│   ├── main.js          # 应用入口
│   └── style.css        # 全局样式
├── README.md            # 项目文档
├── index.html           # 前端入口HTML
├── package.json         # 前端依赖配置
└── vite.config.js       # Vite配置文件

安装指南

前置要求

Web服务器：Apache 2.4+ 或 Nginx
PHP：7.4+
Node.js：16.0+
npm：7.0+

安装步骤

克隆项目


git clone https://cnb.cool/bugcool/DomainGuardian.git
cd DomainGuardian

安装前端依赖
```
npm install
```
构建前端项目
```
npm run build
```
配置Web服务器
- Apache：确保启用了 mod_rewrite 和 mod_headers 模块
- Nginx：配置适当的 location 规则
配置API路径
- 确保前端可以访问 /api/api.php 路径
- 如果需要修改API路径，请更新 src/composables/useApi.js 中的API调用路径

设置权限


chmod 755 api/utils/rate_limit_storage.json

启动服务
- 前端开发服务器：npm run dev
- 生产环境：将 dist 目录部署到Web服务器

使用说明

基本使用

在搜索框中输入域名（例如：example.com）
点击"开始查询"按钮
等待查询结果（通常需要1-3秒）
查看WHOIS信息和SSL证书信息

示例

查询域名信息

输入：github.com
结果：显示GitHub域名的注册信息、过期时间等

检查SSL证书

输入：google.com
结果：显示Google的SSL证书信息、颁发机构、有效期等

API文档

WHOIS查询API

请求URL：/api/api.php?domain={domain}

请求方法：GET

参数：

domain：要查询的域名（必需）

响应格式：JSON

响应示例：


{
  "status": 1,
  "is_available": 0,
  "domain": "example.com",
  "domain_suffix": "com",
  "query_time": "2026-01-20 12:00:00",
  "query_time_utc": "2026-01-20 04:00:00",
  "timezone": "UTC",
  "registrant_name": "Example Inc.",
  "registrant_email": "admin@example.com",
  "registrar_name": "GoDaddy.com, LLC",
  "creation_time": "2020-01-01 00:00:00",
  "expiration_time": "2027-01-01 00:00:00",
  "creation_days": 2147,
  "valid_days": 365,
  "is_expire": 0,
  "domain_status": "clientTransferProhibited https://icann.org/epp#clientTransferProhibited",
  "name_server": [
    "ns1.example.com",
    "ns2.example.com"
  ],
  "whois_server": "whois.verisign-grs.com",
  "raw": "Domain Name: EXAMPLE.COM...",
  "time_info": {
    "creation_timestamp": 1577836800,
    "expiration_timestamp": 1798761600,
    "days_since_creation": 2147,
    "days_until_expiration": 365,
    "expiration_status": "valid",
    "timezone": "UTC",
    "local_time": "2026-01-20 12:00:00",
    "utc_time": "2026-01-20 04:00:00"
  }
}

SSL检查API

请求URL：/api/api.php?domain={domain}&ssl=1

请求方法：GET

参数：

domain：要检查的域名（必需）
ssl：设置为1表示SSL检查（必需）

响应格式：JSON

响应示例：


{
  "status": 1,
  "domain": "example.com",
  "ssl": {
    "valid": true,
    "subject": {
      "CN": "example.com",
      "O": "Example Inc.",
      "L": "City",
      "ST": "State",
      "C": "US"
    },
    "issuer": {
      "CN": "DigiCert SHA2 Secure Server CA",
      "O": "DigiCert Inc",
      "C": "US"
    },
    "valid_from": "2025-01-01T00:00:00+00:00",
    "valid_to": "2026-01-01T23:59:59+00:00",
    "valid_days": 365,
    "algorithm": "RSA-SHA256",
    "key_length": 2048,
    "serial_number": "1234567890ABCDEF1234567890ABCDEF",
    "san": [
      "example.com",
      "www.example.com"
    ]
  }
}