Teable 本地部署:手把手跑起来
发布时间:2026/9/6 22:27:36 锦皓数字建站

Teable 本地部署手把手跑起来【免费下载链接】teable✨ AI Spreadsheet for Business项目地址: https://gitcode.com/GitHub_Trending/te/teable本文带你用 4 条命令完成 Teable 的本地部署克隆仓库、改一份配置文件、启动服务栈、打开浏览器验证。Teable 是 AI 表格协作平台从建表到筛选全程照做即可。第一关确认环境3 件事部署 Teable 前先确认三件事容器环境、机器资源、网络。项目版本要求验证命令预期输出Docker Engine≥ 20.10docker --version版本号 ≥ 20.10Docker Compose≥ 2.0docker compose version输出 v2.x.x内存≥ 2 GBfree -havailable ≥ 2Gi磁盘≥ 10 GBdf -h .Avail ≥ 10G网络能拉取 Docker 镜像docker compose version正常即大概率通拉镜像无超时为什么这么做三个容器都要跑起来Docker 是唯一硬依赖其余都是资源底线。环境没问题的话全程预计 10~15 分钟首次拉镜像偏慢。第二关拉取 Teable 仓库定位部署目录git clone https://gitcode.com/GitHub_Trending/te/teable cd teable/dockers/examples/standalone为什么选 standalone 目录它是单节点部署应用 PostgreSQL Redis 三个容器一条命令拉起适合中小团队要 AI 聊天、App Builder 才需要完整功能版部署包。验证目录结构ls # 预期输出docker-compose.yaml .env README.md三项齐全即过关。约 2 分钟取决于网络。第三关配置 Teable 部署环境变量仓库里直接附了一份.env模板把示例值改成你自己的即可。用任意编辑器打开.env重点改这几项# 时区改成你所在的时区 TIMEZONEAsia/Shanghai # Postgres 数据库名 POSTGRES_DBteable # Postgres 用户名 POSTGRES_USERteable_user # Postgres 密码必须改掉 example 开头的示例值 POSTGRES_PASSWORDchange_me_strong_password # Redis 密码必须改掉 replace_this_password REDIS_PASSWORDchange_me_redis_password # 应用访问地址浏览器实际访问 Teable 用的地址 PUBLIC_ORIGINhttp://127.0.0.1:3000其余配置PRISMA_DATABASE_URL、BACKEND_CACHE_REDIS_URI等已自动引用上面变量不用动。 两个最容易配错的参数两个密码如果保留示例值缓存连接会失败、数据库等于裸奔PUBLIC_ORIGIN如果和你实际访问地址不一致数据操作会报错。验证关键值已生效grep -E ^(TIMEZONE|POSTGRES_DB|POSTGRES_USER|REDIS_PASSWORD|PUBLIC_ORIGIN) .env # 预期5 行输出都是你刚改的值约 3 分钟。第四关启动 Teable 服务栈确认就绪docker compose up -d # -d 表示后台运行不占用当前终端这条命令会拉取 Teable、PostgreSQL、Redis 三个镜像创建容器、卷和网络。首次拉镜像约 3~8 分钟。验证服务状态docker compose ps # 预期三个服务都是 Updb 和 cache 带 (healthy) # teable 0.0.0.0:3000-3000/tcp # teable-db 0.0.0.0:42345-5432/tcp # teable-cache 6379/tcp仅内部暴露三个服务通过内部网络通信数据全部落到卷里表结构和记录存 PostgreSQLteable-db 卷缓存和队列存 Redisteable-cache 卷上传的附件存 teable-data 卷。容器重启数据不丢。第五关部署≠完成跑一个真实场景打开浏览器访问http://127.0.0.1:3000首次访问会引导你注册账号。注册即创建组织你就是管理员无需预置账号。点击新建 Base再建一张表默认进入网格视图。录入几条记录客户名、金额、所属平台、注册时间。点击顶部 Filter按 Platform 筛选出 Amazon只有匹配的行保留在列表里底部汇总随之变化。想看趋势打开 Dashboard把金额拖成柱状图或折线图数据自动聚合。验证标准能建表、能录入、能筛选、图表有数据说明 Teable 部署真正可用。第六关卡住了看这里页面能打开但数据操作报错→ 原因通常是PUBLIC_ORIGIN与实际访问地址不一致 → 改成真实访问地址后执行docker compose up -d重启。容器反复重启→ 用docker compose logs teable看日志多半是 Redis 密码没配对 → 修正.env后重新docker compose up -d。启动即 Exit 1→ 3000 端口被其他程序占用 → 把docker-compose.yaml中3000:3000改成8080:3000再docker compose up -d以后访问 8080 端口。高级配置复用外部 PostgreSQL / 换端口 / 反代 HTTPS外部 PostgreSQL已有数据库想复用可把POSTGRES_HOST、POSTGRES_PORT指向外部实例同时从docker-compose.yaml移除teable-db服务及其depends_on。换端口修改ports映射即可PUBLIC_ORIGIN同步改成新端口。HTTPS建议在 Nginx 等反向代理上终结 SSL代理到 3000 端口PUBLIC_ORIGIN设为 https 域名。至此一套可用的 Teable 本地部署已在你的机器上跑起来。接下来可以试试邀请团队实时协作、配置自动化工作流、接入 Open API。【免费下载链接】teable✨ AI Spreadsheet for Business项目地址: https://gitcode.com/GitHub_Trending/te/teable创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
锦
锦皓数字建站
深耕本土企业品牌数字化升级,专注原创端正雅致商务官网,从视觉设计到稳定运维全程保驾护航。