Baserow 独立后端镜像文档

镜像概述与主要用途

本镜像仅运行 Baserow 后端服务，专为高级用户设计。若需简化部署流程，建议使用 baserow/baserow 全功能镜像。

有关详细部署指南，请参考官方文档：使用独立镜像安装。

核心功能与特性

关于 Baserow

• 混合架构：融合电子表格的易用性与数据库的强大数据组织能力
• 自托管友好：支持本地部署，无存储限制；或直接在 baserow.io 注册使用
• 替代方案：Airtable 的开源替代品
• 开源许可：开源核心架构，所有非高级功能基于 MIT 许可证，允许商业及私人使用
• 技术架构：无头（Headless）设计，API 优先；基于 Django、Vue.js、PostgreSQL 等主流框架构建

使用场景与适用范围

• 高级用户场景：需要自定义后端服务部署、独立管理后端组件的技术人员
• 集成需求：需将 Baserow 后端与自定义前端、第三方服务或现有系统集成的场景
• 定制化部署：需要单独扩展后端资源、优化性能或配置特定网络环境的场景

快速参考

• 维护方：baserow.io
• 支持渠道：Baserow 社区论坛
• 源代码：gitlab.com/bramw/baserow
• 官方文档：baserow.io/docs
• 许可证：开源核心架构，所有非高级功能代码基于 MIT 许可证

支持的标签与 Dockerfile 链接

• X.Y.Z：按 Baserow 版本号标记
• latest：最新稳定版
• develop-latest：开发分支的前沿版本，使用风险自负

使用方法与配置说明

前置条件

• 需单独部署 PostgreSQL 数据库（推荐 13+ 版本）
• 确保后端服务可被前端或其他服务访问（配置网络或端口映射）

Docker Run 部署示例

docker run -d \
  --name baserow-backend \
  -p 8000:8000 \
  -e SECRET_KEY="your-secure-secret-key" \
  -e DATABASE_URL="postgresql://user:password@postgres:5432/baserow" \
  -e ALLOWED_HOSTS="localhost,127.0.0.1" \
  baserow/backend:latest

Docker Compose 配置示例

version: '3.8'

services:
  postgres:
    image: postgres:13
    environment:
      POSTGRES_USER: baserow
      POSTGRES_PASSWORD: securepassword
      POSTGRES_DB: baserow
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

  baserow-backend:
    image: baserow/backend:latest
    depends_on:
      - postgres
    environment:
      SECRET_KEY: "your-secure-secret-key"  # 建议使用随机生成的32位以上字符串
      DATABASE_URL: "postgresql://baserow:securepassword@postgres:5432/baserow"
      ALLOWED_HOSTS: "localhost,127.0.0.1,your-domain.com"
      DEBUG: "false"  # 生产环境禁用调试模式
    ports:
      - "8000:8000"
    restart: unless-stopped

volumes:
  postgres_data:

核心环境变量说明

注意事项

• 本镜像仅包含后端服务，需配合前端服务（如 baserow/web-frontend）使用以提供完整功能
• develop-latest 标签为开发分支镜像，可能包含未稳定功能，不建议用于生产环境
• 首次启动时需等待数据库迁移完成，可通过容器日志确认服务就绪状态（Started server on 0.0.0.0:8000）