docs: 添加项目文档和 MIT
This commit is contained in:
parent
71a8e81f68
commit
d8b3158747
9
LICENSE
Normal file
9
LICENSE
Normal file
@ -0,0 +1,9 @@
|
||||
MIT License
|
||||
|
||||
Copyright (c) 2024 fly6516
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
81
README.md
Normal file
81
README.md
Normal file
@ -0,0 +1,81 @@
|
||||
|
||||
|
||||
# 网络通信软件
|
||||
|
||||
## 项目概述
|
||||
|
||||
该项目是一个基于Python的网络通信软件,使用Tkinter实现图形化界面。用户可以通过该软件发送ICMP、UDP或TCP报文到指定的目标地址和端口。软件会展示本机信息(主机名、MAC地址和IP地址),并允许用户选择源IP地址、目标地址、端口号以及报文类型进行发送。
|
||||
|
||||
## 功能
|
||||
|
||||
- 获取本机的主机名、MAC地址和IP地址。
|
||||
- 用户输入目标地址和端口号,支持验证IP地址、域名和端口号的有效性。
|
||||
- 支持发送三种类型的报文:ICMP、UDP和TCP。
|
||||
- ICMP报文会进行校验和计算并发送。
|
||||
- UDP和TCP报文会根据指定端口号构造并发送。
|
||||
- TCP连接建立后可以发送简单的字符串数据。
|
||||
- 提供错误处理机制,显示网络错误、输入错误等信息。
|
||||
|
||||
## 使用方法
|
||||
|
||||
1. **启动软件:**
|
||||
运行该Python脚本文件,会弹出一个图形化界面。
|
||||
|
||||
2. **选择源IP地址:**
|
||||
软件会自动列出本机的所有IP地址,用户可以从下拉框中选择一个作为源IP。
|
||||
|
||||
3. **输入目标地址和端口:**
|
||||
在目标地址输入框中输入目标的IP地址或域名,目标端口则输入目标的端口号。
|
||||
|
||||
4. **选择报文类型:**
|
||||
用户可以选择发送ICMP、UDP或TCP类型的报文。
|
||||
|
||||
5. **发送报文:**
|
||||
点击“发送报文”按钮后,软件会构造并发送报文。如果目标地址、端口号或其他输入无效,软件会弹出错误提示。
|
||||
|
||||
6. **查看结果:**
|
||||
软件会在界面上显示报文发送是否成功的信息,或者在发生错误时显示相应的错误提示。
|
||||
|
||||
## 安装依赖
|
||||
|
||||
该项目使用Python 3,并依赖以下库:
|
||||
|
||||
- `tkinter`: 用于创建图形化界面。
|
||||
- `socket`: 用于网络通信。
|
||||
- `struct`: 用于构造网络报文。
|
||||
- `re`: 用于正则表达式匹配和验证。
|
||||
|
||||
可以通过以下命令安装相关库:
|
||||
|
||||
```bash
|
||||
pip install tk
|
||||
```
|
||||
|
||||
## 代码说明
|
||||
|
||||
- **获取本机信息**:`get_local_info()`函数获取本机的主机名、MAC地址和IP地址列表。
|
||||
- **输入验证**:通过正则表达式验证IP地址、域名和端口号的有效性。
|
||||
- **报文构造**:根据用户选择的报文类型,程序会构造相应的ICMP、UDP或TCP报文。报文会根据所需协议格式进行打包,并计算校验和(仅ICMP)。
|
||||
- **发送报文**:`send_packet()`函数根据输入的目标地址和端口号构造报文并通过相应的网络协议发送出去。
|
||||
|
||||
## 错误处理
|
||||
|
||||
- **网络错误**:如无法解析目标地址或网络连接失败,会显示错误信息。
|
||||
- **输入错误**:如输入的目标地址、端口号无效,会显示相应的提示。
|
||||
- **未知错误**:其他未预见的错误会通过弹窗提示用户。
|
||||
|
||||
## 示例截图
|
||||
|
||||
界面包括:
|
||||
|
||||
- 本机信息显示。
|
||||
- 输入框和按钮,用于输入目标地址、端口和选择报文类型。
|
||||
- 显示发送结果的区域。
|
||||
|
||||
## 许可证
|
||||
|
||||
该项目使用MIT许可证,详情请见`LICENSE`文件。
|
||||
|
||||
## 联系方式
|
||||
|
||||
如果有任何问题或建议,欢迎通过邮件联系我:`fly6516@outlook.com`
|
Loading…
Reference in New Issue
Block a user