From e3532d1718877be13c15544e7826226822003de0 Mon Sep 17 00:00:00 2001
From: gitee-bot <no-reply@git.oschina.net>
Date: Wed, 17 Dec 2025 07:23:29 +0000
Subject: [PATCH] Add README.md

---
 README.en.md | 57 +++++++++++++++++++++++++++++++++++++++++++++
 README.md    | 65 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 122 insertions(+)
 create mode 100644 README.en.md
 create mode 100644 README.md

diff --git a/README.en.md b/README.en.md
new file mode 100644
index 0000000..751d6d2
--- /dev/null
+++ b/README.en.md
@@ -0,0 +1,57 @@
+# Network Scanner
+
+A simple network scanning tool that supports IP address scanning and port scanning, suitable for network diagnostics and device detection.
+
+## Features
+
+- **IP Scan**: Scan a specified IP range to detect active devices.
+- **Port Scan**: Scan ports on a specified IP to detect open ports and corresponding services.
+- **Graphical User Interface**: Provides a user-friendly GUI for easy operation and result viewing.
+- **Multithreading Support**: Enhances scanning efficiency through multithreading.
+- **Log Output**: Displays real-time log information during the scanning process.
+- **Stop Scan**: Supports stopping ongoing scan tasks at any time.
+
+## Technologies Used
+
+- Python 3.x
+- Tkinter (for the graphical interface)
+- Socket (for network communication)
+- Multithreading (for concurrent scanning)
+
+## Usage Instructions
+
+1. **Launch the Program**:
+   ```bash
+   python network_scanner.py
+   ```
+
+2. **IP Scan**:
+   - Enter an IP range (e.g., `192.168.1.1-100`) in the IP Scan tab.
+   - Set the timeout and maximum number of threads.
+   - Click the "Start Scan" button to list active IP addresses.
+
+3. **Port Scan**:
+   - Enter the target IP address in the Port Scan tab.
+   - Enter the port range to scan (e.g., `1-1000`).
+   - Set the timeout and maximum number of threads.
+   - Click the "Start Scan" button to list open ports and their corresponding services.
+
+4. **Stop Scan**:
+   - Click the "Stop Scan" button to terminate any ongoing scan task at any time.
+
+5. **Clear Results**:
+   - Click the "Clear Results" button to clear current scan results and log information.
+
+## Notes
+
+- Ensure the device running this program has network access permissions.
+- Adjust the scan range and thread count according to your network environment to avoid excessive network load.
+- This tool is intended solely for learning and testing purposes. Do not use it for illegal activities.
+
+## Open Source License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+## Contact
+
+For any questions or suggestions, please contact the project maintainer.
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..11e5ad9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,65 @@
+该项目旨在提供一个基于Python的网络扫描工具，具备IP扫描和端口扫描功能，并通过图形界面进行操作。以下是该项目的 README 内容：
+
+---
+
+# Network Scanner
+
+一个简单的网络扫描工具，支持IP地址扫描和端口扫描功能，适用于网络诊断和设备检测。
+
+## 功能特性
+
+- **IP扫描**：扫描指定IP范围，检测活跃的设备。
+- **端口扫描**：扫描指定IP的端口，检测开放的端口及对应的服务。
+- **图形界面**：提供友好的图形界面，方便用户操作和查看结果。
+- **多线程支持**：通过多线程提高扫描效率。
+- **日志输出**：实时显示扫描过程中的日志信息。
+- **停止扫描**：支持随时停止正在进行的扫描任务。
+
+## 使用技术
+
+- Python 3.x
+- Tkinter（用于图形界面）
+- Socket（用于网络通信）
+- 多线程（用于并发扫描）
+
+## 使用说明
+
+1. **启动程序**：
+   ```bash
+   python network_scanner.py
+   ```
+
+2. **IP扫描**：
+   - 在IP扫描标签页中输入IP范围（如 `192.168.1.1-100`）。
+   - 设置超时时间和最大线程数。
+   - 点击“开始扫描”按钮，程序将列出活跃的IP地址。
+
+3. **端口扫描**：
+   - 在端口扫描标签页中输入目标IP地址。
+   - 输入要扫描的端口范围（如 `1-1000`）。
+   - 设置超时时间和最大线程数。
+   - 点击“开始扫描”按钮，程序将列出开放的端口及对应的服务。
+
+4. **停止扫描**：
+   - 点击“停止扫描”按钮，可以随时终止正在进行的扫描任务。
+
+5. **清除结果**：
+   - 点击“清除结果”按钮，可以清除当前的扫描结果和日志信息。
+
+## 注意事项
+
+- 请确保运行程序的设备具有网络访问权限。
+- 扫描范围和线程数应根据实际网络环境进行调整，以避免对网络造成过大负载。
+- 本工具仅供学习和测试使用，请勿用于非法用途。
+
+## 开源许可
+
+本项目采用 MIT License，请参见 [LICENSE](LICENSE) 文件以了解详细信息。
+
+## 联系方式
+
+如有任何问题或建议，请联系项目维护者。
+
+--- 
+
+以上是该项目的简要说明和使用指南。
\ No newline at end of file
-- 
Gitee