Portless: rutas locales con nombre
Qué es Portless: URL locales estables sin hacer desaparecer los puertos
Aprende cómo Portless nombra aplicaciones de desarrollo y por qué los puertos internos, HTTPS local, las ramas y el acceso público son decisiones distintas.
Qué aprenderás
- El nombre es estable; el puerto deja de ser la interfaz
- Elige conscientemente la identidad de desarrollo
- Distingue las clases de evidencia
Antes de empezar
- Conceptos de orígenes HTTP, puertos y terminal
- Distinguir loopback, LAN y exposición pública
Traza una petición, define límites de instalación y separa comportamiento observado de integraciones no probadas.
Conclusiones clave
- Los nombres estables ocultan la asignación al lector; no eliminan puertos.
- Un nombre de árbol de trabajo no aísla todos los recursos.
- Enrutamiento local, confianza de certificados y exposición remota son límites distintos.
El nombre es estable; el puerto deja de ser la interfaz
Portless ofrece a una aplicación de desarrollo una dirección legible, como https://shop.localhost. Un proxy local recibe la petición, busca el nombre de host y la reenvía al puerto de la aplicación en loopback. Los puertos siguen existiendo: las personas, los marcadores y los agentes pueden utilizar un nombre en vez de recordar qué número estaba disponible al iniciar el proceso.
Imagina un frontend y una API que intentan usar el puerto 3000. Cambiar uno resuelve la colisión inmediata, pero puede invalidar una devolución de autenticación o una instrucción de prueba compartida. Las rutas con nombre separan esa identidad visible de la asignación de procesos. No reescriben automáticamente la configuración, los permisos CORS ni las devoluciones registradas con proveedores externos.
Elige conscientemente la identidad de desarrollo
El lanzador documentado asigna un puerto de aplicación disponible entre 4000 y 4999. Un nombre explícito facilita el primer experimento; la inferencia de nombres y los prefijos de rama ayudan con varios árboles de trabajo. Ese prefijo es una identidad de enrutamiento, no una demostración de aislamiento de cookies, bases de datos o credenciales entre copias.
En la revisión fijada, el paquete indica versión 0.15.6, Node.js 24 o posterior y licencia Apache-2.0. La CLI utiliza HTTPS por defecto, con generación y confianza de certificados locales. También permite HTTP en un puerto elegido. Estos modos tienen comportamientos de navegador y permisos diferentes; no constituyen una garantía de instalación sin configuración en cualquier equipo.
Distingue las clases de evidencia
La serie sigue archivos fijados a un commit, no solamente un README cambiante. Un experimento acotado transpiló los módulos inspeccionados sin modificar su comportamiento y aprobó 24 casos HTTP/1.1 con dos servidores loopback desechables. Comprobó rutas, cabeceras reenviadas y autorización interna de sincronización de hosts sin modificar realmente el archivo hosts del sistema.
El experimento no instaló la CLI, no añadió confianza de certificados, no abrió túneles públicos ni probó HTTP/2 o recarga en caliente de un framework. Son funciones documentadas que necesitan comprobaciones de integración propias. La primera aceptación debe ser concreta: el nombre esperado alcanza la aplicación correcta, un nombre desconocido falla y el efecto de detener la aplicación resulta comprensible.
Pasos de implementación
- 1
Anota un nombre y su servidor esperado.
- 2
Comprueba Node.js y elige HTTP o HTTPS conscientemente.
- 3
Inspecciona la ruta activa y solicita su URL.
- 4
Registra aparte las funciones de navegador, framework y acceso compartido no probadas.
Ejemplo para copiar
{
"ejemplo": "enrutamiento conceptual, no configuración",
"origenDelNavegador": "https://shop.localhost",
"nombreDeRuta": "shop.localhost",
"servidor": "127.0.0.1:<puerto-asignado>",
"losPuertosSiguenExistiendo": true
}Preguntas frecuentes
¿Portless es una plataforma de alojamiento de producción?
Su flujo documentado se centra en desarrollo local. Estas pruebas no lo certifican como entrada de producción ni ofrecen una receta de alojamiento productivo.
¿Un nombre estable arregla CORS automáticamente?
No. CORS, cookies y listas de devoluciones autorizadas pertenecen a la aplicación y al proveedor. Cambiar el origen puede exigir actualizaciones explícitas.
Fuentes
- README.mdFuente verificada 2026-09-08
- packages/portless/package.jsonFuente verificada 2026-09-08
- LICENSEFuente verificada 2026-09-08
- packages/portless/src/proxy.tsFuente verificada 2026-09-08