跳转到主要内容
环境变量描述默认值必填示例
核心配置
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、s3local-s3
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_ACCESS_KEYS3 云存储访问密钥，当 BACKEND_STORAGE_PROVIDER 为 s3 时需要配置--your_access_key
BACKEND_STORAGE_S3_SECRET_KEYS3 云存储秘密密钥，当 BACKEND_STORAGE_PROVIDER 为 s3 时需要配置--your_secret_key
BACKEND_STORAGE_MINIO_ENDPOINTMinio 存储端点--minio.example.com
BACKEND_STORAGE_MINIO_ACCESS_KEYMinio 访问密钥--access-key
BACKEND_STORAGE_MINIO_SECRET_KEYMinio 秘密密钥--secret-key
STORAGE_PREFIX存储前缀，默认为 PUBLIC_ORIGINPUBLIC_ORIGIN-http://localhost:3000
缓存配置
BACKEND_CACHE_PROVIDER缓存提供商，可选值：sqlite、memory、redismemory-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.gmail.com
BACKEND_MAIL_PORT[已弃用] 邮件服务器端口。请使用管理面板 > 设置进行可视化邮件配置--465
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_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
功能开关
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
数据库配置
PRISMA_DATABASE_URL数据库连接 URL，必须配置-是postgresql://teable:teable@127.0.0.1:5432/teable
PRISMA_TRANSACTION_TIMEOUT事务运行超时时间（毫秒），对于长时间运行的事务（如包含多个外键的批量更新）可以增加此值5000-60000
PRISMA_TRANSACTION_MAX_WAIT从连接池获取事务的最大等待时间（毫秒）2000-5000
前端配置
NEXT_BUILD_ENV_ASSET_PREFIX启用前端静态资源 CDN 回源地址，在配置好回源到本站点之后配置该变量以启用 CDN--https://cdn.mydomain.com