“Address Already in Use”: Una guía simple para liberar puertos
octubre 14, 2025 | by lgonzalezmelendrez@gmail.com
Como desarrollador, no hay nada tan frustrante como estar listo para lanzar su aplicación, sólo para ser recibido con un error como EADDRINUSE. Este mensaje de error común indica que el puerto que está intentando utilizar ya está ocupado por otro proceso. En este post, vamos a ir a través de los pasos que puede tomar para identificar y matar el proceso que está ocupando el puerto, si usted está en un Mac, Linux o Windows.
¿Qué significa EADDRINUSE?
El error EADDRINUSE suele producirse cuando se intenta iniciar un servidor en un puerto específico, pero ese puerto ya está siendo utilizado por otro proceso. Este error es común en varios lenguajes y frameworks, incluyendo Node.js, Express.js, y en este caso, un contenedor de docker.
He aquí un ejemplo del error EADDRINUSE:
docker run -it –rm –name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n
docker: Error response from daemon: failed to set up container networking: driver failed programming external connectivity on endpoint n8n (9befed345c4ba74c64b2e0e59f83a53eeccc0bbe16b5b6fbb96c87cb2c912daa): failed to bind host port for 0.0.0.0:5678:172.17.0.2:5678/tcp: address already in use
Identificar el proceso
Para liberar el puerto, primero tenemos que identificar el proceso que lo está utilizando. A continuación te explicamos cómo hacerlo en diferentes sistemas operativos:
Mac/Linux:
Abre tu terminal y escribe
sudo lsof -i :5678
Este comando le dará una lista de los procesos que utilizan el puerto 9323, junto con su PID (Process ID).
Matar el proceso
Una vez que tenga el PID, puede matar el proceso:
Mac/Linux:
Supongamos que el PID que encontraste fue 27924, escribirías:
kill -9 27924
Más vale prevenir que curar
Aunque es bueno saber cómo solucionar el error EADDRINUSE, es aún mejor evitar que se produzca. Presta atención a los puertos que utilizan tus aplicaciones y asegúrate de cerrarlos cuando termines.
Conclusión
El error EADDRINUSE puede ser un obstáculo en su viaje de codificación, pero no es insuperable. Con un poco de conocimiento del terminal, puedes identificar y eliminar rápidamente el proceso malicioso. Así, la próxima vez que aparezca este error, sabrás exactamente qué es lo que hay que hacer.
RELATED POSTS
View all