Dify数据备份与迁移一、前言二、Dify哪些东西需要备份三、第一步日常备份每天做一次防止丢数据1. 打开服务器终端2. 备份数据库最重要所有配置都在这3. 备份上传的文件PDF/Word原文件4. 备份配置文件.env5. 把备份文件下载到本地电脑最关键四、第二步迁移到新服务器换服务器不丢数据1. 新服务器先安装好Dify2. 把旧服务器的备份文件上传到新服务器3. 恢复数据库核心所有配置都回来4. 恢复上传的文件PDF/Word原文件回来5. 恢复配置文件端口、密钥回来6. 启动新服务器的Dify7. 登录新Dify数据完全一样五、第三步数据恢复出事了救回来1. 先停掉Dify服务2. 恢复数据库3. 恢复上传文件4. 恢复配置文件5. 重启Dify六、日常备份习惯七、常见问题1. 备份命令报错2. 恢复后登录不上3. 知识库文件不见了一、前言前面我们学会了部署、聊天机器人、知识库、工作流、AI网关。但最容易踩一个大坑服务器崩了、误删文件、重装系统、换服务器、升级Dify版本 →所有数据全丢辛辛苦苦上传的PDF/Word知识库没了做了很久的聊天机器人、工作流没了配置好的模型密钥、权限、日志全没了备份保命迁移换房子不丢东西。本篇用最容易理解、最简单的方式介绍怎么备份所有数据防止丢怎么迁移到新服务器换机器不丢东西怎么恢复数据出事了能救回来二、Dify哪些东西需要备份最主要的有3样数据库存所有配置、应用、知识库索引、用户数据上传的文件PDF、Word、TXT原文件配置文件.env存端口、密钥、路径一句话备份这3样换服务器/重装/升级数据一点都不会丢。三、第一步日常备份每天做一次防止丢数据1. 打开服务器终端Windows打开WSL2或Xshell/FinalshellLinux/macOS打开终端输入命令前全程复制粘贴不要手动敲避免输错2. 备份数据库最重要所有配置都在这复制下面整条命令粘贴回车dockerexec-tdocker-postgres-1 pg_dumpall-Upostgres/usr/local/dify_backup.sql解释把Dify里所有数据应用、知识库、配置、用户打包成一个文件dify_backup.sql保存位置/usr/local/服务器里看到命令执行完、没报错就是成功了3. 备份上传的文件PDF/Word原文件复制下面整条命令粘贴回车cp-r/usr/local/dify/volumes /usr/local/dify_files_backup解释把你上传的所有PDF、Word、TXT原文件复制一份备份备份文件夹dify_files_backup4. 备份配置文件.env复制下面整条命令粘贴回车cp/usr/local/dify/docker/.env /usr/local/dify_env_backup解释把端口、密钥、路径这些配置文件备份一份5. 把备份文件下载到本地电脑最关键服务器备份完还不够一定要下载到自己电脑防止服务器崩了连备份都没了。打开FileZilla、WinSCP、宝塔文件管理器随便一个文件传输工具连接服务器找到路径/usr/local/下载3个文件/文件夹dify_backup.sql数据库备份dify_files_backup上传文件备份dify_env_backup配置备份记住备份下载到本地双重保险绝对不会丢数据。四、第二步迁移到新服务器换服务器不丢数据场景旧服务器到期、太慢、坏了 → 换一台新服务器所有数据原样搬过去。1. 新服务器先安装好Dify新服务器步骤用Docker Compose安装好干净的Dify安装后不要初始化、不要登录、不要配置任何东西直接停服务cd/usr/local/dify/dockerdockercompose down解释新服务器装个空的Dify停掉服务准备恢复旧数据。2. 把旧服务器的备份文件上传到新服务器用文件传输工具把旧服务器下载到本地的3个备份文件上传到新服务器的/usr/local/目录3. 恢复数据库核心所有配置都回来复制下面整条命令粘贴回车cd/usr/local/dify/dockerdockercompose up-dpostgressleep10dockerexec-idocker-postgres-1 psql-Upostgres-dpostgres/usr/local/dify_backup.sql解释先启动数据库容器等待10秒让数据库就绪把旧数据库数据恢复到新数据库没报错就是成功4. 恢复上传的文件PDF/Word原文件回来复制下面整条命令粘贴回车rm-rf/usr/local/dify/volumescp-r/usr/local/dify_files_backup /usr/local/dify/volumes解释把旧的上传文件复制到新Dify的文件目录5. 恢复配置文件端口、密钥回来复制下面整条命令粘贴回车cp/usr/local/dify_env_backup /usr/local/dify/docker/.env6. 启动新服务器的Dify复制下面整条命令粘贴回车cd/usr/local/dify/dockerdockercompose up-d7. 登录新Dify数据完全一样打开浏览器访问新服务器IP端口直接用旧账号密码登录所有聊天机器人、工作流都在所有知识库、上传的PDF都在所有模型配置、权限、网关都在总结换服务器装空Dify→传备份→恢复3样→启动数据100%原样迁移零难度。五、第三步数据恢复出事了救回来场景误删数据、服务器出问题、升级出错 → 用备份恢复数据。1. 先停掉Dify服务cd/usr/local/dify/dockerdockercompose down2. 恢复数据库dockercompose up-dpostgressleep10dockerexec-idocker-postgres-1 psql-Upostgres-dpostgres/usr/local/dify_backup.sql3. 恢复上传文件rm-rf/usr/local/dify/volumescp-r/usr/local/dify_files_backup /usr/local/dify/volumes4. 恢复配置文件cp/usr/local/dify_env_backup /usr/local/dify/docker/.env5. 重启Difycd/usr/local/dify/dockerdockercompose up-d总结恢复停服务→恢复3样→重启数据直接回到备份时的状态。六、日常备份习惯每天备份一次复制备份命令执行每周下载一次把备份文件下载到本地电脑升级/改配置前必备份防止操作失误丢数据一句话备份不麻烦丢数据才麻烦养成习惯永远不丢数据。七、常见问题1. 备份命令报错检查路径是否正确/usr/local/复制命令时不要漏字符、不要多空格确保Dify的postgres容器正常运行2. 恢复后登录不上用旧服务器的账号密码登录检查配置文件.env是否恢复成功重启Difydocker compose restart3. 知识库文件不见了检查/usr/local/dify/volumes是否恢复成功重新上传备份的文件即可