配置
环境变量
这里列举了Teable 所有可用的环境变量以及相关解释
| 环境变量 | 描述 | 默认值 | 必填 | 示例 |
|---|---|---|---|---|
| 核心配置 | ||||
| PUBLIC_ORIGIN | 用于生成完整 URL 的公共源，必须设置为您的应用程序访问地址 | - | 是 | https://app.teable.io |
| SECRET_KEY | 用于 JWT、会话和共享的密钥，请使用强密码 | defaultSecretKey | 是 | yourStrongSecretKey |
| PORT | 应用程序运行的端口 | 3000 | - | 3000 |
| LOG_LEVEL | 日志级别，可选值：fatal、error、warn、info、debug、trace | info | - | debug |
| NEXT_ENV_IMAGES_ALL_REMOTE | 是否允许加载第三方图片 | false | - | true |
| 存储配置 | ||||
| BACKEND_STORAGE_PROVIDER | 存储提供商，可选值：local、minio、s3 | local | - | s3 |
| BACKEND_STORAGE_S3_REGION | S3 云存储区域，当 BACKEND_STORAGE_PROVIDER 为 s3 时需要配置 | - | - | us-east-2 |
| BACKEND_STORAGE_S3_ENDPOINT | S3 云存储端点，当 BACKEND_STORAGE_PROVIDER 为 s3 时需要配置 | - | - | https://s3.us-east-2.amazonaws.com |
| BACKEND_STORAGE_S3_ACCESS_KEY | S3 云存储访问密钥，当 BACKEND_STORAGE_PROVIDER 为 s3 时需要配置 | - | - | your_access_key |
| BACKEND_STORAGE_S3_SECRET_KEY | S3 云存储秘密密钥，当 BACKEND_STORAGE_PROVIDER 为 s3 时需要配置 | - | - | your_secret_key |
| BACKEND_STORAGE_MINIO_ENDPOINT | Minio 存储端点 | - | - | minio.example.com |
| BACKEND_STORAGE_MINIO_ACCESS_KEY | Minio 访问密钥 | - | - | access-key |
| BACKEND_STORAGE_MINIO_SECRET_KEY | Minio 秘密密钥 | - | - | secret-key |
| STORAGE_PREFIX | 存储前缀，默认为 PUBLIC_ORIGIN | PUBLIC_ORIGIN | - | http://localhost:3000 |
| 缓存配置 | ||||
| BACKEND_CACHE_PROVIDER | 缓存提供商，可选值：sqlite、memory、redis | memory | - | redis |
| BACKEND_CACHE_REDIS_URI | Redis 缓存连接 URI，当 BACKEND_CACHE_PROVIDER 为 redis 时需要配置 | - | - | redis://default:teable@127.0.0.1:6379/0 |
| 认证配置 | ||||
| SOCIAL_AUTH_PROVIDERS | 社交认证提供商列表，多个提供商用逗号分隔 | - | - | github,google,oidc |
| BACKEND_GITHUB_CLIENT_ID | GitHub OAuth 客户端 ID | - | - | github_client_id |
| BACKEND_GITHUB_CLIENT_SECRET | GitHub OAuth 客户端密钥 | - | - | github_client_secret |
| BACKEND_GOOGLE_CLIENT_ID | Google OAuth 客户端 ID | - | - | google_client_id |
| BACKEND_GOOGLE_CLIENT_SECRET | Google OAuth 客户端密钥 | - | - | google_client_secret |
| BACKEND_OIDC_CLIENT_ID | OIDC 客户端 ID | - | - | google_client_id |
| BACKEND_OIDC_CLIENT_SECRET | OIDC 客户端密钥 | - | - | google_client_secret |
| BACKEND_OIDC_CALLBACK_URL | OIDC 回调 URL | - | - | https://app.teable.io/api/auth/oidc/callback |
| 邮件配置 | ||||
| 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_JWT_EXPIRES_IN | JWT 过期时间 | 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 | 是否禁用记录历史，默认为 false | false | - | true |
| PASSWORD_LOGIN_DISABLED | 是否禁用密码登录（OAuth 和 OIDC 仍然可用），默认为 false | false | - | true |
| 分析监控 | ||||
| MICROSOFT_CLARITY_ID | Microsoft Clarity 指标 ID，用于启用 Microsoft Clarity 分析 | - | - | your-metrics-id |
| OTEL_EXPORTER_OTLP_ENDPOINT | OpenTelemetry OTLP 端点 | - | - | http://jaeger:4317 |
| 模板配置 | ||||
| TEMPLATE_SPACE_ID | 模板基础所在的空间 ID，用于模板中心操作的基本信息 | - | - | your-template-space-id |
| TEMPLATE_SITE_LINK | 模板站点链接，需要设置此值才能启用从模板创建的功能 | - | - | https://template.teable.io |
| 数据库配置 | ||||
| PRISMA_DATABASE_URL | 数据库连接 URL，必须配置 | - | 是 | postgresql://teable:teable@127.0.0.1:5432/teable |