# 🌐 LatencyTest

[![React](https://img.shields.io/badge/React-18.3-61DAFB?style=flat-square&logo=react&logoColor=white)](https://react.dev/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.6-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
[![Vite](https://img.shields.io/badge/Vite-6.0-646CFF?style=flat-square&logo=vite&logoColor=white)](https://vitejs.dev/)
[![Cloudflare Workers](https://img.shields.io/badge/Cloudflare_Workers-F38020?style=flat-square&logo=cloudflare&logoColor=white)](https://workers.cloudflare.com/)
[![Node.js](https://img.shields.io/badge/Node.js-Express-339933?style=flat-square&logo=node.js&logoColor=white)](https://expressjs.com/)

中文 | **[English](README.en-US.md)**

---

## 📖 项目简介

**LatencyTest** 是一款现代化的全球网络延迟测试工具。利用分布在世界各地 20+ 个节点，对目标 IP 或域名进行延迟测试，并通过交互式 3D 地球可视化展示结果。

## ✨ 功能特性

| 功能 | 描述 |
|------|------|
| 🌍 **全球多节点测试** | 覆盖美洲、欧洲、亚洲等 20+ 个测试节点 |
| 🌐 **3D 地球可视化** | 使用 `react-globe.gl` 实时展示测试路径与延迟 |
| ⚡ **自动 DNS 解析** | 支持 IP 或域名输入，自动解析目标地址 |
| 📍 **GeoIP 信息** | 显示目标 IP 的地理位置、ISP 及 AS 编号 |
| 🆚 **对比模式** | 同时测试两个目标，直观对比全球延迟差异 |
| 🔗 **结果分享** | 一键生成测试报告链接（有效期 7 天） |
| 🌗 **双语支持** | 完美支持中英双语切换 |

## 🛠️ 技术栈

**前端**
- React 18 + TypeScript + Vite
- react-globe.gl + Three.js（3D 可视化）
- React Router（路由管理）
- 纯 CSS（响应式设计）

**后端**（二选一）
- Cloudflare Workers（边缘计算，推荐）
- Node.js + Express

**API**
- GlobalPing API（延迟测量）
- ip-api.com（GeoIP 查询）

## 🚀 快速开始

### 安装依赖

```bash
git clone https://github.com/your-username/LatencyTest.git
cd LatencyTest
npm install
```

### 开发模式

```bash
npm run dev
```

## 📦 部署

### 方式一：Cloudflare Workers（推荐）

```bash
# 安装并登录 Wrangler
npm install -g wrangler
wrangler login

# 部署
npm run deploy
```

### 方式二：Node.js 服务器

```bash
# 构建
npm run build

# 启动
npm run start
```

## 📸 截图

> *截图待添加*

## 📄 许可证

待定