# Python Network Traffic Consumer

**Repository Path**: Hanjx666d/python-network-traffic-consumer

## Basic Information

- **Project Name**: Python Network Traffic Consumer
- **Description**: 一个专注于网络流量压测的Python开源项目，提供高效的数据消费工具，适用于各种网络流量测试场景。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-28
- **Last Updated**: 2026-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

一个多线程网络带宽测试工具，通过下载指定量的数据来测量您的网速。请负责任地使用，并确保遵守您的互联网服务提供商的条款。

功能特点
使用多线程下载目标数据量（例如 100 GB）。

实时显示进度，包括下载速度（Mbps）和预计剩余时间。

可设置时间限制，在达到一定时长后停止测试。

如果外部测试文件不可用，自动回退到本地虚拟数据生成。

提供完整统计：平均速度、峰值速度、总下载量和测试时长。

⚠️ 重要法律声明
该工具可能产生巨大流量（可配置高达数百 GB）。

过度使用可能违反您的互联网服务提供商的条款，导致限速、暂停服务或产生额外费用。

仅可在您拥有所有权或明确授权的网络上使用此工具。

作者不对滥用该工具或其使用后果承担任何责任。

安装方法
克隆仓库（或直接下载脚本）：


git clone https://gitee.com/Hanjx666d/python-network-traffic-consumer.git
cd python-network-traffic-consumer
安装所需依赖：


pip install requests
使用方法
在命令行中运行脚本：


python python-network-traffic-consumer.py [选项]
选项说明
选项	说明
-g, --gb	目标下载量，单位 GB（默认：100.0）
-n, --threads	下载线程数（默认：4）
-t, --time	最长测试时间，单位秒（默认：无限制）
-h, --help	显示帮助信息并退出
示例
下载 100 GB（默认）：


python python-network-traffic-consumer.py
下载 50 GB，使用 8 个线程：


python python-network-traffic-consumer.py -g 50 -n 8
测试 30 分钟（1800 秒），不关心下载量：


python python-network-traffic-consumer.py -t 1800
下载 200 GB，但 1 小时后停止：


python python-network-traffic-consumer.py -g 200 -t 3600
启动测试时，程序会要求您输入 YES 确认——这是为了防止意外产生大量流量的安全措施。

工作原理
脚本启动多个线程，每个线程从公共测速文件列表中下载数据块。

每秒更新控制台显示：

进度百分比

已下载量/目标量

瞬时速度（Mbps）

平均速度（Mbps）

已用时间

测试在以下情况停止：

达到目标下载量，或

超过设定的时间限制（如果指定了 -t），或

用户按下 Ctrl+C。

如果所有公共 URL 都不可用，脚本会回退到在内存中生成虚拟数据以继续测试（这会消耗 CPU 但不会产生实际网络流量）。

注意事项
公共测试文件可能有带宽限制，或者被其托管方移除。如果速度很慢，尝试减少线程数或更换其他 URL。

虚拟数据回退模式不占用您的网络，仅测试 CPU 性能。要获得真实的网络测试，请确保至少有一个公共 URL 可用。

License / 许可证
This project is licensed under the MIT License – see the LICENSE file for details.
本项目采用 MIT 许可证授权 – 详见 LICENSE 文件。

Disclaimer: This tool is provided for educational and legitimate testing purposes only. Users are solely responsible for complying with all applicable laws and terms of service.
免责声明： 本工具仅供教育和合法测试之用。用户需自行负责遵守所有适用的法律和服务条款。