Ajustes
Todos los ajustes que lee el sitio, su valor por defecto y cómo cambiarlos con Docker y sin él.
Los ajustes
Todos los ajustes son opcionales: el sitio funciona sin ninguno.
| Variable | Valor por defecto | Qué hace |
|---|---|---|
NEXT_PUBLIC_SITE_URL | http://localhost:3030 | La dirección pública del sitio, con https:// y sin barra al final. Los enlaces canónicos, los enlaces entre los dos idiomas, el sitemap, robots.txt y las tarjetas para compartir en redes sociales se generan a partir de ella. Defínela con tu dominio antes de publicar. |
NEXT_PUBLIC_BUY_URL | vacío | Cuando se define, una franja al final del pie de página muestra un botón "Buy This Template" que abre esta dirección en una pestaña nueva. Déjala vacía. |
BUILD_STANDALONE | vacío | true construye un servidor autónomo en .next/standalone. El Dockerfile lo define por ti. Déjalo vacío para yarn start. |
Sin Docker
Copia .env.example a .env.local y edita allí los valores. Deja .env.example como está, como lista de lo que existe.
Nextjs-landing-page-template-2cp .env.example .env.localNEXT_PUBLIC_SITE_URL=https://www.your-domain.comCon Docker
La construcción de la imagen no lee los archivos .env ni .env.local. Pasa cada valor como argumento de construcción:
Nextjs-landing-page-template-2docker build -t analytics-landing --build-arg NEXT_PUBLIC_SITE_URL=https://www.your-domain.com .El sitio dentro del contenedor siempre escucha en el puerto 3030. Para usar otro puerto en tu equipo, cambia el número de la izquierda de -p al iniciarlo.
Cuándo surte efecto un cambio
Los valores que empiezan por NEXT_PUBLIC_ se compilan en el JavaScript que carga el navegador cuando se construye el sitio. Cambiar uno no cambia nada hasta que se vuelve a construir el sitio:
| Cómo lo ejecutas | Después de cambiar un valor |
|---|---|
yarn dev | Detén el servidor y ejecuta yarn dev de nuevo. |
yarn build y yarn start | Vuelve a ejecutar yarn build y luego yarn start. |
| Docker | Vuelve a construir la imagen con el valor como --build-arg y luego inicia un contenedor nuevo. |
| Vercel | Cámbialo en Environment Variables del proyecto y vuelve a desplegar. |
Nunca pongas un secreto en un valor NEXT_PUBLIC_: cualquier visitante puede leerlo en el código de la página. Las claves de tus propios servicios van en tu servidor.
La construcción autónoma
Con BUILD_STANDALONE=true, yarn build escribe un servidor que no necesita node_modules en .next/standalone. El Dockerfile lo usa para mantener la imagen pequeña. yarn start no está pensado para ese tipo de construcción y avisa "next start" does not work with "output: standalone" configuration. Deja la variable vacía a menos que copies tú mismo la carpeta standalone a un servidor.