跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://help.teable.ai/llms.txt

Use this file to discover all available pages before exploring further.

生产环境强烈推荐使用 S3-compatible 对象存储（s3 / minio），并按 public/private 双桶进行配置。
同时请确保 public bucket 配置 public-read + CORS。详见：对象存储（S3-compatible）。
环境变量描述默认值必填示例
核心配置
PUBLIC_ORIGIN用于生成完整 URL 的公共源，必须设置为您的应用程序访问地址-是https://app.teable.ai
SECRET_KEY用于 JWT、会话和共享的密钥，请使用强密码defaultSecretKey是yourStrongSecretKey
PORT应用程序运行的端口3000-3000
LOG_LEVEL日志级别，可选值：fatal、error、warn、info、debug、traceinfo-debug
NEXT_ENV_IMAGES_ALL_REMOTE是否允许加载第三方图片false-true
存储配置
BACKEND_STORAGE_PROVIDER存储提供商，可选值：local、minio、s3、aliyunlocal-s3
BACKEND_STORAGE_LOCAL_PATH本地存储路径.assets/uploads-.assets/uploads
BACKEND_STORAGE_PUBLIC_BUCKETpublic bucket 名称public-teable-public
BACKEND_STORAGE_PRIVATE_BUCKETprivate bucket 名称private-teable-private
BACKEND_STORAGE_PUBLIC_URLpublic bucket 的公共访问 URL 覆盖（可选）--https://cdn.example.com
BACKEND_STORAGE_PRIVATE_BUCKET_ENDPOINTprivate bucket 的 endpoint 覆盖（可选）--https://private-bucket.endpoint
BACKEND_STORAGE_S3_REGIONS3 云存储区域，当 BACKEND_STORAGE_PROVIDER 为 s3 时需要配置--us-east-2
BACKEND_STORAGE_S3_ENDPOINTS3 云存储端点，当 BACKEND_STORAGE_PROVIDER 为 s3 时需要配置--https://s3.us-east-2.amazonaws.com
BACKEND_STORAGE_S3_INTERNAL_ENDPOINTS3 内网 endpoint（可选）--http://s3.internal
BACKEND_STORAGE_S3_ACCESS_KEYS3 云存储访问密钥，当 BACKEND_STORAGE_PROVIDER 为 s3 时需要配置--your_access_key
BACKEND_STORAGE_S3_SECRET_KEYS3 云存储秘密密钥，当 BACKEND_STORAGE_PROVIDER 为 s3 时需要配置--your_secret_key
BACKEND_STORAGE_S3_MAX_SOCKETSS3 最大连接数（可选）100-100
BACKEND_STORAGE_MINIO_ENDPOINTMinio 存储端点--minio.example.com
BACKEND_STORAGE_MINIO_PORTMinio 端口9000-443
BACKEND_STORAGE_MINIO_USE_SSLMinio 是否启用 SSLfalse-true
BACKEND_STORAGE_MINIO_ACCESS_KEYMinio 访问密钥--access-key
BACKEND_STORAGE_MINIO_SECRET_KEYMinio 秘密密钥--secret-key
BACKEND_STORAGE_MINIO_INTERNAL_ENDPOINTMinio 内网 endpoint（可选，不支持 HTTPS）--minio.internal
BACKEND_STORAGE_MINIO_INTERNAL_PORTMinio 内网端口（可选）9000-9000
BACKEND_STORAGE_MINIO_REGIONMinio region（可选）--us-east-1
BACKEND_STORAGE_UPLOAD_METHOD上传方式put-put
STORAGE_PREFIX存储前缀，默认为 PUBLIC_ORIGINPUBLIC_ORIGIN-http://localhost:3000
缓存配置
BACKEND_CACHE_PROVIDER缓存提供商，可选值：sqlite、memory、redissqlite-redis
BACKEND_CACHE_REDIS_URIRedis 缓存连接 URI，当 BACKEND_CACHE_PROVIDER 为 redis 时需要配置--redis://default:teable@127.0.0.1:6379/0
性能缓存配置
BACKEND_PERFORMANCE_CACHE性能缓存 Redis URL，用于查询结果缓存，大幅提高多人协作场景下的处理效率，建议配置单独的 Redis 实例，不要与 BACKEND_CACHE_REDIS_URI 一样--redis://default:teable@127.0.0.1:6379/0
认证配置
SOCIAL_AUTH_PROVIDERS社交认证提供商列表，多个提供商用逗号分隔--github,google,oidc
BACKEND_GITHUB_CLIENT_IDGitHub OAuth 客户端 ID--github_client_id
BACKEND_GITHUB_CLIENT_SECRETGitHub OAuth 客户端密钥--github_client_secret
BACKEND_GOOGLE_CLIENT_IDGoogle OAuth 客户端 ID--google_client_id
BACKEND_GOOGLE_CLIENT_SECRETGoogle OAuth 客户端密钥--google_client_secret
BACKEND_OIDC_CLIENT_IDOIDC 客户端 ID--google_client_id
BACKEND_OIDC_CLIENT_SECRETOIDC 客户端密钥--google_client_secret
BACKEND_OIDC_CALLBACK_URLOIDC 回调 URL--https://app.teable.ai/api/auth/oidc/callback
安全验证配置
TURNSTILE_SITE_KEYCloudflare Turnstile 站点密钥，用于身份验证验证--1x00000000000000000000AA
TURNSTILE_SECRET_KEYCloudflare Turnstile 秘密密钥，用于身份验证验证--1x0000000000000000000000000000000AA
BACKEND_SIGNUP_VERIFICATION_CODE_RATE_LIMIT_SECONDS注册验证邮箱发送频率间隔限制（秒）--30
邮件配置（已弃用 - 请使用管理面板 > 实例设置 > 邮箱）
BACKEND_MAIL_HOST默认邮件服务器地址。推荐在管理面板 > 实例设置 > 邮箱中可视化配置通知邮箱和自动化邮箱smtp.teable.ai-smtp.gmail.com
BACKEND_MAIL_PORT默认邮件服务器端口465-465
BACKEND_MAIL_SECURE默认邮件服务是否使用 SSL/TLStrue-true
BACKEND_MAIL_SENDER默认发件人地址noreply.teable.ai-noreply@company.com
BACKEND_MAIL_SENDER_NAME默认发件人名称Teable-Teable
BACKEND_MAIL_AUTH_USER默认邮件服务器认证用户名--username
BACKEND_MAIL_AUTH_PASS默认邮件服务器认证密码--usertoken
会话/JWT 配置
BACKEND_SESSION_EXPIRES_IN会话过期时间7d-7d
BACKEND_SESSION_COOKIE_SECURE是否启用会话 Cookie 安全保护，默认为 falsefalse-true
BACKEND_SESSION_ORIGIN_CHECK_ENABLED对使用浏览器会话 Cookie 的非安全 API 请求启用 Origin 与 Fetch Metadata 校验。仅在反向代理或 CDN 会保留这些请求头时启用false-false
BACKEND_JWT_EXPIRES_INJWT 过期时间20d-20d
BACKEND_RESET_PASSWORD_EMAIL_EXPIRES_IN重置密码邮件过期时间30m-30m
资源限制
MAX_COPY_CELLS单次请求最大复制单元格数--50000
MAX_READ_ROWS单次请求最大读取行数--10000
MAX_ATTACHMENT_UPLOAD_SIZE附件上传最大大小（字节）--2147483648
MAX_SPACE_OWNER_COUNT单个用户可作为所有者拥有或管理的最大空间数量10-10
TASK_MAX_FIELDS_PER_BATCH单次批量请求发送给模型的 AI 字段数量上限，取值会限制在 1 到 205-5
TASK_MAX_CONCURRENCY每轮调度最多派发的待处理 AI 字段任务运行数，取值会限制在 1 到 205-5
TABLE_LIMIT_FIELD_OPTIONS_MAX_BYTES字段选项序列化后的最大字节数262144-262144
TABLE_LIMIT_SELECT_CHOICES_MAX每个选择字段的最大选项数1000-1000
TABLE_LIMIT_SELECT_CHOICE_NAME_MAX_LENGTH选择项名称最大长度1000-1000
TABLE_LIMIT_SELECT_DEFAULT_VALUES_MAX选择字段默认值最大数量100-100
TABLE_LIMIT_CELL_VALUE_MAX_BYTES单元格值最大字节数262144-262144
TABLE_LIMIT_RECORD_FIELDS_MAX_BYTES记录字段数据序列化后的最大字节数1048576-1048576
TABLE_LIMIT_RECORDS_PER_MUTATION_MAX单次变更最大记录数20000-20000
TABLE_LIMIT_COMPUTED_CELL_VALUE_MAX_BYTES计算字段单元格值最大字节数262144-262144
TABLE_LIMIT_FORMULA_MAX_LENGTH公式最大长度8192-8192
TABLE_LIMIT_TABLES_PER_BASE_MAX每个数据库（Base）最大表数量1000-1000
TABLE_LIMIT_FIELDS_PER_TABLE_MAX每张表最大字段数500-500
TABLE_LIMIT_VIEWS_PER_TABLE_MAX每张表最大视图数100-100
TABLE_LIMIT_CREATE_TABLE_FIELDS_MAX创建表时允许的最大字段数1000-1000
TABLE_LIMIT_CREATE_TABLE_VIEWS_MAX创建表时允许的最大视图数20-20
TABLE_LIMIT_CREATE_TABLE_RECORDS_MAX创建表时允许的最大记录数20000-20000
TABLE_LIMIT_RECORDS_PER_TABLE_MAX每张表最大行数。为空时表示没有实例级行数上限--1000000
TABLE_LIMIT_VIEW_FILTER_ITEMS_MAX单个视图最大筛选条件数100-100
TABLE_LIMIT_VIEW_FILTER_DEPTH_MAX单个视图最大嵌套筛选深度5-5
TABLE_LIMIT_VIEW_SORT_ITEMS_MAX单个视图最大排序条件数20-20
TABLE_LIMIT_VIEW_GROUP_ITEMS_MAX单个视图最大分组条件数3-3
TABLE_LIMIT_VIEW_OPTIONS_MAX_BYTES视图配置序列化后的最大字节数262144-262144
TABLE_LIMIT_NAME_MAX_LENGTH支持的表对象显示名称最大长度100-100
TABLE_LIMIT_DESCRIPTION_MAX_LENGTH支持的表对象描述最大长度2000-2000
功能开关
RECORD_HISTORY_DISABLED是否禁用记录历史，默认为 falsefalse-true
PASSWORD_LOGIN_DISABLED是否禁用密码登录（OAuth 和 OIDC 仍然可用），默认为 falsefalse-true
分析监控
MICROSOFT_CLARITY_IDMicrosoft Clarity 指标 ID，用于启用 Microsoft Clarity 分析--your-metrics-id
OTEL_EXPORTER_OTLP_ENDPOINTOpenTelemetry OTLP 端点--http://jaeger:4317
TELEMETRY_REPORT_DISABLED禁用自托管遥测上报，包括联网实例的许可合规上报false-true
数据库配置
PRISMA_DATABASE_URL数据库连接 URL，必须配置-是postgresql://teable:teable@127.0.0.1:5432/teable
PRISMA_TRANSACTION_TIMEOUT事务运行超时时间（毫秒），对于长时间运行的事务（如包含多个外键的批量更新）可以增加此值5000-60000
PRISMA_TRANSACTION_MAX_WAIT从连接池获取事务的最大等待时间（毫秒）2000-5000
Last modified on May 18, 2026