Teable 本地部署实战：5 条短命令跑起开源数据协作平台

Teable 本地部署实战：5 条短命令跑起开源数据协作平台

【免费下载链接】teable✨ AI Spreadsheet for Business项目地址: https://gitcode.com/GitHub_Trending/te/teable

服务器到手却不知道把项目跑起来？Teable 是一款开源数据协作平台，建表、筛选、协作、分享数据都在浏览器里完成。没碰过 Docker 也没关系，跟着敲 5 条短命令，浏览器里就能打开你自己的平台。

先问自己：值不值得本地部署

花 10 秒对号入座，符合两条以上就继续往下读：

• ✅ 数据敏感：客户名单、合同、财务流水，不想放第三方云上
• ✅ 要定制：想按自己团队的流程建表、配视图，甚至接自动化
• ✅ 团队规模中小：几个人到几十人，一台服务器就够
• ❌ 如果只是想"看看这软件长啥样"，直接跳过部署，注册一个云端试用账号更省事

Teable 部署架构：其实就 3 个容器

动手前先看一眼你将要跑起来的东西：

就三个容器：Teable 应用本体、PostgreSQL（数据库，数据最终存在它这儿）、Redis（缓存）。所有数据都落在 Docker 卷里，容器重启不会丢，删容器也不会丢。

动手：五个动作跑起来

第一步：检查 Docker 装没装

Docker 可以理解为"容器的运行环境"，把 Teable 打包好的程序原样跑起来；Docker Compose 则是"容器的启动器"，一条命令拉起一整组容器。

docker --version docker compose version

⚠️ 两条命令有输出版本号就行。没装的话，去 Docker 官网下载对应系统的安装包，安装程序会顺手把 Compose 也装好。

第二步：拿项目代码

git clone https://gitcode.com/GitHub_Trending/te/teable cd teable/dockers/examples/standalone

⏱ 约 2 分钟，取决于网速。⚠️ 卡住不动多半是网络慢，耐心等它转完，别中途 Ctrl+C。

这个 standalone 目录 就是单节点部署的完整配置，后面所有操作都在这里完成。

第三步：Teable 环境变量只改这几行

目录里已经有一个.env文件，打开它，只改 4 行：

TIMEZONE=Asia/Shanghai POSTGRES_PASSWORD=改成你自己的强密码 REDIS_PASSWORD=改成你自己的强密码 PUBLIC_ORIGIN=http://127.0.0.1:3000 # 其余保持默认

💡 强密码就是大小写字母+数字+符号、8 位以上。如果部署在远程服务器、要外网访问，把PUBLIC_ORIGIN里的地址换成你的服务器 IP:3000，其余保持默认。

第四步：一条命令启动

docker compose up -d

⏱ 首次约 3~5 分钟，大部分时间花在下载镜像。这条命令会自动拉镜像、起 3 个容器、建好数据卷，数据库没就绪之前应用容器会自动等它健康检查通过才启动，不用你操心顺序。

⚠️ 如果报port is already allocated，说明 3000 端口被占了：改一下docker-compose.yaml里 teable 服务的端口映射，把'3000:3000'改成'8080:3000'，再跑一次上面的命令，以后就用 8080 端口访问。

第五步：确认它真的起来了

docker compose ps

看到 teable、teable-db、teable-cache 三个服务的状态都是Up，就算成功。⚠️ 如果某个服务反复重启（Restarting），跑docker compose logs teable-db看一眼，九成是第三步密码没保存。

跑起来之后：两件 30 秒就能做的事

打开浏览器访问http://服务器IP:3000（本机部署就是http://127.0.0.1:3000），第一件事是注册账号——Teable 不需要预设管理员，你注册的第一个账号自动就是管理员。

登录后新建一个 Base（可以理解为"工作簿"，里面装表格），给表加几列、录入几行数据：

然后试试顶部的视图切换，同一份数据秒变看板：

能建表、能录入、刷新页面数据不丢——看到这三件事都成立，就说明部署成功了。

交给运维的三件事

备份：一条定时任务

在部署目录里加一条每天凌晨 3 点执行的 crontab（crontab -e打开编辑）：

0 3 * * * cd /路径/teable/dockers/examples/standalone && docker compose exec teable-db pg_dump -U example example > ~/teable-$(date +\%F).sql

⚠️ 用户和库名以你.env里POSTGRES_USER、POSTGRES_DB的实际值为准。如果导出的 sql 文件是 0 字节，先查数据库容器是不是Up。

升级：两条命令 + 一个前提

docker compose pull docker compose up -d

⚠️ 先备份再升级，老规矩。升级后页面打不开，先查docker compose logs teable。

看日志

docker compose logs -f teable

-f表示持续滚动输出，问题定位完按 Ctrl+C 退出。如果应用起不来但数据库日志正常，八成是.env里PUBLIC_ORIGIN和实际访问地址对不上。

进阶可选项（用不上就不用看）

• 想接公司已有的 PostgreSQL：改.env里的POSTGRES_*变量指向外部库即可，细节看 部署目录说明
• 想上 HTTPS：在 Teable 前面架一层 Nginx 或 Caddy 反向代理做证书，应用容器不用动
• 团队变大要集群/高可用：官方有功能更完整的自部署方案，对比表见 自部署说明

你已经拥有了一个数据完全自主可控的协作平台。先建两张表给团队用起来，细节以后慢慢说。

【免费下载链接】teable✨ AI Spreadsheet for Business项目地址: https://gitcode.com/GitHub_Trending/te/teable