| Variable de entorno | Descripción | Valor predeterminado | Obligatoria | Ejemplo |
|---|---|---|---|---|
| Configuración principal | ||||
| PUBLIC_ORIGIN | Origen público para generar URL completas; debe establecerse en la dirección de acceso a tu aplicación | - | Sí | https://app.teable.ai |
| SECRET_KEY | Secreto raíz para JWT, sesiones y uso compartido. Genera un valor aleatorio seguro | - | Sí | openssl rand -base64 32 |
| BACKEND_JWT_SECRET | Firma los JWT de autenticación, uso compartido y plugins. Utiliza SECRET_KEY como alternativa | SECRET_KEY | - | openssl rand -base64 32 |
| BACKEND_SESSION_SECRET | Firma las cookies de las sesiones de inicio de sesión. Utiliza SECRET_KEY como alternativa | SECRET_KEY | - | openssl rand -base64 32 |
| BACKEND_STORAGE_ENCRYPTION_KEY | Cifra los tokens de acceso a adjuntos. Es obligatoria cuando BACKEND_STORAGE_PROVIDER es local | - | Sí | Cadena aleatoria de 16 caracteres |
| BACKEND_STORAGE_ENCRYPTION_IV | Vector de inicialización de cifrado asociado a BACKEND_STORAGE_ENCRYPTION_KEY | - | Sí | Cadena aleatoria de 16 caracteres |
| BACKEND_ACCESS_TOKEN_ENCRYPTION_KEY | Cifra los tokens de acceso personales | - | Sí | Cadena aleatoria de 16 caracteres |
| BACKEND_ACCESS_TOKEN_ENCRYPTION_IV | Vector de inicialización de cifrado asociado a BACKEND_ACCESS_TOKEN_ENCRYPTION_KEY | - | Sí | Cadena aleatoria de 16 caracteres |
| PORT | Puerto en el que se ejecuta la aplicación | 3000 | - | 3000 |
| LOG_LEVEL | Nivel de registro; opciones: fatal, error, warn, info, debug, trace | info | - | debug |
| Configuración del almacenamiento | ||||
| BACKEND_STORAGE_PROVIDER | Proveedor de almacenamiento; opciones: local, minio, s3, aliyun | local | - | s3 |
| BACKEND_STORAGE_LOCAL_PATH | Ruta de almacenamiento local | .assets/uploads | - | .assets/uploads |
| BACKEND_STORAGE_PUBLIC_BUCKET | Nombre del bucket público | public | - | teable-public |
| BACKEND_STORAGE_PRIVATE_BUCKET | Nombre del bucket privado para adjuntos, archivos de aplicaciones, datos archivados y otro contenido protegido | private | - | teable-private |
| BACKEND_STORAGE_PUBLIC_URL | Sustitución de la URL pública del bucket público (opcional) | - | - | https://cdn.example.com |
| BACKEND_STORAGE_PRIVATE_BUCKET_ENDPOINT | Sustitución del endpoint del bucket privado (opcional) | - | - | https://private-bucket.endpoint |
| BACKEND_STORAGE_S3_REGION | Región de almacenamiento S3, obligatoria cuando BACKEND_STORAGE_PROVIDER es s3 | - | - | us-east-2 |
| BACKEND_STORAGE_S3_ENDPOINT | Endpoint de almacenamiento S3, obligatorio cuando BACKEND_STORAGE_PROVIDER es s3 | - | - | https://s3.us-east-2.amazonaws.com |
| BACKEND_STORAGE_S3_INTERNAL_ENDPOINT | Endpoint interno de S3 (opcional) | - | - | http://s3.internal |
| BACKEND_STORAGE_S3_FORCE_PATH_STYLE | Utiliza URL con estilo de ruta (endpoint/bucket/key) para las solicitudes S3 del navegador. Actívala cuando el endpoint público no pueda servir subdominios de buckets. No se puede combinar con BACKEND_STORAGE_PRIVATE_BUCKET_ENDPOINT | false | - | true |
| BACKEND_STORAGE_S3_INTERNAL_FORCE_PATH_STYLE | Sustituye el direccionamiento con estilo de ruta para las solicitudes S3 internas. Si no se establece, hereda el ajuste público cuando ambos clientes comparten un endpoint; un endpoint interno independiente conserva el direccionamiento por host virtual | - | - | true |
| BACKEND_STORAGE_S3_ACCESS_KEY | Clave de acceso al almacenamiento S3, obligatoria cuando BACKEND_STORAGE_PROVIDER es s3 | - | - | your_access_key |
| BACKEND_STORAGE_S3_SECRET_KEY | Clave secreta del almacenamiento S3, obligatoria cuando BACKEND_STORAGE_PROVIDER es s3 | - | - | your_secret_key |
| BACKEND_STORAGE_S3_MAX_SOCKETS | Número máximo de sockets de S3 (opcional) | 100 | - | 100 |
| BACKEND_STORAGE_MINIO_ENDPOINT | Endpoint de almacenamiento de MinIO | - | - | minio.example.com |
| BACKEND_STORAGE_MINIO_PORT | Puerto de MinIO | 9000 | - | 443 |
| BACKEND_STORAGE_MINIO_USE_SSL | Indica si MinIO utiliza SSL | false | - | true |
| BACKEND_STORAGE_MINIO_ACCESS_KEY | Clave de acceso de MinIO | - | - | access-key |
| BACKEND_STORAGE_MINIO_SECRET_KEY | Clave secreta de MinIO | - | - | secret-key |
| BACKEND_STORAGE_MINIO_INTERNAL_ENDPOINT | Endpoint interno de MinIO (opcional, sin HTTPS) | - | - | minio.internal |
| BACKEND_STORAGE_MINIO_INTERNAL_PORT | Puerto interno de MinIO (opcional) | 9000 | - | 9000 |
| BACKEND_STORAGE_MINIO_REGION | Región de MinIO (opcional) | - | - | us-east-1 |
| BACKEND_STORAGE_UPLOAD_METHOD | Método de carga | put | - | put |
| STORAGE_PREFIX | Prefijo de almacenamiento; el valor predeterminado es PUBLIC_ORIGIN | PUBLIC_ORIGIN | - | http://localhost:3000 |
| Configuración de la caché | ||||
| BACKEND_CACHE_PROVIDER | Proveedor de caché; opciones: sqlite, memory, redis | sqlite | - | redis |
| BACKEND_CACHE_REDIS_URI | URI de conexión a Redis obligatoria para entregar tareas calculadas; también se utiliza para la caché cuando BACKEND_CACHE_PROVIDER es redis | - | Sí | redis://default:teable@127.0.0.1:6379/0 |
| Configuración de la caché de rendimiento | ||||
| BACKEND_PERFORMANCE_CACHE | URL de Redis para almacenar en caché los resultados de consultas, lo que mejora la eficiencia de la colaboración multiusuario. Se recomienda utilizar una instancia de Redis distinta de BACKEND_CACHE_REDIS_URI | - | - | redis://default:teable@127.0.0.1:6379/0 |
| Configuración de la autenticación | ||||
| SOCIAL_AUTH_PROVIDERS | Lista de proveedores de autenticación social separados por comas | - | - | github,google,oidc |
| BACKEND_GITHUB_CLIENT_ID | ID de cliente de OAuth de GitHub | - | - | github_client_id |
| BACKEND_GITHUB_CLIENT_SECRET | Secreto de cliente de OAuth de GitHub | - | - | github_client_secret |
| BACKEND_GOOGLE_CLIENT_ID | ID de cliente de OAuth de Google | - | - | google_client_id |
| BACKEND_GOOGLE_CLIENT_SECRET | Secreto de cliente de OAuth de Google | - | - | google_client_secret |
| BACKEND_OIDC_CLIENT_ID | ID de cliente de OIDC | - | - | google_client_id |
| BACKEND_OIDC_CLIENT_SECRET | Secreto de cliente de OIDC | - | - | google_client_secret |
| BACKEND_OIDC_CALLBACK_URL | URL de devolución de llamada de OIDC | - | - | https://app.teable.ai/api/auth/oidc/callback |
| Seguridad y verificación | ||||
| TURNSTILE_SITE_KEY | Clave de sitio de Cloudflare Turnstile para verificar la autenticación | - | - | 1x00000000000000000000AA |
| TURNSTILE_SECRET_KEY | Clave secreta de Cloudflare Turnstile para verificar la autenticación | - | - | 1x0000000000000000000000000000000AA |
| TEABLE_SSRF_PROTECTION_DISABLED | Desactiva la protección que bloquea las solicitudes salientes dirigidas a direcciones de bucle invertido, privadas, locales de enlace y otras direcciones de red reservadas. Establécela en true solo en despliegues autoalojados de confianza que deban acceder a endpoints internos | false | - | true |
| BACKEND_SIGNUP_VERIFICATION_CODE_RATE_LIMIT_SECONDS | Intervalo del límite de frecuencia (segundos) para enviar correos de verificación del registro | - | - | 30 |
| BACKEND_TRUST_PROXY | Ajuste de confianza del proxy inverso utilizado para resolver la IP del cliente situado tras un proxy. Afecta a los registros de auditoría y otros registros de seguridad relacionados. Acepta true, false, un número de saltos o una lista de IP/CIDR/valores predefinidos. Si está vacío, confía en los proxies de redes privadas | loopback, linklocal, uniquelocal | - | loopback, linklocal, uniquelocal |
| Configuración del correo electrónico (obsoleta; utiliza Administración del sistema > Ajustes de la instancia > Correo electrónico) | ||||
| BACKEND_MAIL_HOST | Dirección predeterminada del servidor de correo. Recomendamos configurar visualmente Correo de notificaciones y Correo de Automatizaciones en Administración del sistema > Ajustes de la instancia > Correo electrónico | smtp.teable.ai | - | smtp.gmail.com |
| BACKEND_MAIL_PORT | Puerto predeterminado del servidor de correo | 465 | - | 465 |
| BACKEND_MAIL_SECURE | Indica si el servicio de correo predeterminado utiliza SSL/TLS | true | - | true |
| BACKEND_MAIL_SENDER | Dirección predeterminada del remitente | noreply.teable.ai | - | noreply@company.com |
| BACKEND_MAIL_SENDER_NAME | Nombre predeterminado del remitente | Teable | - | Teable |
| BACKEND_MAIL_AUTH_USER | Nombre de usuario predeterminado para autenticar el servidor de correo | - | - | username |
| BACKEND_MAIL_AUTH_PASS | Contraseña predeterminada para autenticar el servidor de correo | - | - | usertoken |
| BACKEND_MAIL_INVITE_USER_NAME_MAX_LENGTH | Longitud máxima del nombre de quien invita en los asuntos de los correos de invitación. Un valor vacío o 0 desactiva el truncamiento | - | - | 32 |
| BACKEND_MAIL_INVITE_SPACE_NAME_MAX_LENGTH | Longitud máxima del nombre del Espacio o la Base en los asuntos de los correos de invitación. Un valor vacío o 0 desactiva el truncamiento | - | - | 32 |
| Configuración de sesiones/JWT | ||||
| BACKEND_SESSION_EXPIRES_IN | Tiempo de expiración de la sesión | 7d | - | 7d |
| BACKEND_SESSION_COOKIE_SECURE | Indica si se protege la cookie de sesión | false | - | true |
| BACKEND_SESSION_ORIGIN_CHECK_ENABLED | Activa las comprobaciones de Origin y Fetch Metadata para las solicitudes no seguras a la API que utilizan cookies de sesión del navegador. Actívala únicamente cuando tu proxy inverso o CDN conserve estos encabezados | false | - | false |
| BACKEND_JWT_EXPIRES_IN | Tiempo de expiración del JWT | 20d | - | 20d |
| BACKEND_RESET_PASSWORD_EMAIL_EXPIRES_IN | Tiempo de expiración del correo para restablecer la contraseña | 30m | - | 30m |
| Límites de recursos | ||||
| MAX_COPY_CELLS | Número máximo de celdas que se pueden copiar en una única solicitud | - | - | 50000 |
| MAX_READ_ROWS | Número máximo de filas que se pueden leer en una única solicitud | - | - | 10000 |
| MAX_ATTACHMENT_UPLOAD_SIZE | Tamaño máximo de carga de archivos adjuntos (bytes) | - | - | 2147483648 |
| TASK_MAX_FIELDS_PER_BATCH | Número máximo de Campos de IA que se envían al modelo en una solicitud por lotes. Los valores se limitan al intervalo de 1 a 20 | 5 | - | 5 |
| TASK_MAX_CONCURRENCY | Número máximo de ejecuciones pendientes de tareas de Campos de IA que se envían en un ciclo de programación. Los valores se limitan al intervalo de 1 a 20 | 5 | - | 5 |
| TABLE_LIMIT_FIELD_OPTIONS_MAX_BYTES | Número máximo de bytes de las opciones de Campo serializadas | 262144 | - | 262144 |
| TABLE_LIMIT_SELECT_CHOICES_MAX | Número máximo de opciones por Campo de selección | 1000 | - | 1000 |
| TABLE_LIMIT_SELECT_CHOICE_NAME_MAX_LENGTH | Longitud máxima del nombre de las opciones de selección | 1000 | - | 1000 |
| TABLE_LIMIT_SELECT_DEFAULT_VALUES_MAX | Número máximo de valores de selección predeterminados | 100 | - | 100 |
| TABLE_LIMIT_CELL_VALUE_MAX_BYTES | Número máximo de bytes del valor de una celda | 262144 | - | 262144 |
| TABLE_LIMIT_RECORD_FIELDS_MAX_BYTES | Número máximo de bytes de los Campos serializados de un Registro | 1048576 | - | 1048576 |
| TABLE_LIMIT_RECORDS_PER_MUTATION_MAX | Número máximo de Registros por mutación | 20000 | - | 20000 |
| TABLE_LIMIT_COMPUTED_CELL_VALUE_MAX_BYTES | Número máximo de bytes del valor de una celda calculada | 262144 | - | 262144 |
| TABLE_LIMIT_FORMULA_MAX_LENGTH | Longitud máxima de una fórmula | 8192 | - | 8192 |
| TABLE_LIMIT_TABLES_PER_BASE_MAX | Número máximo de Tablas por Base | 1000 | - | 1000 |
| TABLE_LIMIT_FIELDS_PER_TABLE_MAX | Número máximo de Campos por Tabla | 500 | - | 500 |
| TABLE_LIMIT_VIEWS_PER_TABLE_MAX | Número máximo de Vistas por Tabla | 100 | - | 100 |
| TABLE_LIMIT_CREATE_TABLE_FIELDS_MAX | Número máximo de Campos aceptados al crear una Tabla | 1000 | - | 1000 |
| TABLE_LIMIT_CREATE_TABLE_VIEWS_MAX | Número máximo de Vistas aceptadas al crear una Tabla | 20 | - | 20 |
| TABLE_LIMIT_CREATE_TABLE_RECORDS_MAX | Número máximo de Registros aceptados al crear una Tabla | 20000 | - | 20000 |
| TABLE_LIMIT_RECORDS_PER_TABLE_MAX | Número máximo de filas por Tabla. Vacío significa que no hay límite de filas a nivel de instancia | - | - | 1000000 |
| TABLE_LIMIT_VIEW_FILTER_ITEMS_MAX | Número máximo de elementos de filtro en una Vista | 100 | - | 100 |
| TABLE_LIMIT_VIEW_FILTER_DEPTH_MAX | Profundidad máxima de los filtros anidados de una Vista | 5 | - | 5 |
| TABLE_LIMIT_VIEW_SORT_ITEMS_MAX | Número máximo de elementos de ordenación de una Vista | 20 | - | 20 |
| TABLE_LIMIT_VIEW_GROUP_ITEMS_MAX | Número máximo de elementos de agrupación de una Vista | 3 | - | 3 |
| TABLE_LIMIT_VIEW_OPTIONS_MAX_BYTES | Número máximo de bytes de las opciones serializadas de una Vista | 262144 | - | 262144 |
| TABLE_LIMIT_NAME_MAX_LENGTH | Longitud máxima del nombre para mostrar de los objetos de Tabla compatibles | 100 | - | 100 |
| TABLE_LIMIT_DESCRIPTION_MAX_LENGTH | Longitud máxima de la descripción de los objetos de Tabla compatibles | 2000 | - | 2000 |
| AUTOMATION_MIN_SCHEDULED_MINUTES_INTERVAL | Intervalo mínimo (minutos) que puede utilizar un desencadenador programado con la frecuencia Minutos. Establécelo por encima de 60 para desactivar las programaciones a nivel de minutos | 10 | - | 15 |
| AUTOMATION_MIN_EMAIL_POLL_INTERVAL_MINUTES | Intervalo mínimo de consulta del buzón (minutos) que puede utilizar un desencadenador de correo electrónico | 10 | - | 15 |
| IA y App Builder (conexión con el plano de ejecución) | ||||
| SANDBOX_PROVIDER | Proveedor de entornos aislados para sesiones de IA; opensandbox conecta con un plano de ejecución autoalojado | - | - | opensandbox |
| TEABLE_INFRA_API_URL | URL de entrada del plano de ejecución; debe ser la entrada pública (dirige /v1 al motor del entorno aislado), no una dirección de servicio interna | - | - | https://infra.teable.example.com |
| TEABLE_INFRA_API_KEY | Clave de API compartida con el plano de ejecución | - | - | your-infra-api-key |
| TEABLE_INFRA_BUCKET | Bucket para el plano de datos del espacio de trabajo de IA | teable-agent | - | teable-agent |
| SANDBOX_OPENSANDBOX_IMAGE | Prefijo sin etiqueta de la imagen del agente del entorno aislado; Teable añade su propia etiqueta de versión para que el agente siempre coincida con la versión de la aplicación. Los despliegues en China utilizan el prefijo de la réplica de Aliyun | - | - | ghcr.io/teableio/teable-sandbox-agent |
| SANDBOX_OPENSANDBOX_RUNTIME | Tipo de entorno de ejecución del motor del entorno aislado: kubernetes o docker. Debe ser docker en despliegues con Docker | kubernetes | - | docker |
| SANDBOX_OPENSANDBOX_USE_SERVER_PROXY | Dirige los endpoints del entorno aislado a través del proxy basado en rutas del motor en lugar de utilizar subdominios por puerto (utilizado por el modo local de Docker) | false | - | true |
| APP_DEPLOY_PROVIDER | Sistema de despliegue de App Builder; el autoalojamiento con todas las funciones utiliza docker-runtime | vercel | - | docker-runtime |
| SANDBOX_JWT_SECRET | Secreto que firma las sesiones del entorno aislado. Genera un valor aleatorio por host y utiliza el mismo en el servicio del entorno aislado | - | Sí | cadena aleatoria |
| SANDBOX_CPU | vCPU por entorno aislado (prevalecen los ajustes de Administración del sistema) | 2 | - | 2 |
| SANDBOX_MEMORY | Memoria (GiB) por entorno aislado (prevalecen los ajustes de Administración del sistema) | 4 | - | 4 |
| SANDBOX_DISK | Disco efímero (GiB) por entorno aislado (prevalecen los ajustes de Administración del sistema) | 15 | - | 15 |
| Interruptores de funciones | ||||
| RECORD_HISTORY_DISABLED | Indica si se desactiva el historial de Registros; el valor predeterminado es false | false | - | true |
| BACKEND_STORAGE_COLD_ARCHIVE_DISABLED | Indica si se detiene el archivado programado de datos históricos. Los datos ya archivados siguen estando disponibles | false | - | true |
| PASSWORD_LOGIN_DISABLED | Indica si se desactiva el inicio de sesión mediante contraseña (OAuth y OIDC siguen disponibles) | false | - | true |
| Análisis y supervisión | ||||
| MICROSOFT_CLARITY_ID | ID de métricas de Microsoft Clarity para activar sus análisis | - | - | your-metrics-id |
| OTEL_EXPORTER_OTLP_ENDPOINT | Endpoint OTLP de OpenTelemetry | - | - | http://jaeger:4317 |
| TELEMETRY_REPORT_DISABLED | Desactiva el envío de telemetría autoalojada, incluidos los informes de cumplimiento de licencias de las instancias conectadas | false | - | true |
| Configuración de la base de datos | ||||
| PRISMA_DATABASE_URL | URL de conexión a la base de datos; debe configurarse | - | Sí | postgresql://teable:teable@127.0.0.1:5432/teable |
| PUBLIC_DATABASE_PROXY | Dirección de la base de datos accesible externamente (host:puerto) utilizada en las credenciales que genera el panel «Conexión de base de datos» de la Base; establécela para activar el acceso SQL externo de solo lectura | - | - | db.example.com:42345 |
| PRISMA_TRANSACTION_TIMEOUT | Tiempo máximo (ms) que puede ejecutarse una transacción antes de agotarse. Auméntalo para transacciones largas (por ejemplo, actualizaciones en bloque con muchas claves foráneas) | 5000 | - | 60000 |
| PRISMA_TRANSACTION_MAX_WAIT | Tiempo máximo (ms) de espera para obtener una transacción del grupo de conexiones | 2000 | - | 5000 |
| BIG_TRANSACTION_TIMEOUT | Tiempo de espera (ms) para transacciones internas grandes, como la exportación de Bases grandes | 600000 | - | 1200000 |
Secretos y rotación
Todos los valores anteriores marcados como secretos deben proceder de tu propia configuración. El servidor los comprueba una vez durante el inicio, pero la ausencia de un secreto nunca impide el arranque: Teable utiliza como alternativa el valor predeterminado integrado en versiones anteriores, registra las variables que faltan y se inicia. Estos valores integrados son públicos, por lo que cualquiera puede falsificar tokens o descifrar los datos que protegen. Esto resulta aceptable para una prueba local rápida, pero no es seguro para ningún otro uso. Actualizar un despliegue existente. Una instancia que se ejecutaba sin estas variables utilizaba implícitamente los valores integrados anteriores y sigue haciéndolo. El aviso de inicio muestra el bloque exacto que debes añadir para que las sesiones, los tokens y los datos cifrados actuales sigan funcionando. Cópialo tal cual, reinicia y después planifica una rotación. Si tu formato de configuración lo requiere, recuerda escapar$ en los valores.
Despliegue nuevo. Genera valores nuevos:
openssl rand -base64 32
openssl rand -hex 8 para los valores de 16 caracteres *_ENCRYPTION_KEY y
*_ENCRYPTION_IV.
El registro de inicio también advierte cuando un secreto se establece explícitamente en un valor predeterminado anterior
de conocimiento público. La instancia sigue ejecutándose para que tus datos permanezcan accesibles, pero
cualquiera puede falsificar tokens o descifrar los datos protegidos por ese valor. Rótalo.