Portless: rutas locales con nombre
Primeros pasos con Portless: nombres, parámetros y una petición comprobable
Inicia una aplicación con nombre, separa el puerto del proxy del puerto interno y diagnostica scripts que no admiten la inyección automática de parámetros.
Qué aprenderás
- Empieza con una orden que puedas explicar
- La inyección automática reconoce una gramática limitada
- Demuestra la ruta antes de añadir automatización
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
- El puerto del proxy y el de la aplicación tienen funciones distintas.
- Los scripts no clasificados no se reescriben silenciosamente.
- El listener real y la tabla de rutas son evidencia de diagnóstico.
Empieza con una orden que puedas explicar
La guía propone instalar Portless y ejecutar un nombre explícito seguido del comando de desarrollo, como portless myapp next dev. Es una instalación y una acción de configuración local, no un diagnóstico de solo lectura. Revisa la versión, el requisito Node.js 24 y los permisos iniciales de certificados antes de hacerlo en un equipo de trabajo. Los comandos incluidos son un ejemplo opcional, no acciones realizadas en esta revisión.
Para un ejercicio HTTP con menos privilegios, inicia el proxy en 1355 sin TLS y una aplicación desechable en otro terminal. La URL del navegador incluye :1355, que identifica al proxy y no al puerto asignado dinámicamente a la aplicación. HTTP ayuda a diagnosticar rutas, pero no equivale a probar cookies Secure, confianza de certificados o todas las capacidades del navegador.
La inyección automática reconoce una gramática limitada
Portless establece PORT para los procesos hijos. Cuando un framework compatible necesita opciones de línea de comandos, cli-utils.ts añade un --port ausente y, a veces, --host. Distingue comandos que sirven contenido de compilaciones y comprobaciones. Reconocer Vite no justifica pasar un puerto de servidor a vite build; también importan las opciones explícitas ya presentes.
Un script con prefijo de entorno, delegación a otro script, órdenes compuestas, comentario final o terminador de opciones propio puede quedar intacto. Así se evita añadir argumentos a la orden equivocada o dentro de un comentario. Si el puerto anunciado no coincide con el listener, simplifica el script o configúralo explícitamente; reiniciar repetidamente el proxy no cambia esa limitación sintáctica.
Demuestra la ruta antes de añadir automatización
Consulta portless list y utiliza portless doctor, documentado como diagnóstico de solo lectura. Confirma que la aplicación funciona y comprueba esquema, nombre y puerto en el navegador. Un 404 generado por el proxy sugiere ausencia de ruta; un 502 indica que el servidor loopback seleccionado no resulta accesible. Mira la salida de la aplicación antes de atribuir ambos a DNS.
Cuando funcione el nombre explícito, considera portless run para inferencia y prefijos de árboles de trabajo. Mantén reversible el ejercicio: detén tu aplicación y proxy sin limpiar estado compartido ajeno. La prueba de la biblioteca verifica enrutamiento, no este flujo completo de instalación ni todas las combinaciones de inyección de parámetros en cada sistema operativo.
Pasos de implementación
- 1
Revisa e instala la versión elegida en un entorno autorizado.
- 2
Inicia un proxy HTTP en un puerto no privilegiado.
- 3
Lanza una aplicación desechable con nombre explícito en otro terminal.
- 4
Comprueba list, doctor y la URL antes de automatizar árboles de trabajo.
Ejemplo para copiar
# Ejemplo opcional; no ejecutado en esta revisión
npm install -g portless@0.15.6
portless proxy start --no-tls --port 1355
# En otro terminal, dentro de un proyecto Next.js desechable:
portless myapp next dev
# Abre http://myapp.localhost:1355
portless list
portless doctorPreguntas frecuentes
¿Por qué mi script conserva el puerto anterior?
El inyector puede no reconocer la sintaxis o rechazar la adición insegura de argumentos. Inspecciona el script y el listener, y simplifica o fija su puerto.
¿El ejemplo HTTP demuestra que HTTPS funciona?
No. HTTPS añade generación, confianza y validación de certificados. Comprueba esas partes por separado tras aceptar sus cambios locales.
Fuentes
- README.mdFuente verificada 2026-09-08
- packages/portless/package.jsonFuente verificada 2026-09-08
- packages/portless/src/cli-utils.tsFuente verificada 2026-09-08
- packages/portless/src/proxy.tsFuente verificada 2026-09-08