CF-workers-netdiag

KO | EN

gitlite — search

#javascript #typescript #llm #go #android #rust #deep-learning #linux #cli #kubernetes #vue #awesome-list #ios #open-source

CF-workers-netdiag

(★ 14)

Cloudflare Workers 实现 IP 地址检测与地区验证的工具

CF-workers-netdiag Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# NetSight Pro

[![AGPL-3.0 License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](https://github.com/BlueDriftHK/CF-workers-netdiag/blob/main/LICENSE)
[![Cloudflare Workers](https://img.shields.io/badge/Cloudflare-Workers-F38020?logo=cloudflare)](https://workers.cloudflare.com/)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/BlueDriftHK/CF-workers-netdiag/pulls)
[![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/BlueDriftHK/CF-workers-netdiag)

> 部署在 Cloudflare Workers 边缘节点的专业级网络诊断工具
> **实时监控 · 多维度测试 · 毫秒级响应 · 极光玻璃拟态设计 · 企业级安全防护**

**版本**: 4.2 | **许可证**: AGPL-3.0 | **最后更新**: 2026-07-25

---

## 目录

- [功能特性](#功能特性)
- [界面预览](#界面预览)
- [快速开始](#快速开始)
- [API 端点](#api-端点)
- [命令行测试](#命令行测试)
- [配置说明](#配置说明)
- [技术架构](#技术架构)
- [项目结构](#项目结构)
- [安全策略](#安全策略)
- [更新日志](#更新日志)
- [常见问题](#常见问题)
- [故障排查](#故障排查)
- [许可证](#许可证)

---

## 功能特性

### 网络质量检测

### 性能测试工具

### 测速历史与用量统计

- **测速历史记录**：自动保存最近 5 条测速结果到 Cloudflare KV
- **用量统计面板**：可视化展示 API 端点调用统计（Top 8）
- **历史趋势**：通过 `/api/speed-history` 获取最近测速记录

### 安全与协议检测

- **TLS 版本检测**：识别 TLS 1.0/1.1/1.2/1.3
- **加密套件分析**：查看协商的加密算法
- **ECH 状态检测**：检测 Encrypted Client Hello 支持
- **压缩算法检测**：Brotli / Gzip / Deflate / Zstd
- **HTTP/2/3 检测**：识别协议版本和 Early Hints 支持
- **ALPN 协商**：查看应用层协议协商结果
- **IP 欺诈评分**：调用 Scamalytics API 评估代理/VPN/Tor/托管风险

### 地理位置追踪

- 边缘节点位置（城市/坐标/ASN/运营商）
- 客户端真实地理位置（通过 ipapi.co）
- 客户端与边缘节点距离计算（公里）

### 极光玻璃拟态设计（v4.2 全新 UI）

- **极光渐变背景**：深空黑底色 + 流动绿/紫/青色带，`@keyframes auroraShift` 缓动动画
- **玻璃拟态卡片**：`backdrop-filter: blur(24px) saturate(150%)`，半透明磨砂质感，indigo 色调点缀
- **双主题支持**：深色（默认）/ 浅色 / 自动跟随系统，`[data-theme="light"]` 一键切换
- **响应式布局**：桌面端（>1024px）多列网格 → 平板（768–1024px）部分折叠 → 手机（<480px）单列瀑布流
- **信息层级重构**：安全信息全宽双列内部网格、地理卡片桌面端并排、硬件信息紧凑横条
- **三语切换**：简体中文 / 繁体中文 / English 全界面覆盖
- **30+ CSS 自定义属性**：统一设计令牌，`--glass-bg`、`--glass-border`、`--accent` 等

---

## 界面预览

> 以下为模拟界面，实际部署后数据实时更新。

![主界面预览](https://via.placeholder.com/800x400?text=NetSight+Pro+Aurora+Dashboard)
*主仪表盘 – 极光背景 + 玻璃拟态卡片 + RTT 实时监控*

![多节点对比](https://via.placeholder.com/800x400?text=Multi-Node+Comparison)
*多节点对比弹窗与结果表格*

---

## 快速开始

### 前置条件

- Cloudflare 账号（免费版即可）
- 域名（可选，可使用 `workers.dev` 子域名）
- Node.js 18+ 和 npm（用于 Wrangler CLI）

### 方式一：Wrangler CLI 部署（推荐）

```bash
# 1. 安装 Wrangler CLI
npm install -g wrangler

# 2. 登录 Cloudflare
wrangler login

# 3. 克隆项目
git clone https://github.com/BlueDriftHK/CF-workers-netdiag.git
cd CF-workers-netdiag

# 4. 创建 KV 命名空间（用于测速历史）
wrangler kv:namespace create SPEED_HISTORY

# 5. 将返回的 KV ID 配置到 wrangler.toml
# 编辑 wrangler.toml，添加：
# kv_namespaces = [
#   { binding = "SPEED_HISTORY", id = "your-kv-namespace-id" }
# ]

# 6. 部署
wrangler deploy --main _workers.js
```

### 方式二：Cloudflare Dashboard 部署

1. 登录 [Cloudflare Dashboard](https://dash.cloudflare.com/)
2. 进入 **Workers & Pages** > **创建应用程序** > **创建 Worker**
3. 将 `_workers.js` 文件中的**完整代码**复制并粘贴到编辑器中
4. 在 Worker 设置中绑定 KV 命名空间 `SPEED_HISTORY`
5. 点击 **保存并部署**

### 方式三：一键部署

点击下方按钮，授权 GitHub 和 Cloudflare 后即可自动部署：

[![部署到 Cloudflare Workers](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/BlueDriftHK/CF-workers-netdiag)

---

## API 端点

所有接口均支持 CORS，方便集成到您自己的工具链中。

| 端点 | 方法 | 参数 | 参数限制 | 限流 | 描述 |
| :--- | :--- | :--- | :--- | :--- | :--- |
| `/` | GET | - | - | - | 主诊断页面（HTML） |
| `/health` | GET | - | - | - | 健康检查 |
| `/speedtest` | GET | `size` | ≤ 5MB | ✅ | 带宽测速 |
| `/cpu-test` | GET | `n` | ≤ 200 万 | ✅ (3/min) | CPU 性能基准测试 |
| `/ws-test` | WebSocket | - | - | ✅ | WebSocket 延迟测试 |
| `/http2-test` | GET | - | - | ✅ | HTTP/2/3 + Early Hints |
| `/concurrent-test` | GET | `count`, `size` | count≤16, size≤64KB | ✅ | 并发压力测试 |
| `/stream-test` | GET | `size` | ≤ 10MB | ✅ | 流式吞吐量测试 |
| `/api/log-speed` | POST | JSON body | - | ✅ | 保存测速记录到 KV |
| `/api/speed-history` | GET | `limit` | ≤ 100 | ✅ | 查询测速历史 |
| `/api/usage-stats` | GET | - | - | ✅ | 查询用量统计摘要 |
| `/api/ip-fraud` | GET | - | - | ✅ | IP 欺诈评分 |
| `/dns-proxy` | GET | `url` | 仅白名单域名 | ✅ | DNS 代理测试 |

### API 响应示例

**健康检查 `/health`**
```json
{
  "status": "ok",
  "timestamp": 1704067200000,
  "version": "4.2",
  "uptime": "unknown"
}
```

**CPU 测试 `/cpu-test?n=500000`**
```json
{
  "duration": 45,
  "iterations": 500000,
  "opsMs": 11111.11,
  "result": "12345678"
}
```

**HTTP/2 测试 `/http2-test`**
```json
{
  "http2": true,
  "http3": false,
  "protocol": "HTTP/2",
  "tlsVersion": "TLSv1.3",
  "earlyHints": true,
  "supportsEarlyHints": true,
  "alpn": "h2"
}
```

**测速历史 `/api/speed-history`**
```json
{
  "records": [
    {
      "timestamp": 1704067200000,
      "avgSpeed": 45.2,
      "results": [ { "sizeKB": 100, "speed": "45.2" } ],
      "colo": "NRT",
      "asn": "AS13335"
    }
  ]
}
```

---

## 命令行测试

### 基础测试
```bash
# 健康检查
curl https://your-worker.dev/health

# 获取主页面
curl https://your-worker.dev/
```

### 性能测试
```bash
# 带宽测试（100KB）
curl -o /dev/null -s -w 'Speed: %{speed_download} bytes/sec\n' \
  https://your-worker.dev/speedtest?size=102400

# CPU 性能测试（50万次迭代）
curl https://your-worker.dev/cpu-test?n=500000

# 并发测试（4个并发，2KB数据）
curl https://your-worker.dev/concurrent-test?count=4&size=2048

# 流式传输测试（1MB）
curl -o /dev/null -s -w 'Time: %{time_total}s\n' \
  https://your-worker.dev/stream-test?size=1048576
```

### 协议检测
```bash
# HTTP/2 检测
curl -v https://your-worker.dev/http2-test 2>&1 | grep -i "http"

# TLS 信息
curl -v https://your-worker.dev/health 2>&1 | grep -i "tls"
```

### WebSocket 测试
```bash
# 使用 websocat 工具
websocat ws://your-worker.dev/ws-test
```

---

## 配置说明

### 限流配置

默认限流规则：

| 维度 | 限制 | 说明 |
| :--- | :--- | :--- |
| 通用 API | 60 次/分钟 / IP | 大部分端点 |
| CPU 测试 | 3 次/分钟 / IP | 防止 CPU 资源滥用 |

修改 `_workers.js` 中限流参数：
```javascript
// 通用限流（第58行附近）
if (isRateLimited(clientIp)) { // 默认 60次/分钟
// 修改为 100次/分钟
if (isRateLimited(clientIp, 100)) {

// CPU 限流
if (cpuRateLimit(clientIp, 3)) { // 默认 3次/分钟
// 修改为 5次/分钟
if (cpuRateLimit(clientIp, 5)) {
```

### 测试参数上限配置

| 端点 | 参数 | 默认上限 | 建议范围 |
| :--- | :--- | :--- | :--- |
| `/speedtest` | `size` | 5,242,880 (5MB) | ≤ 10MB |
| `/cpu-test` | `n` | 2,000,000 | ≤ 5,000,000 |
| `/concurrent-test` | `count` | 16 | ≤ 32 |
| `/concurrent-test` | `size` | 65,536 (64KB) | ≤ 256KB |
| `/stream-test` | `size` | 10,485,760 (10MB) | ≤ 25MB |

### KV 命名空间配置

```toml
# wrangler.toml
name = "netsight-pro"
main = "_workers.js"
compatibility_date = "2024-12-01"

kv_namespaces = [
  { binding = "SPEED_HISTORY", id = "your-kv-namespace-id" }
]
```

### 自定义域名绑定

```toml
routes = [
  { pattern = "diagnostics.yourdomain.com", custom_domain = true }
]
```

### 环境变量（通过 `wrangler.toml` 或 Dashboard 设置）

| 变量名 | 描述 | 默认值 |
| :--- | :--- | :--- |
| `MAX_REQUESTS` | 每分钟每个 IP 的最大请求数 | `60` |
| `ALLOWED_DOMAINS` | DNS 代理测试允许的域名（逗号分隔） | `cloudflare.com,google.com,github.com` |
| `SPEED_HISTORY` | KV 命名空间绑定（必须） | - |

---

## 技术架构

```
┌─────────────────────────────────────────────────────────────┐
│                         客户端                              │
│                  浏览器 / curl / WebSocket                  │
└─────────────────┬───────────────────────────────────────────┘
                  │ HTTPS / WSS
                  ▼
┌─────────────────────────────────────────────────────────────┐
│                   Cloudflare 边缘网络                       │
│  ┌─────────────────────────────────────────────────────┐   │
│  │              Cloudflare Worker                       │   │
│  │  ┌───────────┐  ┌───────────┐  ┌───────────┐       │   │
│  │  │  限流中间件 │─▶│  路由分发  │─▶│  响应生成器 │       │   │
│  │  └───────────┘  └─────┬─────┘  └─────┬─────┘       │   │
│  │                        │               │               │   │
│  │         ┌─────────────┼───────────────┼─────────────┐│   │
│  │         ▼             ▼               ▼             ││   │
│  │  ┌───────────┐ ┌───────────┐  ┌───────────┐        ││   │
│  │  │ 静态页面   │ │ API 端点  │  │ WebSocket │        ││   │
│  │  │ 生成器     │ │ 处理器    │  │ 处理器    │        ││   │
│  │  └───────────┘ └─────┬─────┘  └─────┬─────┘        ││   │
│  │                       │               │              ││   │
│  │         ┌─────────────┴───────────────┘              ││   │
│  │         ▼                                            ││   │
│  │  ┌──────────────────────────────────────┐            ││   │
│  │  │ 外部 API (ipapi.co, scamalytics)     │            ││   │
│  │  │ KV 存储 (SPEED_HISTORY)              │            ││   │
│  │  └──────────────────────────────────────┘            ││   │
│  └─────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘
```

### 技术栈

### 浏览器兼容性

| 浏览器 | 最低版本 | WebSocket | Canvas | Streams API | backdrop-filter | 状态 |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| Chrome | 80+ | ✅ | ✅ | ✅ | ✅ | 完全支持 |
| Firefox | 103+ | ✅ | ✅ | ✅ | ✅ | 完全支持 |
| Safari | 13.1+ | ✅ | ✅ | ⚠️ 部分 | ✅ | 基本支持 |
| Edge | 80+ | ✅ | ✅ | ✅ | ✅ | 完全支持 |

---

## 项目结构

```
CF-workers-netdiag/
├── _workers.js          # Cloudflare Worker 主文件（~3400行，含全部前端代码）
├── README.md            # 项目文档（本文件）
├── SECURITY.md          # 安全政策
├── LICENSE              # AGPL-3.0 许可证
├── CODE_OF_CONDUCT.md   # 行为准则
├── CONTRIBUTING.md      # 贡献指南
├── .github/
│   ├── workflows/
│   │   └── build.yml    # GitHub Actions CI/CD
│   └── ISSUE_TEMPLATE/  # Issue 模板
└── .gitignore           # Git 忽略文件配置
```

### 核心文件说明

| 文件 | 大小 | 说明 |
| :--- | :--- | :--- |
| `_workers.js` | ~3400 行 | Worker 主程序，包含所有 API 逻辑、前端 HTML/CSS/JS、极光玻璃拟态设计体系和 KV 集成 |
| `README.md` | 本文件 | 项目文档 |
| `SECURITY.md` | - | 安全策略和报告流程 |

---

## 安全策略

完整安全策略请参阅 [SECURITY.md](./SECURITY.md)。

### 核心安全措施

### 安全报告

如发现安全漏洞，请发送邮件至：**asiacomk@gmail.com**

---

## 更新日志

### v4.2 (2026-07-25)

- **全新 UI 设计**：从 Apple 极简风格升级为极光玻璃拟态（Aurora Glassmorphism）设计体系
- **极光渐变背景**：深空黑底色 + 多层流动色带（绿/紫/青），`auroraShift` 缓动动画，`blur(60px)` 柔化
- **玻璃拟态卡片**：`backdrop-filter: blur(24px) saturate(150%)`，半透明磨砂质感，indigo 色调点缀
- **响应式重构**：桌面端多列网格 → 平板部分折叠 → 手机单列瀑布流（1024px / 768px / 480px 三档断点）
- **信息层级优化**：安全信息全宽 + 双列内部网格、地理卡片桌面端并排、硬件信息紧凑横条
- **主题方案反转**：`:root` = 深色默认（无需属性），`[data-theme="light"]` = 浅色覆盖
- **修复**：21 项代码审查问题（安全、性能、可访问性）
- **修复**：`updateUI()` 中已移除元素的空引用

### v4.1 (2026-07-07)

- **完善国际化**：全界面文本（包括动态质量等级）支持中/英/繁三语，补齐所有字段标签 ID
- **UI 微调**：优化图标尺寸与悬停动效，按钮图标悬停放大
- **修复**：多节点对比结果表格在繁体/英文下的列名显示

### v4.0 (2026-07-06)

- **新增**: 多节点对比功能，可同时测试多个 Worker 节点的延迟
- **新增**: 流媒体连通性检测（Netflix/Disney+/YouTube/ChatGPT）
- **新增**: IP 欺诈评分端点 `/api/ip-fraud`（集成 Scamalytics）
- **新增**: 自动主题切换（深色/浅色/自动）
- **增强**: 测速历史支持更多字段（colo、asn）
- **优化**: UI 重构，采用 Apple 极简设计体系
- **优化**: 响应式断点适应更多设备
- **修复**: 若干边缘情况错误处理

### v3.6 (2026-07-04)

- **新增**: 测速历史记录功能，自动保存最近 5 条结果到 Cloudflare KV
- **新增**: 用量统计面板，可视化展示网络质量趋势
- **新增**: 3 个 KV API 端点（`/api/log-speed`、`/api/speed-history`、`/api/usage-stats`）
- **优化**: UI 全面重构为 Apple 极简设计体系
- **修复**: DNS 测试全部超时——改用 Worker 代理路由 + Image 对象客户端计时，绕过 CORS
- **修复**: CPU 测试返回 null——duration=0 导致 Infinity，加除零保护
- **新增**: CPU 独立限流（每 IP 每分钟 3 次），429 响应
- **新增**: KV 自动清理机制，写入后删除超出 5 条的旧记录

### v3.5 (2026-06-11)

- 优化: 限流清理机制从 `setInterval` 改为按需随机抽样清理（约1%概率）
- 修复: 全局作用域异步操作问题
- 增强: WebSocket 心跳机制更稳定
- 安全: 动态 CSP nonce，增强 XSS 防护

### v3.3 (2026-05-28)

- 新增: `/health` 健康检查端点
- 新增: IP 级别请求限流保护（60次/分钟）
- 新增: 完整安全响应头（CSP、HSTS、X-Frame-Options、X-Content-Type-Options）
- 新增: WebSocket 30秒心跳机制
- 优化: 并发测试增加内部并发限制器 `pLimit(4)`

### v3.0 (2026-05-10)

- 新增: 实时延迟监控模块，每2秒自动测量 RTT
- 新增: Canvas 实时趋势图表绘制
- 新增: 多档位带宽测速、CPU 密集型性能测试、WebSocket 双向延迟测试
- 新增: 真实 IP 地理位置查询（通过 ipapi.co）
- UI: 全新蓝色玻璃态毛玻璃效果主题

### v1.0 (2026-05-01)

- 项目初始化，创建 `_workers.js` 核心文件
- 基础功能: IP 地址检测与地区验证

---

## 常见问题

### 1. 部署后访问出现 404 错误？
- **原因**: 可能未正确部署 `_workers.js` 文件
- **解决**: 确保复制的是 `_workers.js` 的完整内容，而非其他文件

### 2. 限流触发后如何解除？
- 通用限流周期为 60 秒，CPU 限流周期为 60 秒
- 等待周期结束后自动解除
- 响应头会包含 `retry-after` 字段

### 3. WebSocket 连接失败？
- 确保客户端支持 WebSocket 协议
- 检查网络环境是否允许 WebSocket 连接
- 尝试使用 `ws://` 而非 `wss://`（开发环境）

### 4. 带宽测速结果不准确？
- 测速受网络波动影响，建议多次测试取平均值
- 使用有线网络比 Wi-Fi 更稳定
- 测速文件大小建议选择 1MB 以上

### 5. CPU 测试结果差异大？
- Cloudflare Workers 的 CPU 资源是共享的，结果会有波动
- 建议多次测试取平均值（注意每 IP 每分钟限 3 次）
- 测试迭代次数越高，结果越稳定

### 6. DNS 测试为什么不再直接 fetch？
- 浏览器直接 fetch 外部 URL 会被 CORS 拦截
- v3.6 改为通过 Worker 代理路由进行 DNS 解析，客户端使用 `Image` 对象测量真实延迟

### 7. 测速历史数据能存多久？
- 最近 5 条记录永久保存，超出自动清理
- 每条记录 TTL 为 7 天

### 8. 支持 IPv6 吗？
- 完全支持。Worker 会自动检测并显示 IPv4 和 IPv6 地址

### 9. 多节点对比需要所有节点运行同一套代码吗？
- 是的，所有被测试的节点都需要部署相同或兼容版本的 NetSight Pro，因为测试依赖 `/speedtest` 端点。

### 10. 如何自定义欺诈评分服务？
- 修改 `_workers.js` 中的 `getIpFraudScore` 函数，替换为其他服务 API。

### 11. 玻璃拟态效果在某些浏览器不生效？
- Firefox 103 以下版本不支持 `backdrop-filter`，卡片会降级为半透明纯色背景
- 确保浏览器未禁用硬件加速，`backdrop-filter` 依赖 GPU 合成

### 12. 如何切换深色/浅色主题？
- 点击页面右上角主题切换按钮（太阳/月亮/自动图标）
- 选择会自动保存到 `localStorage`，下次访问自动应用

---

## 故障排查

### 查看 Worker 日志

```bash
# 实时查看日志
wrangler tail

# 过滤特定请求
wrangler tail --filter "status:>=400"

# 输出 JSON 格式
wrangler tail --format json
```

### 常见错误码

| 状态码 | 含义 | 解决方法 |
| :--- | :--- | :--- |
| 429 | Too Many Requests | 等待 60 秒后重试 |
| 404 | Not Found | 检查 URL 路径是否正确 |
| 426 | Upgrade Required | WebSocket 请求需要正确的 Upgrade 头 |
| 500 | Internal Server Error | 检查 Worker 代码或联系支持 |
| 503 | Service Unavailable | Cloudflare 临时问题，稍后重试 |

### 性能优化建议

1. **启用 KV 缓存**: 配置 `SPEED_HISTORY` KV 绑定存储测速历史
2. **使用自定义域名**: 减少 DNS 解析时间
3. **调整限流阈值**: 根据实际使用量调整
4. **压缩响应**: Worker 默认支持 Brotli/Gzip

---

## 许可证

本项目使用 **GNU Affero General Public License v3.0** 许可证。

| 项目 | 说明 |
| :--- | :--- |
| 商业使用 | ✅ 允许 |
| 修改代码 | ✅ 允许 |
| 分发代码 | ✅ 允许 |
| 公开源代码 | ✅ 必须（修改后） |
| 保留版权声明 | ✅ 必须 |
| 专利授权 | ✅ 包含 |
| 私人使用 | ✅ 允许 |

完整许可证文本请查看 [LICENSE](./LICENSE) 文件。

---

## 联系方式

| 渠道 | 链接 |
| :--- | :--- |
| GitHub Issues | [提交问题](https://github.com/BlueDriftHK/CF-workers-netdiag/issues) |
| 安全报告 | asiacomk@gmail.com |

---

*由 BlueDriftHK 用 ❤️ 制作*
*GNU Affero 通用公共许可证 v3.0 · 开源自由 · 持续更新*

CF-workers-netdiag

CF-workers-netdiag Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

CF-workers-netdiag

CF-workers-netdiag Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README