39 lines
1.1 KiB
Markdown
39 lines
1.1 KiB
Markdown
# DNS Global
|
||
|
||
无需注册的轻量 DNS 传播检查工具。React 前端通过 SSE 实时展示 Go API 并行查询 Cloudflare、Google、AdGuard 和 AliDNS 的结果。
|
||
|
||
> 当前节点是公共 DNS 服务商的 Anycast 解析器，只能反映不同服务商的缓存差异，不代表真实地理位置。生产版可将后端 `nodes` 替换为各区域自建探针。
|
||
|
||
## 快速启动
|
||
|
||
```bash
|
||
docker compose up --build
|
||
```
|
||
|
||
打开 <http://localhost:8080>。停止服务：
|
||
|
||
```bash
|
||
docker compose down
|
||
```
|
||
|
||
## API
|
||
|
||
```bash
|
||
curl -X POST http://localhost:8080/api/dns/query \
|
||
-H 'Content-Type: application/json' \
|
||
-d '{"domain":"example.com","type":"A"}'
|
||
```
|
||
|
||
随后连接返回的查询 ID：`GET /api/dns/query/{queryId}/events`。
|
||
|
||
支持 `A`、`AAAA`、`CNAME`、`MX`、`NS`、`TXT`、`SOA` 和 `CAA`。输入 URL 时会自动提取域名。查询任务仅在内存保留五分钟；POST 接口按来源 IP 限制为每分钟 30 次。
|
||
|
||
## 验证
|
||
|
||
```bash
|
||
docker build -t dnsquery:test .
|
||
docker compose up -d
|
||
curl --fail http://localhost:8080/healthz
|
||
docker compose down
|
||
```
|