# ads-tools

**Repository Path**: kongbowoo_admin/ads-tools

## Basic Information

- **Project Name**: ads-tools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-01
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: antiDDOS

## README

# AntiDDoS工具集

面向网络工程师与安全团队的免费在线工具箱。基于 [Next.js 16](https://nextjs.org) 与 [shadcn/ui](https://ui.shadcn.com) 构建，覆盖 DDoS 防护规则生成、抓包分析、流量计算、漏洞检测与合规报告。

[English](./README.en.md)

## 界面预览

首页：31 个免费工具，无需注册，浏览器即可使用。

![AntiDDoS工具集首页](./public/screenshots/home.png)

工具目录：按分类检索防火墙规则、抓包分析、计算器、攻击情报与合规工具。

![AntiDDoS工具集工具目录](./public/screenshots/tools.png)

实时 DDoS 攻击地图：可视化攻击来源、目标与路径（演示数据）。

![实时 DDoS 攻击地图](./public/screenshots/attack-map.png)

iptables DDoS 防护规则生成器：按端口、白名单与防护策略一键生成可复制规则。

![iptables DDoS 防护规则生成器](./public/screenshots/iptables.png)

## 主要功能

- **防火墙与配置生成器**
  - iptables / nftables DDoS 防护规则
  - Fail2Ban、HAProxy、BGP FlowSpec 配置
  - DDoS 事件响应计划生成

- **抓包与分析**
  - TCPDump 命令构建器
  - Wireshark 过滤器速查
  - PCAP 在线分析

- **计算器**
  - DDoS 风险评分、PPS、带宽成本、SLA
  - MTU / MSS、停机损失与防护 ROI

- **攻击模拟与情报**
  - 攻击模拟报告、实时攻击地图
  - 攻击向量百科、IP 威胁查询

- **漏洞检查器**
  - DNS 健康 / 开放解析器
  - Memcached / NTP 放大检测
  - 服务器暴露面与 cPanel 检查

- **合规工具**
  - NIS2 事件通报生成
  - DDoS 应急响应计划模板

## 技术栈

- **框架**: Next.js 16 (App Router)
- **UI 组件**: shadcn/ui (基于 Radix UI)
- **样式**: Tailwind CSS v4
- **表单**: React Hook Form + Zod
- **图标**: Lucide React
- **包管理器**: pnpm 9+
- **语言**: TypeScript 5.x

## 快速开始

### 启动开发服务器

在项目根目录下运行以下命令启动开发服务：

```bash
pnpm install
pnpm dev
```

启动后，在浏览器中访问 [http://localhost:5000](http://localhost:5000) 查看应用。开发模式支持热更新，修改代码后页面会自动刷新。

### 构建生产版本

```bash
pnpm build
```

### 启动生产服务器

```bash
pnpm start
```

## 项目结构

```
src/
├── app/                      # Next.js App Router 目录
│   ├── api/tools/            # API 路由 (各工具后端逻辑)
│   │   ├── dns-lookup/
│   │   ├── ip-lookup/
│   │   └── ...
│   ├── tools/                # 工具详情页路由
│   │   └── [slug]/
│   ├── globals.css           # 全局样式 (Tailwind 变量)
│   ├── layout.tsx            # 根布局组件
│   └── page.tsx              # 首页
│
├── components/
│   ├── ui/                   # shadcn/ui 基础组件库
│   └── tools/                # 业务功能组件
│       ├── calculators-a.tsx
│       ├── capture.tsx
│       ├── simulation.tsx
│       └── ...
│
├── lib/                      # 工具函数与网络探测库
│   └── net-probes.ts         # 网络探测协议解析
│
├── data/                     # 静态数据与配置
│   ├── reference.ts
│   └── tools.ts              # 工具列表定义
│
└── hooks/                    # 自定义 React Hooks

server/                       # 自定义服务器入口
```

## 核心开发规范

### 1. 组件开发

**优先使用 shadcn/ui 基础组件**

项目已预装完整的 shadcn/ui 组件库，位于 `src/components/ui/` 目录。开发时应优先组合使用这些组件：

```tsx
import { Button } from '@/components/ui/button';
import { Card, CardContent, CardHeader } from '@/components/ui/card';

export default function ToolCard() {
  return (
    <Card>
      <CardHeader>工具标题</CardHeader>
      <CardContent>
        <Button>开始检测</Button>
      </CardContent>
    </Card>
  );
}
```

### 2. 依赖管理

**必须使用 pnpm 管理依赖**

```bash
# 安装依赖
pnpm install

# 添加新依赖
pnpm add package-name

# 添加开发依赖
pnpm add -D package-name
```

项目已配置 `preinstall` 脚本，非 pnpm 包管理器安装时会报错。

### 3. 样式开发

**使用 Tailwind CSS v4**

全局样式变量定义在 `src/app/globals.css` 中，支持深色/亮色主题切换。

```tsx
<div className="flex items-center gap-4 p-4 bg-background rounded-lg">
  <span className="text-primary">主要文字</span>
</div>
```

### 4. 新增工具

新增工具需遵循以下步骤：

1. **定义工具配置**: 在 `src/data/tools.ts` 中添加工具元数据。
2. **实现 API 路由**: 在 `src/app/api/tools/[tool-name]/route.ts` 中编写后端逻辑。
3. **开发前端组件**: 在 `src/components/tools/` 中创建对应的 React 组件。
4. **创建页面路由**: 在 `src/app/tools/[slug]/page.tsx` 中接入组件（如果使用动态路由）。

## 参考文档

- [Next.js 官方文档](https://nextjs.org/docs)
- [shadcn/ui 组件文档](https://ui.shadcn.com)
- [Tailwind CSS 文档](https://tailwindcss.com/docs)
- [React Hook Form](https://react-hook-form.com)