# Go网络监控

**Repository Path**: liumou_site/go-network-monitoring

## Basic Information

- **Project Name**: Go网络监控
- **Description**: 基于Go语言开发的现代化网络监控仪表盘，支持实时监控所有网卡的网络流量
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-13
- **Last Updated**: 2025-08-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Go网络监控仪表盘

## 🚀 项目介绍

基于Go语言开发的现代化网络监控仪表盘，支持实时监控**所有网卡**的网络流量，包括：

## 🎯 快速导航

| 用户类型 | 参考文档 | 描述 |
|---------|----------|------|
| 👤 普通用户 | [📖 INSTALL.md](./INSTALL.md) | 一键安装，快速部署 |
| 👨‍💻 开发者 | [🛠️ DEVELOPMENT.md](./DEVELOPMENT.md) | 编译开发，二次开发 |
| 🚀 快速体验 | 下方[快速体验](#-快速体验开发者)章节 | 立即运行，无需安装 |

### ✨ 核心功能
- **多网卡监控**：同时监控所有活跃网卡
- **实时数据**：1秒自动刷新，显示实时上传/下载速率
- **流量统计**：累计上传/下载流量统计
- **状态指示**：活跃网卡状态标识
- **响应式设计**：完美适配手机、平板、桌面设备
- **中文界面**：全中文本地化体验

### 📊 数据展示
- **汇总卡片**：总接口数、总下载/上传流量、总丢包率
- **详细表格**：每个网卡的详细信息
- **速度分类**：根据速率显示不同颜色标签
- **时间戳**：显示最后更新时间


**效果图**

![效果](image/效果.png)
![效果Linux](image/效果-Linux.png)



## 🛠️ 安装与使用

### 普通用户安装
如果您是普通用户，希望快速部署使用，请直接参考：[安装指南 → INSTALL.md](./INSTALL.md)

### 开发者编译
如果您是开发者，需要编译未发布的版本或进行二次开发，请参考：[开发者指南 → DEVELOPMENT.md](./DEVELOPMENT.md)

### 快速体验（开发者）

#### 环境要求
- Go 1.23 或更高版本
- Windows/Linux/macOS 支持

#### 立即运行
```bash
# 克隆项目
git clone https://gitee.com/liumou_site/go-network-monitoring.git
cd go-network-monitoring

# 启动服务
go run .

# 访问界面
# 打开浏览器访问：http://localhost:8080
```

#### 自定义运行参数
```bash
# 指定地址和端口
go run . --address 127.0.0.1 --port 8084

# 仅本地访问
go run . --address 192.168.1.100 --port 8080
```

## 📱 界面预览

### 桌面版效果
- **顶部汇总**：显示所有网卡的总体统计
- **网卡列表**：详细展示每个网卡的实时数据
- **颜色编码**：根据网速显示不同状态颜色
- **实时更新**：数据每2秒自动刷新

### 移动端效果
- **响应式布局**：完美适配小屏幕
- **触摸友好**：表格可横向滑动查看
- **简洁清晰**：保留核心功能，操作便捷

## 🔧 技术架构

### 后端技术栈
- **Gin框架**：高性能HTTP框架
- **Go原生网络库**：直接读取系统网络统计
- **跨平台支持**：Windows/Linux/macOS

### 前端技术栈
- **纯HTML/CSS/JS**：无外部依赖，加载快速
- **响应式设计**：Bootstrap风格现代化界面
- **实时通信**：AJAX轮询获取最新数据

### 数据格式
```json
{
  "eth0": {
    "received_mbps": 125.50,
    "sent_mbps": 45.20,
    "total_received_gb": 15.75,
    "total_sent_gb": 8.32,
    "stats": {
      "TotalDropped": 0
    }
  },
  "wlan0": {
    "received_mbps": 85.30,
    "sent_mbps": 12.10,
    "total_received_gb": 5.25,
    "total_sent_gb": 2.18,
    "stats": {
      "TotalDropped": 5
    }
  }
}
```

## 🎨 界面特色

### 颜色系统
- **高速**：蓝色（>100Mbps）
- **中速**：橙色（>10Mbps）
- **低速**：绿色（<10Mbps）
- **空闲**：灰色（无流量）

### 交互体验
- **悬停效果**：卡片和表格行悬停动画
- **状态提示**：网卡活跃状态实时显示
- **错误处理**：网络异常时的友好提示

## 📈 性能特点

- **轻量级**：内存占用极低
- **高效**：直接读取系统数据，无额外开销
- **稳定**：长时间运行无内存泄漏
- **快速**：启动时间<1秒

## 🌟 未来规划

- [ ] 支持历史数据图表
- [ ] 添加网络质量测试
- [ ] 支持邮件/微信告警
- [ ] 增加系统资源监控
- [ ] 提供Docker镜像

## 📄 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件

## 🤝 贡献

欢迎提交Issue和Pull Request！

## 📞 联系

如有问题，请通过以下方式联系：
- 提交Issue到本项目
- 发送邮件到项目维护者

---