架构概览
重要：Teable 需要 S3-compatible 存储。你可以选择：
- AWS S3（跨云方案）
- MinIO（在 GCE/GKE 自建）
- 其他 S3-compatible 服务
Google Cloud Storage (GCS) 不直接支持，因为它使用不同的 API。 前置要求
- 已安装并认证
gcloud CLI
- GCP 项目已启用计费
- 具备 S3-compatible 存储访问权（例如 AWS S3 账号或 MinIO 部署）
步骤 1：创建 GCP 资源
1.1 设置项目和区域
export PROJECT_ID=your-project-id
export REGION=us-central1
gcloud config set project $PROJECT_ID
1.2 创建 Cloud SQL (PostgreSQL)
gcloud sql instances create teable-db \
--database-version=POSTGRES_16 \
--tier=db-custom-2-7680 \
--region=$REGION \
--root-password=<你的强密码> \
--storage-type=SSD \
--storage-size=100GB
获取连接名称：gcloud sql instances describe teable-db \
--format='value(connectionName)'
your-project:region:teable-db gcloud sql databases create teable --instance=teable-db
1.3 创建 Memorystore (Redis)
gcloud redis instances create teable-cache \
--size=1 \
--region=$REGION \
--redis-version=redis_7_0
获取 Redis 主机地址：gcloud redis instances describe teable-cache \
--region=$REGION \
--format='value(host)'
步骤 2：设置 S3-compatible 存储
由于 Google Cloud Storage 不兼容 S3，请选择以下方案之一：
方案 A：使用 AWS S3（跨云）
- 在 AWS 上创建 S3 bucket（参见 AWS 部署指引 步骤 1.3-1.4）
- 配置 public bucket（参见 对象存储指引）
环境变量：
BACKEND_STORAGE_PROVIDER=s3
BACKEND_STORAGE_S3_REGION=us-west-2
BACKEND_STORAGE_S3_ENDPOINT=https://s3.us-west-2.amazonaws.com
BACKEND_STORAGE_S3_ACCESS_KEY=<aws-access-key>
BACKEND_STORAGE_S3_SECRET_KEY=<aws-secret-key>
BACKEND_STORAGE_PUBLIC_BUCKET=teable-public-<后缀>
BACKEND_STORAGE_PRIVATE_BUCKET=teable-private-<后缀>
STORAGE_PREFIX=https://teable-public-<后缀>.s3.us-west-2.amazonaws.com
方案 B：在 GCP 上部署 MinIO
在 GCE 实例或 GKE 集群上部署 MinIO 提供 S3-compatible 存储。
快速设置（GCE VM）：
# 创建 VM
gcloud compute instances create minio-server \
--machine-type=e2-medium \
--zone=us-central1-a \
--image-family=ubuntu-2204-lts \
--image-project=ubuntu-os-cloud \
--boot-disk-size=100GB
# SSH 登录并安装 MinIO
gcloud compute ssh minio-server --zone=us-central1-a
# 在 VM 上：
wget https://dl.min.io/server/minio/release/linux-amd64/minio
chmod +x minio
sudo mv minio /usr/local/bin/
export MINIO_ROOT_USER=admin
export MINIO_ROOT_PASSWORD=<强密码>
minio server /data --console-address ":9001"
步骤 3：准备环境变量
创建 .env 文件：
# Core
PUBLIC_ORIGIN=https://teable.yourcompany.com
SECRET_KEY=<生成32位随机字符串>
# Database (Cloud SQL)
PRISMA_DATABASE_URL=postgresql://postgres:<密码>@/teable?host=/cloudsql/<connection-name>
# Redis (Memorystore)
BACKEND_CACHE_PROVIDER=redis
BACKEND_CACHE_REDIS_URI=redis://<memorystore-ip>:6379/0
BACKEND_PERFORMANCE_CACHE=redis://<memorystore-ip>:6379/0
# Storage (S3-compatible)
# 方案 A (AWS S3)：
BACKEND_STORAGE_PROVIDER=s3
BACKEND_STORAGE_S3_REGION=us-west-2
BACKEND_STORAGE_S3_ENDPOINT=https://s3.us-west-2.amazonaws.com
BACKEND_STORAGE_S3_ACCESS_KEY=<aws-key>
BACKEND_STORAGE_S3_SECRET_KEY=<aws-secret>
BACKEND_STORAGE_PUBLIC_BUCKET=teable-public-<后缀>
BACKEND_STORAGE_PRIVATE_BUCKET=teable-private-<后缀>
STORAGE_PREFIX=https://teable-public-<后缀>.s3.us-west-2.amazonaws.com
步骤 4：部署到 Cloud Run
4.1 构建并推送容器（或使用预构建镜像）
# 方案 1：使用预构建镜像
export IMAGE=ghcr.io/teableio/teable:latest
# 方案 2：构建并推送到 GCR
# gcloud builds submit --tag gcr.io/$PROJECT_ID/teable
# export IMAGE=gcr.io/$PROJECT_ID/teable
4.2 部署到 Cloud Run
gcloud run deploy teable \
--image=$IMAGE \
--platform=managed \
--region=$REGION \
--allow-unauthenticated \
--port=3000 \
--set-env-vars="PUBLIC_ORIGIN=https://teable.yourcompany.com" \
--set-env-vars="SECRET_KEY=<你的secret>" \
--set-env-vars="PRISMA_DATABASE_URL=postgresql://..." \
--set-env-vars="BACKEND_CACHE_PROVIDER=redis" \
--set-env-vars="BACKEND_CACHE_REDIS_URI=redis://..." \
--set-env-vars="BACKEND_STORAGE_PROVIDER=s3" \
--set-env-vars="BACKEND_STORAGE_S3_REGION=us-west-2" \
--set-env-vars="BACKEND_STORAGE_S3_ENDPOINT=https://s3.us-west-2.amazonaws.com" \
--set-env-vars="BACKEND_STORAGE_S3_ACCESS_KEY=***" \
--set-env-vars="BACKEND_STORAGE_S3_SECRET_KEY=***" \
--set-env-vars="BACKEND_STORAGE_PUBLIC_BUCKET=teable-public-xxx" \
--set-env-vars="BACKEND_STORAGE_PRIVATE_BUCKET=teable-private-xxx" \
--set-env-vars="STORAGE_PREFIX=https://teable-public-xxx.s3.us-west-2.amazonaws.com" \
--add-cloudsql-instances=<connection-name> \
--vpc-connector=<your-vpc-connector-for-redis>
访问 Cloud SQL 使用 --add-cloudsql-instances。
访问 Memorystore 需先创建 VPC connector。
步骤 5：验证部署
- 获取服务 URL：
gcloud run services describe teable \
--region=$REGION \
--format='value(status.url)'
- 测试健康检查：
curl https://<service-url>/health
{"status":"ok"}
- 查看日志：
gcloud run services logs read teable --region=$REGION
生产环境建议
- 高可用：启用 Cloud Run 最小实例数（2+）
- 安全：使用 Secret Manager 存储敏感值
- 监控：启用 Cloud Monitoring 并设置告警
- 备份：启用 Cloud SQL 自动备份
- 自定义域名：将自定义域名映射到 Cloud Run 服务
相关文档