Dominios

La pestaña Dominios (D) lista los dominios del proyecto. Cada uno se sirve en HTTPS y se redirige a su servidor local.

La tabla de dominios

Columna	Contenido
Estado	Indicador de salud del dominio
Dominio	https://app.miproyecto.test ↗, clicable
Destino	→ localhost:5173
Iniciado por	El proceso que sirve este puerto, si lo hay
Activo	Un interruptor: un dominio desactivado deja de responder, sin eliminarse

Las acciones de cada fila: iniciar o detener el proceso, copiar la URL, eliminar el dominio.

Los estados

Estado	Significado
en línea	El servidor de desarrollo responde en su puerto
sin conexión	Nada escucha en el puerto
desactivado	El dominio está cortado (interruptor Activo)
sin proxy	El proxy está detenido: ningún dominio responde
iniciando…	El proceso que sirve este puerto se está iniciando
proceso con error	El proceso ha fallado
detenido	El proceso está detenido

Añadir un dominio

Debajo de la tabla, rellena los dos campos y pulsa + Añadir (atajo A para ir al campo):

• Subdominio o dominio completo: admin se convierte en admin.miproyecto.test; un nombre con un punto (docs.otro.test) se toma tal cual.
• Puerto: 3000 se convierte en el destino http://localhost:3000.

Los nombres admiten las letras a–z, los números y los guiones, 63 caracteres por segmento y 253 en total. Dos proyectos no pueden tener el mismo dominio.

Ajustes del framework

Debajo de los dominios, el bloque Por ajustar en el proyecto señala lo que impediría que el proyecto respondiera en su dominio, con el código que hay que añadir.

Vite y Astro: allowedHosts

Vite (y Astro, que lo usa) rechazan las peticiones dirigidas a un dominio desconocido. Joppa propone añadir:

// vite.config.ts
export default defineConfig({
  server: { allowedHosts: [".miproyecto.test"] },
});

// astro.config.mjs
export default defineConfig({
  vite: { server: { allowedHosts: [".miproyecto.test"] } },
});

Corregir el archivo abre una vista previa y luego Escribir el archivo inserta solo esas líneas; el resto del archivo no cambia. Si la configuración tiene una forma poco habitual, Joppa no la modifica: usa Copiar el código y pégalo tú. Otra opción, sin tocar el archivo: la variable __VITE_ADDITIONAL_SERVER_ALLOWED_HOSTS=.miproyecto.test.

Reinicia el servidor de desarrollo para que vuelva a leer su configuración.

Laravel detrás de un proxy

Laravel tiene que confiar en el proxy para generar URL en https://. En bootstrap/app.php:

->withMiddleware(fn ($m) => $m->trustProxies(at: '*'))

Este ajuste no se escribe automáticamente: cópialo.

Las cabeceras reenviadas

El proxy conserva la cabecera Host original (app.miproyecto.test) y añade las cabeceras X-Forwarded-*: X-Forwarded-Proto: https, X-Forwarded-Host, X-Forwarded-Port: 443 y X-Forwarded-For. Consulta Proxy HTTPS.