Añadir Home
commit
371e59c6e0
|
|
@ -0,0 +1,181 @@
|
|||
# Network Interface IP Configuration Utility Wiki
|
||||
|
||||
## Table of Contents
|
||||
- [Overview](#overview)
|
||||
- [Installation](#installation)
|
||||
- [Main Components](#main-components)
|
||||
- [IP Setup Tab](#ip-setup-tab)
|
||||
- [Tools Tab](#tools-tab)
|
||||
- [Network Scanning](#network-scanning)
|
||||
- [Administrator Privileges](#administrator-privileges)
|
||||
- [Configuration Files](#configuration-files)
|
||||
- [Troubleshooting](#troubleshooting)
|
||||
- [FAQ](#faq)
|
||||
|
||||
## Overview
|
||||
|
||||
The Network Interface IP Configuration Utility is a Python-based desktop application designed to simplify network interface management on Windows systems. It provides an intuitive graphical interface for changing IP addresses, enabling/disabling DHCP, and performing network diagnostics.
|
||||
|
||||
## Installation
|
||||
|
||||
### Prerequisites
|
||||
- Windows operating system
|
||||
- Python 3.6 or higher
|
||||
- Administrative privileges (required for changing network settings)
|
||||
|
||||
### Dependencies
|
||||
Install the required Python packages:
|
||||
```
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
Optional dependencies (enhanced functionality):
|
||||
- `pythonping`: For improved ping functionality (`pip install pythonping`)
|
||||
- `pysnmp`: For SNMP functionality (`pip install pysnmp`)
|
||||
- `wmi`: For improved network interface detection (`pip install wmi`)
|
||||
- `mac-vendor-lookup`: For MAC address vendor lookup (`pip install mac-vendor-lookup`)
|
||||
|
||||
### Running the Application
|
||||
Run the main script:
|
||||
```
|
||||
python menu-ip-change.py
|
||||
```
|
||||
|
||||
## Main Components
|
||||
|
||||
The application is divided into two main tabs:
|
||||
1. **IP Setup**: For configuring network interfaces
|
||||
2. **Tools**: For network diagnostics and scanning
|
||||
|
||||
Both tabs share a common log area that displays operation results and informational messages.
|
||||
|
||||
## IP Setup Tab
|
||||
|
||||
### Interface Selection
|
||||
- Use the dropdown menu to select the network interface you want to configure
|
||||
- The current configuration (IP, subnet mask, gateway, and DHCP status) will be displayed
|
||||
|
||||
### Setting a Static IP
|
||||
1. Enter the IP prefix (first three octets) in the "IP Prefix" field
|
||||
2. Enter the last octet in the "Last Octet" field
|
||||
3. Set the subnet mask (directly or using CIDR notation)
|
||||
4. Click "Set Static IP"
|
||||
|
||||
### Enabling DHCP
|
||||
1. Select the network interface
|
||||
2. Click "Enable DHCP"
|
||||
|
||||
### Using IP History
|
||||
- Previously used IP addresses are saved in the IP History dropdown
|
||||
- Select an entry to quickly configure that IP
|
||||
- The application remembers subnet masks for each IP prefix
|
||||
|
||||
### Quick Actions
|
||||
- **Restore Previous**: Reverts to the previous configuration
|
||||
- **Refresh Interfaces**: Updates the list of available network interfaces
|
||||
- **Copy buttons**: Quick copy of current IP or gateway to clipboard
|
||||
|
||||
## Tools Tab
|
||||
|
||||
### Ping Tool
|
||||
- Enter an IP address or hostname in the "Target IP/Host" field
|
||||
- Click "Ping" to send echo requests
|
||||
- Enable "Continuous Ping" to keep pinging until stopped
|
||||
- "Last RTT" shows the most recent ping response time
|
||||
- Use "Stop" to end continuous pinging
|
||||
|
||||
### Network Scanner
|
||||
- Define an IP range (Start IP, End IP) or use the CIDR field
|
||||
- Click "Start Scan" to discover active hosts in the specified range
|
||||
- The scan progress bar shows completion status
|
||||
- Results appear in the table with IP addresses and ping times
|
||||
- Click "Get Host Info" to retrieve hostnames and MAC addresses
|
||||
- MAC vendors are automatically identified (when available)
|
||||
|
||||
## Network Scanning
|
||||
|
||||
### Scan Process
|
||||
1. Define the IP range to scan
|
||||
2. Start the scan to discover active hosts
|
||||
3. Use "Get Host Info" to gather detailed information about discovered hosts
|
||||
|
||||
### Scan Results
|
||||
The scan results display:
|
||||
- IP Address
|
||||
- Ping time (ms)
|
||||
- Hostname (when resolved)
|
||||
- MAC Address (when available)
|
||||
- MAC Vendor (manufacturer)
|
||||
|
||||
## Administrator Privileges
|
||||
|
||||
Administrator privileges are required to change network settings on Windows. When you attempt to change network settings, the application will:
|
||||
|
||||
1. Launch a separate script with administrator privileges
|
||||
2. Execute the appropriate network commands
|
||||
3. Log the results
|
||||
|
||||
### How It Works
|
||||
The main application (`menu-ip-change.py`) uses a helper script (`ip-changer-admin.py`) to execute network configuration commands with elevated privileges. This helper script is launched using the Windows `ShellExecuteW` API with the "runas" verb.
|
||||
|
||||
## Configuration Files
|
||||
|
||||
The application stores configuration in several JSON files:
|
||||
|
||||
### ip_config.json
|
||||
Stores:
|
||||
- Last used interface
|
||||
- Last used IP prefix
|
||||
- Previous configuration (for restore function)
|
||||
- Last used subnet mask
|
||||
|
||||
### ip_history.json
|
||||
Stores a history of previously used IP addresses and their subnet masks.
|
||||
|
||||
### ping_targets.json
|
||||
Stores preferred ping targets for each IP prefix.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Common Issues
|
||||
|
||||
#### Unable to Change Network Settings
|
||||
- Ensure you have administrator privileges
|
||||
- Check the operation log for specific error messages
|
||||
- Verify the interface name is correct
|
||||
|
||||
#### Network Scan Not Working
|
||||
- Check firewall settings (may block ping/ICMP)
|
||||
- Ensure the IP range is correctly specified
|
||||
- Try scanning a smaller range
|
||||
|
||||
#### MAC Address Not Found
|
||||
- Some devices may not respond to ARP
|
||||
- Try using "Get Host Info" to retry MAC detection
|
||||
- Some virtualized interfaces won't return MAC addresses
|
||||
|
||||
### Log Messages
|
||||
The application maintains a detailed operation log that can help diagnose issues. Common message types:
|
||||
- INFO: Informational messages
|
||||
- ERROR: Error conditions
|
||||
- SUCCESS: Successful operations
|
||||
- DISCOVERY: Host discovery during scanning
|
||||
- PING: Ping results
|
||||
- MAC/HOSTNAME/VENDOR: Device information
|
||||
|
||||
## FAQ
|
||||
|
||||
### Q: Does this work on non-Windows systems?
|
||||
A: No, this application is designed specifically for Windows and uses Windows-specific commands.
|
||||
|
||||
### Q: Why does it need administrator privileges?
|
||||
A: Changing network settings on Windows requires elevated privileges for security reasons.
|
||||
|
||||
### Q: Can I scan large IP ranges?
|
||||
A: Yes, but scanning large ranges (thousands of IPs) may take a significant amount of time.
|
||||
|
||||
### Q: How does the continuous ping work?
|
||||
A: It sends ping requests at regular intervals (approximately once per second) until stopped.
|
||||
|
||||
### Q: How does the MAC vendor lookup work?
|
||||
A: The application uses the mac-vendor-lookup library, which contains a database of MAC address prefixes and their corresponding manufacturers.
|
||||
Loading…
Reference in New Issue