This is a lightweight, pure Python DHCP server. Originally, it required no external libraries. With the 2026 Fork, additional features (like a Flask web dashboard) were integrated. All dependencies are now vendored locally inside the vendor/ directory, meaning the server is 100% portable, offline-first, and requires no pip install commands.
- Visual Client Dashboard: Lists MAC addresses, IP leases, and hostnames in real-time.
- Smart Delay Assignment: Assigns IP addresses 10 seconds later than standard DHCP servers, allowing it to safely coexist in networks that already have a running DHCP server.
- Persistent Leases: Saves IP allocations locally to a
hosts.csvfile. - Bridges Local Connections: Perfect for testing network equipment, Wi-Fi access points (APs), and local setups without WAN access.
- Threaded Flask Server: Runs a Flask web server side-by-side with the DHCP service using native Python
threading(executable viarun.py). - Centralized Configuration: Configured via
config.py(manage port, bind address, netmask, lease time, and IP pools easily). - Modular Codebase: Organizes web views and dashboard functions under the
web_server/module. - Vendored Dependencies: Portability ensured by placing Flask, Scapy, and other modules in
vendor/to allow zero-config execution.
Open config.py and adjust the binding interface and IP range:
# Server Configuration
DHCP_BIND_ADDRESS = "192.168.1.1" # Your static IP
DHCP_NETWORK = "192.168.1.0" # Target subnet
DHCP_SUBNET_MASK = "255.255.255.0" # Subnet Mask
DHCP_LEASE_TIME = 300 # Lease time in seconds
WEB_PORT = 80 # Web Panel PortImportant
Running a DHCP server requires binding to privileged ports. You must run the script with administrative privileges.
- Windows (Administrator PowerShell/CMD):
python run.py
- Linux / macOS:
sudo python run.py
This starts both the DHCP server and the Web Dashboard (on http://<DHCP_BIND_ADDRESS>:<WEB_PORT>).
Este es un servidor DHCP ligero desarrollado puramente en Python. Originalmente no requería librerías externas. Con el Fork 2026, se integraron funcionalidades adicionales (como un panel web con Flask). Todas las dependencias vienen empaquetadas localmente dentro del directorio vendor/, lo que hace que el servidor sea 100% portable, autónomo y listo para usar sin necesidad de pip install.
- Panel de Control Visual: Muestra direcciones MAC, IPs asignadas y nombres de host de clientes en tiempo real.
- Asignación Retardada Inteligente: Asigna direcciones IP 10 segundos después de recibir la solicitud, lo que le permite coexistir de forma segura en redes que ya poseen un servidor DHCP activo.
- Arrendamientos Persistentes: Registra y recuerda las asignaciones locales en el archivo
hosts.csv. - Ideal para Laboratorios: Excelente herramienta para testear equipos de red, puntos de acceso Wi-Fi (AP) y conexiones locales sin requerir salida WAN.
- Servidor Flask Concurrente: Ejecuta la interfaz web de forma paralela al servicio DHCP mediante hilos nativos (
threading) a través del archivorun.py. - Configuración Centralizada: Control total mediante
config.py(edita puertos, subredes, máscaras, IPs de escucha y tiempos de arrendamiento). - Código Modularizado: Estructura limpia que independiza la interfaz web en la carpeta
web_server/. - Cero Instalaciones: Contiene librerías como Flask y Scapy en
vendor/para ejecutar el servidor inmediatamente fuera de línea.
Abre el archivo config.py y define los parámetros del servidor:
# Configuración del Servidor
DHCP_BIND_ADDRESS = "192.168.1.1" # Tu IP estática local
DHCP_NETWORK = "192.168.1.0" # Subred del DHCP
DHCP_SUBNET_MASK = "255.255.255.0" # Máscara de subred
DHCP_LEASE_TIME = 300 # Tiempo de arriendo (segundos)
WEB_PORT = 80 # Puerto de la interfaz webImportant
Los servidores DHCP requieren unirse a puertos con privilegios elevados. Es obligatorio ejecutar la aplicación con permisos de administrador.
- Windows (PowerShell/CMD como Administrador):
python run.py
- Linux / macOS:
sudo python run.py
*Esto iniciará concurrentemente el servidor DHCP y el panel web en http://<DHCP_BIND_ADDRESS>:<WEB_PORT>.