如何备份 Multica 自建实例的 PostgreSQL 数据含 pg_dump 陷阱【免费下载链接】multicaMake humans and AI agents work as one team — open-source and self-hostable.项目地址: https://gitcode.com/GitHub_Trending/mu/multica如果你的 Multica 是自建实例在升级版本之前应该先对 PostgreSQL 做一次完整导出官方文档明确指出迁移是 forward-only 的因此备份是升级前唯一的回退依据。本文按 self-host-quickstart 中 “Back up Postgres first” 一节的写法给出官方推荐的导出命令并解释为什么不能把pg_dump直接管道给gzip。适用前提通过 Docker Compose 运行的自建实例docker-compose.selfhost.ymlpostgres容器处于运行状态执行机器上已安装 Docker 与 Compose v2docker compose形式文档明确不支持 legacy 的docker-composev1。备份前确认数据位置与凭据Multica 自建栈的 PostgreSQL 容器使用pgvector/pgvector:pg17镜像需要pgcrypto与pg_trgm扩展见 SELF_HOSTING.md 的 Architecture 一节。数据存放在命名卷multica_pgdata中映射到容器内/var/lib/postgresql/data见 docker-compose.selfhost.yml。有两点直接影响备份命令用户名和库名以.env为准。compose 文件中两者默认值都是multica${POSTGRES_USER:-multica}、${POSTGRES_DB:-multica}。如果你改过.env中的POSTGRES_USER/POSTGRES_DB命令中的-U multica multica要换成你自己的值——官方文档的原话是改过默认值时用.env里自己的POSTGRES_USER/POSTGRES_DB。区分“停服务”和“删卷”。docker compose down保留pgdata和backend_uploads两个卷数据还在加上-v会删除这些卷数据库数据一并消失。文档警告除非你本来就打算抹掉整个实例否则不要执行docker compose down -v。执行备份在multica仓库目录能访问docker-compose.selfhost.yml的目录执行官方给出的命令docker compose -f docker-compose.selfhost.yml exec -T postgres \ pg_dump -U multica multica multica-backup.sql gzip multica-backup.sql这条命令做的事exec -T postgres在运行中的postgres容器内执行pg_dump不需要在宿主机安装 PostgreSQL 客户端pg_dump -U multica multica以multica用户导出multica库输出重定向到当前目录的multica-backup.sql保证只有pg_dump自身成功退出码为 0时才执行gzip压缩。命令正常走完后当前目录下应有一份multica-backup.sql.gz。pg_dump 陷阱为什么不能直接管道给 gzip一个常见的“省事”写法是把导出直接压缩# 错误写法导出失败时整条管道仍然以 0 退出 docker compose -f docker-compose.selfhost.yml exec -T postgres \ pg_dump -U multica multica | gzip multica-backup.sql.gz官方文档对这个陷阱的说明是shell 报告的管道退出状态是最后一条命令这里是gzip的退出码所以即使pg_dump导出失败整条管道照样以0退出——留下一个格式完全合法、但里面什么都没有的 20 字节压缩包文档中给出的失败产物示例。你以为备份成功文件里实际没有任何数据。先重定向到.sql文件再压缩的写法正是为了规避这一点pg_dump自己的退出码成为整条命令的判定依据导出失败时之后的gzip根本不会执行也就不会产出一个看起来正常的空压缩包。据此判断备份是否成功按正确写法执行后如果命令链未走到gzip出现非零退出码说明导出失败先检查pg_dump的报错例如用户名/库名与.env不一致修复后重新执行不要归档任何“半成品”压缩包。备份时机与边界升级前先备份。官方把这条备份命令放在升级流程docker compose pullup -d之前的位置原因就是迁移 forward-only没有回滚命令。Kubernetes 部署的对照边界。如果你用的是 Helm 部署数据在 PVC 中helm -n multica uninstall multica保留 PVC 与 Secret而kubectl delete namespace multica会删除包括 PostgreSQL 数据和 uploads 在内的一切见 SELF_HOSTING.md 的 Tearing down 一节。本文的docker compose exec导出路径只覆盖 Docker Compose 部署K8s 部署文档未给出对应的导出命令。官方文档目前只给出备份命令没有提供从 dump 文件恢复的操作流程本文覆盖备份这一侧。【免费下载链接】multicaMake humans and AI agents work as one team — open-source and self-hostable.项目地址: https://gitcode.com/GitHub_Trending/mu/multica创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考