最后使用： 2026-03-24
记忆引用： 2
状态： 活跃

langfuse-backup

为自托管的 Langfuse 实例备份和恢复 Docker 卷。

脚本

• - scripts/backuplangfuse.sh — 备份 postgres + minio 卷（主要数据）
• scripts/restorelangfuse.sh — 从特定备份日期恢复

快速开始

bash

配置（环境变量或编辑脚本默认值）

export LANGFUSEBACKUPDIR=$HOME/.langfuse-backups
export LANGFUSECOMPOSEDIR=/path/to/langfuse # 包含 docker-compose.yml 的目录
export LANGFUSEDBCONTAINER=langfuse-db-1 # postgres 容器名称
export LANGFUSEMINIOCONTAINER=langfuse-minio-1 # minio 容器名称
export LANGFUSEDBNAME=langfuse # postgres 数据库名称
export LANGFUSEDBUSER=langfuse # postgres 用户

运行备份

bash scripts/backup_langfuse.sh

列出可用备份

ls $LANGFUSEBACKUPDIR

从某个日期恢复

bash scripts/restore_langfuse.sh 2026-02-27

环境变量

变量	默认值	描述
LANGFUSEBACKUPDIR	~/.langfuse-backups	备份根目录
LANGFUSECOMPOSEDIR

~/langfuse | Docker Compose 项目目录 | | LANGFUSEDBCONTAINER | langfuse-db-1 | Postgres 容器名称 | | LANGFUSEMINIOCONTAINER| langfuse-minio-1 | MinIO 容器名称 | | LANGFUSEDBNAME | langfuse | Postgres 数据库名称 | | LANGFUSEDBUSER | langfuse | Postgres 用户 | | LANGFUSERETENTIONDAYS | 14 | 保留多少天的备份 |

备份内容

卷	是否备份？	备注
Postgres	✅ 是	pg_dump → .sql.gz — 追踪、评分、评估
MinIO

✅ 是 | tar.gz — 上传的二进制对象 | | ClickHouse| ⚠️ 可选 | 体积大；许多用户跳过（从追踪中重放） | | Redis | ⚠️ 跳过 | 仅缓存 — 可安全跳过 |

Cron 设置（macOS LaunchAgent）

xml

StartCalendarInterval

Hour2
Minute0

ProgramArguments

/bin/bash
/path/to/scripts/backup_langfuse.sh

StandardOutPath
/tmp/langfuse-backup.log

恢复步骤

bash

1. 停止 Langfuse

cd $LANGFUSECOMPOSEDIR && docker compose down

2. 从备份恢复

bash scripts/restore_langfuse.sh 2026-02-27

3. 启动 Langfuse

cd $LANGFUSECOMPOSEDIR && docker compose up -d