跳转到主要内容
本文档介绍如何更新您的 Teable 私有化部署版本。

​
更新频率

Teable 私有化版本的更新完全由您自主决定。只要有新版本发布，您就可以灵活选择是否更新。您可以在 GitHub Packages 查看所有可用版本。
在进行任何更新操作之前，强烈建议先备份您的数据。

​
Docker Compose 更新

如果您使用 Docker Compose 部署 Teable，请按以下步骤更新：

​
备份数据（推荐）

我们建议直接备份整个云主机，或者备份使用到的 PostgreSQL / Redis / 存储卷。

​
进入部署目录

cd teable  # 进入您的 teable 部署目录

​
拉取最新镜像

docker-compose pull

​
重启服务

docker-compose up -d
系统会自动使用最新的镜像重新创建容器。您的数据保存在 Docker 卷中，不会丢失。

​
验证更新

# 查看容器状态
docker-compose ps

# 查看日志确认启动正常
docker-compose logs -f teable
访问您的 Teable 实例，确认服务正常运行。

​
更新到指定版本

如果您希望更新到特定版本而不是最新版本，可以修改 docker-compose.yaml 中的镜像标签： 
services:
  teable:
    image: registry.cn-shenzhen.aliyuncs.com/teable/teable:0.5.0-alpha-1.x.x-build.xxx  # 指定版本号
然后执行： 
docker-compose pull
docker-compose up -d
您可以在 GitHub Releases 页面查看所有可用版本。

​
Kubernetes 更新

如果您使用 Kubernetes 部署 Teable，请按以下步骤更新：

​
使用 Helm 更新

# 更新 Helm 仓库
helm repo update

# 查看可用版本
helm search repo teable --versions

# 更新到最新版本
helm upgrade teable teable/teable -n teable

# 或更新到指定版本
helm upgrade teable teable/teable -n teable --version x.x.x

​
手动更新镜像

如果您使用自定义的 Kubernetes 配置，可以直接更新 Deployment 中的镜像版本： 
kubectl set image deployment/teable teable=registry.cn-shenzhen.aliyuncs.com/teable/teable:0.5.0-alpha-1.x.x-build.xxx -n teable

​
验证更新

# 查看 Pod 状态
kubectl get pods -n teable

# 查看滚动更新状态
kubectl rollout status deployment/teable -n teable

# 查看日志
kubectl logs -f deployment/teable -n teable

​
数据库迁移

Teable 在启动时会自动执行数据库迁移，无需手动干预。如果您在更新后遇到问题，可以查看日志确认迁移是否成功： 
# Docker Compose
docker-compose logs teable | grep -i migration

# Kubernetes
kubectl logs deployment/teable -n teable | grep -i migration

​
回滚版本

如果更新后遇到问题，您可以回滚到之前的版本。

​
Docker Compose 回滚

  1. 修改 docker-compose.yaml 中的镜像标签为之前的版本
  2. 执行 docker-compose up -d

​
Kubernetes 回滚

# 查看历史版本
kubectl rollout history deployment/teable -n teable

# 回滚到上一个版本
kubectl rollout undo deployment/teable -n teable

# 回滚到指定版本
kubectl rollout undo deployment/teable -n teable --to-revision=<revision>

​
常见问题

不会。您的数据存储在 Docker 卷或外部数据库中，更新容器不会影响数据。但仍建议在更新前进行备份。
不会。您的实例 ID 在应用更新过程中保持不变，它是您自托管安装的永久标识符。
通常情况下，拉取新镜像需要几分钟（取决于网络速度），容器重启只需要几秒钟。整个过程通常在 5-10 分钟内完成。
使用 docker-compose up -d 或 Kubernetes 滚动更新时，会有短暂的服务中断（通常几秒到几十秒）。如果需要零停机更新，建议使用 Kubernetes 并配置适当的滚动更新策略。
您可以通过以下方式查看当前版本：
  • 在 Teable 界面左下角查看版本号
  • 使用管理员账号进入管理面板查看
  • 执行 docker inspect teable-teable-1 --format='{{.Config.Image}}' 查看镜像版本
  1. 首先查看容器日志排查问题：docker-compose logs teable
  2. 如果是数据库迁移问题，尝试从备份恢复数据
  3. 如果问题持续，可以回滚到之前的版本
  4. 联系支持团队 [email protected]