Linux怎么安装和配置Baserow Linux开源在线表格工具详解-LINUX-PHP中文网

最稳省事的部署方案是docker compose，因baserow依赖复杂（django+nuxt+celery+postgresql+redis），纯python环境难以跑通；启动失败主因是baserow_public_url格式错误、postgresql初始化延迟、宿主机5432端口冲突、./data权限不足及.env中secret_key/postgres_password/baserow_public_url三项未正确配置。

linux怎么安装和配置baserow linux开源在线表格工具详解

直接用 Docker Compose 部署是最稳、最省事的方案，不建议手动编译或 pip 安装——Baserow 依赖复杂（Django + Nuxt + Celery + PostgreSQL + Redis），纯 Python 环境几乎无法跑通完整功能。

docker-compose up -d 启动失败：常见报错和修复点

多数人卡在这一步，不是配置错，而是环境没对齐：

BASEROW_PUBLIC_URL 必须带协议和端口（如 http://localhost:8000），漏掉 http:// 或写成 localhost 会导致前端白屏、API 调用 404
PostgreSQL 初始化慢于 backend，backend 容器会反复重试并最终退出；加 depends_on + healthcheck 仍不够，实际要等 30 秒以上，可先 docker-compose up -d postgres，等日志出现 database system is ready to accept connections 再启其余服务
宿主机 5432 端口被占用（比如本地已装 PostgreSQL），导致容器内 postgres 启动失败；检查用 sudo ss -tulpn | grep :5432，临时停掉或改 compose 中的 ports 映射（如 "5433:5432"）
./data 目录权限不足，尤其在 Ubuntu 上，Docker 默认以 root 运行但 Baserow 容器内进程用非 root 用户（UID 1001）写数据；执行 sudo chown -R 1001:1001 ./data

env 文件里必须改的三项

.env 是启动前唯一要手工确认的配置文件，其他都可默认。这三项不设对，登录后看不到数据库或新建表格失败：

Linux installer

先解析安全源，运行本地CLI安装、启动、卸载Linux桌面应用。用户请求时使用。

下载

BASEROW_PUBLIC_URL：对外访问地址，例如 http://192.168.1.100:8000 或 https://db.example.com（反向代理时填域名）
SECRET_KEY：必须换掉，默认值不安全；生成方式：openssl rand -base64 32 | tr '+/' '-_'，结果粘贴进去
POSTGRES_PASSWORD：同时影响 postgres 容器初始化和 backend 连接，前后必须一致；别用纯数字或简单单词

反向代理（Nginx）配置关键项

想用 https://baserow.mydomain.com 访问，不能只配域名转发，Baserow 对请求头敏感：

必须透传 Host 和 X-Forwarded-Proto 头，否则登录跳转会拼错 URL；Nginx 配置里加：
```
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
```

WebSocket 支持必须显式开启，否则实时协作、通知等功能失效：

proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

静态资源路径不能漏，否则 CSS/JS 404：location /static/ { alias /path/to/baserow/backend/staticfiles/; }（注意末尾斜杠和本地路径真实位置）

首次登录后看不到“Add new database”按钮

这不是权限问题，而是工作区（Workspace）未激活或未关联用户：

检查 docker-compose logs backend 是否有 No workspace found for user；说明数据库迁移没跑完或 celery_worker 没起来
手动触发迁移：docker-compose exec backend python manage.py migrate
确认 celery_worker 容器状态为 Up，日志里有 Ready to accept tasks；若卡在 Connection refused，大概率是 BASEROW_REDIS_URL 指向错误地址（默认是 redis://redis:6379，确保 redis 服务名匹配）
浏览器清缓存重进，或换隐身窗口——Baserow 前端会缓存初始 workspace 状态，旧缓存可能导致按钮不渲染