Flags de funcionalidad y entorno
Los ajustes de entorno que un despliegue autoalojado de dForms puede cambiar y que tu gente sí nota: el formulario de demo inicial, las funciones premium, la insignia Hecho con dForms, los IDs de segu
Un despliegue autoalojado se configura entero con variables de entorno. La mayoría son fontanería (base de datos, puertos y secretos) y se cubren en Autoalojamiento. Esta página lista las que cambian lo que ve la gente, para que sepas por qué tu instancia se comporta distinto a app.dforms.ai.
Ninguna de estas aplica al producto alojado: en app.dforms.ai estas decisiones ya están tomadas por ti.
⚠️ Nota: Todo lo que empieza por
NEXT_PUBLIC_es un valor de construcción, horneado en la imagen web al construirla. Cambiarlo significa reconstruir y redesplegar la imagen web, no reiniciar un contenedor.
Workspaces nuevos
SEED_DEMO_FORM
true
Si un workspace recién creado arranca con un formulario de demo listo para trastear, o con una lista de Formularios vacía. Ponlo en false para entregar workspaces vacíos. Otros ajustes de primer arranque pueden tener precedencia sobre él: .env.example detalla la interacción exacta.
Funciones premium
dForms en sí es gratis y no tiene planes que desbloquear. La verja existe solo para que un despliegue pueda poner sus propios derechos delante de los extras opcionales.
PREMIUM_FEATURES
open
open desbloquea todo, que es lo que recibe una bifurcación y casi seguro lo que quieres. locked comprueba cada función contra un servicio de derechos.
ENTITLEMENTS_API_URL
sin definir
Solo se necesita con PREMIUM_FEATURES=locked: el servicio que responde a la comprobación de derechos.
ENTITLEMENTS_API_KEY
sin definir
La credencial de ese servicio. Solo se necesita con PREMIUM_FEATURES=locked.
Nombres y enlaces cruzados
NEXT_PUBLIC_PRODUCT_NAME
Forms
El nombre del producto que se muestra por la interfaz.
NEXT_PUBLIC_PLATFORM_URL
vacío
Añade la fila de la plataforma al selector de apps. Sin definir no renderiza ni eso ni el elemento de navegación de la plataforma.
NEXT_PUBLIC_CALENDARS_URL
vacío
Añade un enlace de calendarios al selector de apps.
IDs de seguimiento de todo el despliegue
Estas son las etiquetas de marketing que se renderizan solo en las páginas públicas de formulario, nunca en el panel. Cada etiqueta se carga solo cuando su ID está definido, así que un despliegue con todas sin definir no carga ningún script de seguimiento. El único otro script de terceros que puede cargar un formulario público es la verificación de la protección contra spam, y solo en un formulario que la active. Son valores por defecto para todo el despliegue, y los ajustes propios de un formulario en Conectar los anulan formulario por formulario. Mira Seguimiento y píxeles.
NEXT_PUBLIC_GTM_ID
Carga un contenedor de Google Tag Manager en cada página pública de formulario.
NEXT_PUBLIC_META_PIXEL_ID
Dispara un PageView del píxel de Meta por visita.
NEXT_PUBLIC_POSTHOG_KEY
Captura una pageview de PostHog por visita.
NEXT_PUBLIC_POSTHOG_HOST
La URL de ingesta de PostHog. Por defecto la nube de PostHog en EE. UU., así que defínela para un proyecto en la UE o autoalojado.
NEXT_PUBLIC_HUBSPOT_TRACKING_ID
Carga el código de seguimiento de HubSpot de tu portal en las páginas públicas de formulario.
⚠️ Nota: Estas etiquetas pertenecen a quien es dueño del formulario y miden a quienes responden. No son la analítica de producto de tu propio despliegue, que es un conjunto de variables aparte con nombres deliberadamente distintos para que las dos nunca puedan apuntar a la misma clave.
Correo
No se envía ningún correo hasta que eliges un proveedor. Hasta entonces, los avisos de respuesta se escriben en el log de la API, así que un despliegue nuevo funciona igual de punta a punta.
EMAIL_PROVIDER
log-only
log-only imprime los avisos en el log, noop los descarta en silencio, smtp envía por SMTP, http manda cada mensaje a una API de correo. Hasta que esto se defina, los correos de respuesta no llegan nunca.
MAIL_FROM_EMAIL
forms@example.com
La dirección del remitente en cada correo. Cámbiala antes de enviar nada real.
MAIL_FROM_NAME
Forms
El nombre del remitente que se ve en la bandeja.
Límites de tasa y destinos
RATE_LIMIT_ENABLED
true
Si los endpoints públicos de formulario y de envío se limitan siquiera.
RATE_LIMIT_CAPACITY
60
El margen de ráfaga por dirección IP de cliente.
RATE_LIMIT_REFILL_PER_SEC
1
Con qué rapidez se recupera ese margen. Mira API pública y límites de tasa.
TRUST_PROXY_HOPS
1 cuando hay una URL pública definida, si no 0
Cuántos proxies de confianza hay delante de la API. Ponlo mal y cada visitante comparte un solo cubo, así que quienes responden de verdad empiezan a ver errores de límite.
HUBSPOT_PRIVATE_APP_TOKEN
sin definir
Ponlo y HubSpot funciona para todo el despliegue: la página de Conexiones muestra La da el servidor en lugar de pedirle a cada cuenta que conecte. Sin definir, la tarjeta de HubSpot reporta un estado desactivado claro.
Subida de archivos
La pregunta Subir archivo solo existe en un despliegue que tenga dónde poner los archivos. STORAGE_BUCKET es el interruptor: sin él, que es lo que trae un fork limpio, el tipo de pregunta no se puede publicar y el endpoint de subida responde 404, así que un clon sin bucket funciona igual de principio a fin.
STORAGE_BUCKET
sin valor
El bucket donde se escriben las subidas. Ponerlo activa la pregunta Subir archivo en todo el despliegue.
STORAGE_REGION
us-east-2
La región del bucket. Si no coincide, la petición falla en vez de escribir en otro lado.
STORAGE_PROVIDER
sin valor
Ponlo en none para dejar el bucket configurado pero apagar la función. No es la forma de encenderla: eso lo hace el bucket.
STORAGE_ENDPOINT
sin valor
Apúntalo a un servicio compatible con S3 como Cloudflare R2 o MinIO. La mayoría de servidores autoalojados también necesitan STORAGE_FORCE_PATH_STYLE=true.
STORAGE_ACCESS_KEY_ID / STORAGE_SECRET_ACCESS_KEY
sin valor
Solo para un despliegue sin rol de instancia o de carga que adjuntar. En un pod con rol, déjalos vacíos y el SDK encuentra las credenciales solo.
UPLOAD_MAX_FILE_MB
10
El tope duro por archivo. Quien construye el formulario puede pedir menos en su pregunta, nunca más.
UPLOAD_PRESIGN_TTL_SEC
600
Cuánto vale una dirección de subida.
UPLOAD_DOWNLOAD_TTL_SEC
300
Cuánto vale un enlace para volver a leer un archivo.
El navegador sube directo al bucket, así que las reglas CORS del bucket tienen que permitir el origen desde el que sirves los formularios. Permite PUT para la subida, y también GET si quieres que los documentos de Word se previsualicen en el panel, porque ese es el único tipo que el panel descarga en vez de apuntarle el navegador.
Protección contra spam
El interruptor Protección contra spam (captcha) de la pestaña Conectar de un formulario solo funciona en un despliegue con claves de Cloudflare Turnstile. Las dos claves sin definir, que es lo que trae un fork limpio, significa que la función no existe: el interruptor muestra Este despliegue no tiene configurada la protección contra spam. y ningún formulario carga nada de Cloudflare. Mira Protección contra spam (captcha) para ver qué hace la verificación.
CAPTCHA_SITE_KEY
sin definir
Junto con CAPTCHA_SECRET_KEY, enciende la función. Es pública a propósito: llega al navegador dentro de los datos del formulario publicado, nunca por un valor de construcción NEXT_PUBLIC_.
CAPTCHA_SECRET_KEY
sin definir
El secreto con el que la API comprueba cada verificación. Nunca sale de la API.
CAPTCHA_PROVIDER
sin definir
Ponlo en none para dejar las claves cargadas pero apagar la verificación en todas partes. No es la forma de encenderla: eso lo hacen las claves.
CAPTCHA_VERIFY_TIMEOUT_MS
2500
Cuánto espera la API a Cloudflare en cada intento, como máximo 4000. Tras una caída sigue un reintento, dentro de un total de 4 segundos.
Unas reglas que conviene cumplir:
Define las dos claves o ninguna. Una clave sin la otra impide que la API arranque, y lo mismo pasa con
CAPTCHA_PROVIDER=turnstilesin ellas. Solo la API las necesita; la app web no necesita nada.Registra el host correcto. Crea un widget Managed en Cloudflare para el host desde el que se sirven tus formularios, el host de
PUBLIC_APP_URL. La API comprueba que cada token se emitió ahí. Los formularios insertados en otros sitios no necesitan nada más, porque la verificación corre dentro del marco propio del formulario.Deja pasar el tráfico. La API tiene que poder llegar a
https://challenges.cloudflare.com. Si un proxy delante de la app web define una Content-Security-Policy, permitehttps://challenges.cloudflare.comenscript-srcyframe-src.Deja las claves de prueba fuera de producción. Las claves de prueba de Cloudflare son para ejecuciones locales y de CI. La API registra un aviso cuando arranca con un secreto de prueba, porque ese secreto acepta cualquier token.
Dónde está la lista completa
Estas son las que ve la gente. La referencia completa, incluidos todos los secretos, puertos y ajustes de base de datos, vive en el repositorio:
.env.example: cada variable con su valor por defecto y una explicación en línea de lo que hace.SELF-HOSTING.md: las mismas variables agrupadas por tema, con las obligatorias para un despliegue real señaladas.
Los ajustes del servidor se validan al arrancar la API. Un valor incorrecto, como una clave de protección contra spam sin la otra, detiene el arranque con un mensaje que nombra la variable y el motivo, en lugar de levantarse en un estado roto.
Qué sigue
Autoalojamiento: el despliegue en sí.
API pública y límites de tasa: qué hacen de verdad los ajustes de límite de arriba.
Seguimiento y píxeles: la versión por formulario de los IDs de seguimiento.
Última actualización