# xnet

**Repository Path**: rust_cn/xnet

## Basic Information

- **Project Name**: xnet
- **Description**: 一款专注于网络领域的分析和监控工具.
- **Primary Language**: Rust
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-28
- **Last Updated**: 2026-01-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">
    🌐 xnet
</h1>
<h4 align="center">
一款专注于网络领域的分析和监控工具.
</h4>
<p align="center">
  <a href="https://github.com/0xhappyboy/xnet/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-AGPL3.0-d1d1f6.svg?style=flat&labelColor=1C2C2E&color=BEC5C9&logo=googledocs&label=license&logoColor=BEC5C9" alt="License"></a>
</p>
<p align="center">
<a href="./README_zh-CN.md">简体中文</a> | <a href="./README.md">English</a>
</p>

# 演示

<img src="./assets/xnet.gif" alt="xnet demo" width="100%">

# 操作手册

## 基本操作

### 启动与退出

- 启动程序：执行 `cargo run`
- 退出程序：按 `q` 键

### 界面焦点切换

- 下一个焦点区域：按 `Tab` 键
- 上一个焦点区域：按 `Shift + Tab` 键

焦点区域循环顺序：

1. 网络接口列表 (Interfaces)
2. 数据包列表 (Packets)
3. 详细信息面板 (Details)
4. 十六进制视图 (Hex)

### 各焦点区域操作

#### 1. 网络接口列表 (焦点在 Interfaces 时)

- 向上移动选择：`↑` 键
- 向下移动选择：`↓` 键
- 选择/切换接口：`空格` 键
  - 如果当前未选择接口：选择并开始捕获
  - 如果已选择其他接口：切换到新接口并重新捕获
  - 如果已选择当前接口：切换捕获状态（开始/停止）

#### 2. 数据包列表 (焦点在 Packets 时)

- 选择上一个数据包：`↑` 键
- 选择下一个数据包：`↓` 键
- 开始/停止捕获：`空格` 键

#### 3. 详细信息面板 (焦点在 Details 时)

- 向上滚动：`↑` 键
- 向下滚动：`↓` 键

#### 4. 十六进制视图 (焦点在 Hex 时)

- 向上滚动：`↑` 键
- 向下滚动：`↓` 键

### 其他功能键

- 清除所有数据包：按 `r` 键
- 刷新网络接口列表：按 `i` 键

## 工作流程示例

1. **启动监控**

   - 启动程序后，按 `i` 刷新接口列表
   - 用 `↑`/`↓` 选择网络接口
   - 按 `空格` 开始捕获该接口流量

2. **切换接口**

   - 用 `Tab` 切换到接口列表
   - 选择新接口后按 `空格`
   - 程序会自动停止当前捕获，切换到新接口重新开始

3. **分析数据包**

   - 用 `Tab` 在数据包列表、详细信息和十六进制视图间切换
   - 选择数据包查看详细信息

4. **暂停/继续捕获**
   - 在任何焦点区域按 `空格` 可以切换捕获状态
   - 或选择当前接口再按 `空格`

## 注意事项

- 切换接口时，如果正在捕获，会有 100 毫秒的暂停
- 清除数据包 (`r` 键) 会清空所有捕获的数据包
- 退出前无需停止捕获，程序会自动清理