¿Qué hace portless?
Configura y utiliza portless para obtener URLs de servidor de desarrollo local con nombre (por ejemplo, https://miapp.localhost en lugar de http://localhost:3000). Úsalo al integrar portless en un proyecto, configurar nombres de servidor de desarrollo, configurar el proxy local, trabajar con dominios .localhost o solucionar problemas de puerto/proxy.
Requisitos previos
- Node.js 18 o superior
- npm, yarn o pnpm
- Un proyecto con servidor de desarrollo local (Vite, Next.js, CRA, etc.)
Instalación
npm install -g @vercel/portless
O si prefieres usarlo sin instalación global:
npx @vercel/portless
Uso básico
- Navega a la raíz de tu proyecto:
cd mi-proyecto
- Inicia tu servidor de desarrollo (por ejemplo, con Vite):
npm run dev
- En otra terminal, ejecuta portless:
portless --name miapp
Ahora podrás acceder a tu aplicación en https://miapp.localhost.
Configuración avanzada
Puerto personalizado
Si tu servidor de desarrollo usa un puerto diferente al predeterminado (3000), especifícalo con:
portless --name miapp --port 5173
Múltiples proyectos
Puedes ejecutar portless para múltiples proyectos simultáneamente, cada uno con su propio nombre:
# Terminal 1
cd proyecto-a && portless --name proyecto-a
# Terminal 2
cd proyecto-b && portless --name proyecto-b
Solución de problemas
Error: puerto en uso
Si el puerto 443 está en uso (común en macOS por AirPlay Receiver), desactívalo en:
- macOS: Preferencias del Sistema → General → AirDrop y Handoff → desmarca "Permitir AirPlay Receiver"
- Linux:
sudo systemctl stop apache2o libera el puerto manualmente
Error: certificado SSL no válido
Asegúrate de visitar https:// (no http://). Si ves una advertencia de seguridad, confíala manualmente (es un certificado autofirmado para desarrollo).
Error: dominio .localhost no resuelve
Portless utiliza automáticamente un proxy DNS local. Si no funciona, prueba reiniciar el navegador o agregar una entrada en /etc/hosts:
127.0.0.1 miapp.localhost
Compatibilidad
- Navegadores: Chrome, Firefox, Safari, Edge (todos soportan .localhost)
- Frameworks: Cualquier framework con servidor de desarrollo (Vite, Next.js, React, Vue, Svelte, etc.)
- Sistemas operativos: macOS, Linux, Windows (con WSL recomendado)