Portless: rutas locales con nombre
Desplegar Portless en un equipo: estado local, confianza y arranque
Planifica una integración de desarrollo repetible con opciones explícitas, compatibilidad de Node.js, responsabilidad sobre certificados y servicios reversibles.
Qué aprenderás
- Despliegue significa integración en la máquina de desarrollo
- Incluye la configuración persistida en el plan
- Autoriza los servicios persistentes por separado
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
- Una integración reproducible incluye estado de máquina, no solo dependencias.
- Puertos altos y confianza de certificados resuelven problemas diferentes.
- Instalar servicios y ejecutar clean tiene consecuencias del sistema.
Despliegue significa integración en la máquina de desarrollo
Una guía debe aclarar primero dónde encaja Portless: en una máquina de desarrollo con aplicaciones locales. El paquete fijado requiere Node.js moderno y enumera Windows, macOS y Linux. Esa declaración no demuestra que este artículo haya probado todas las combinaciones de almacén de certificados, shell, cortafuegos y framework. El equipo debe definir su propia matriz de aceptación.
Decide entre una instalación global mantenida por el equipo y una dependencia del proyecto. La segunda hace explícita la versión del repositorio, pero una persona puede ejecutar versiones distintas desde varios proyectos que comparten estado local. El README advierte de cambios posibles en el formato previo a 1.0. Registra versión de CLI y directorio de estado, no solamente el archivo de bloqueo.
Incluye la configuración persistida en el plan
El inicio automático reutiliza ajustes de la ejecución anterior del proxy; las variables PORTLESS explícitas tienen prioridad. Por tanto, reiniciar no restablece necesariamente HTTPS en 443. Un ajuste LAN recordado merece atención especial. Anota esquema, puerto, sufijos, modo LAN y directorio de estado antes de modificar un entorno de desarrollo compartido.
HTTPS por defecto puede generar y confiar en una CA local, mientras que un puerto privilegiado puede exigir elevación. Un puerto alto resuelve el problema de enlace, pero no la confianza del certificado. El ejercicio deliberado con --no-tls evita esa ruta de certificados, a costa de cambiar el origen y sus propiedades. No desactives globalmente la verificación para ocultar un fallo sin explicación.
Autoriza los servicios persistentes por separado
La instalación documentada escribe configuración de launchd, systemd o Programador de tareas de Windows y puede ejecutarse como root o SYSTEM. No equivale a un proceso de desarrollo normal en primer plano. Define ejecutable, propietario, opciones, registros y desinstalación antes de habilitar arranque automático: una petición HTTP correcta no valida ese ciclo de vida.
Usa doctor para salud y service status para inspeccionar un servicio instalado. No presentes clean como actualización inocua: elimina estado, entradas de confianza, cambios de hosts gestionados y el servicio de Portless. Esta revisión no realizó esas modificaciones. Prueba el plan de recuperación en una máquina desechable antes de aplicarlo a una estación compartida.
Pasos de implementación
- 1
Registra Node, CLI, directorio de estado y configuración actual.
- 2
Elige HTTP local o HTTPS autorizado.
- 3
Verifica rutas antes de proponer un servicio persistente.
- 4
Documenta recuperación y solicita aprobación antes de eliminar estado compartido.
Ejemplo para copiar
{
"listaDeIntegración": true,
"nodeMayorMínimo": 24,
"versiónPortless": "0.15.6",
"directorioDeEstado": "registrar ruta real",
"esquemaProxy": "elegir explícitamente",
"lanActivada": false,
"servicioAutorizado": false,
"confianzaVerificada": false
}Preguntas frecuentes
¿Puedo instalarlo directamente como entrada de producción?
La serie cubre desarrollo documentado, no una certificación de producción. Disponibilidad, autenticación y protección perimetral exigen otro diseño y validación.
¿Por qué un reinicio conserva un ajuste inesperado?
El proxy reutiliza intencionadamente la configuración anterior. Inspecciona ajustes persistidos y variables explícitas en vez de asumir que reiniciar restaura valores predeterminados.
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