DocsConfiguraciónVariables de entorno

Variables de entorno

La referencia completa de variables de entorno de vuzon — dos obligatorias y el resto pensadas por defecto para un homelab con HTTP plano.

Obligatorias

El acceso al panel no es una variable de entorno — lo eliges en el navegador en la primera visita.

Variable	Propósito
`CF_API_TOKEN`	Token de API de Cloudflare con los tres permisos de Token de API.
`DOMAIN`	Apex de la zona en Cloudflare; sirve para resolver zona/cuenta si no hay IDs.

.env

# El dominio de correo que gestionas en Cloudflare, p. ej. midominio.dev
DOMAIN=

# Token de API de Cloudflare (ver la página Token de API)
CF_API_TOKEN=

Opcionales

Los valores por defecto están pensados para un homelab con HTTP plano.

Variable	Por defecto	Propósito
`VUZON_PORT`	`8001`	Puerto TCP del anfitrión asignado a la app.
`VUZON_DATA_DIR`	`/app/data` (Docker)	Dónde guarda el panel sus credenciales (con hash) y su clave de sesión. Debe ser escribible y sobrevivir a los reinicios. Desde el código fuente, por defecto `./data`.
`COOKIE_SECURE`	off	Pon `1` para marcar la cookie de sesión como `Secure` (HTTPS / proxy con TLS). Desactivado por defecto para que funcione el HTTP de homelab.
`TRUST_PROXY`	off	Defínelo detrás de un proxy inverso para que la IP real del cliente llegue al rate limit del login — ver Reverse proxy y TLS.
`CF_ZONE_ID`	auto	Solo hace falta cuando la autodetección desde `DOMAIN` falla; defínelo junto a `CF_ACCOUNT_ID`.
`CF_ACCOUNT_ID`	auto	Ver arriba.

Si la autodetección a partir de DOMAIN falla: añade CF_ZONE_ID y CF_ACCOUNT_ID a tu .env — no están en la plantilla, solo hacen falta si el error de arranque te los pide. La autodetección también se detiene si hay dos zonas con el mismo nombre.

Desarrollo local

Con pnpm start fuera de Docker, PORT tiene prioridad sobre VUZON_PORT para el puerto de escucha. La imagen Docker fija NODE_ENV=production; las cookies siguen siendo usables por HTTP salvo que actives COOKIE_SECURE=1. Otras variables orientadas a desarrollo (VUZON_PUBLIC_DIR) están en el CONTRIBUTING del repositorio.