使用者痛点这方面，升级担忧与隐藏风险

者最怕升级后程序崩溃。但 Dify 私有化版的迭代带来了可以关注的功能调整。

⚠️ 升级前数据备份

数据是公司主要资产！前务必确保完整备份，这是回滚的唯一依据。其实，

cd dify/docker
# 停止所有服务
docker compose down
# 备份数据卷
tar -cvf dify_backup_v1.9.3.tar ./volumes
# 备份配置文件
cp .env .env.bak

💡 使用者常见问题：为什么我的知识库丢失了？话说回来，

因为遗漏了 /volumes/app/storage 的权限调整！自 v1.9.x 起容器运行权限发生变更，必须手动调整存储目录权限。

🚀 更新代码与配置

拉取最新代码并同步环境变量模板，这是升级成功的关键步骤。按理说，

1. 切换版本

cd ..
git fetch --all
git checkout v1.9.3

2. 同步环境变量

• 生成新模板：cp docker/.env.example docker/.env
• 手动合并：将 .env.bak 中的敏感信息迁移至新 .env
  • SECRETKEY: 加密关键字段。泄露会导致安全漏洞，其实，
  • DBHOST,DBPASSWORD。MODELAPI_KEYS: 数据库连接与AI模型访问密钥。
  • 注意：: 调整后务必检查格式正确性！错误配置可能导致程序瘫痪。

    docker compose config --services

api db_postgres redis worker scheduler celery-beat

bash

"为什么我的数据库连接失败？"

错误原因这方面，.env中DB_HOST=localhost而实际应为db_postgres!

警告这方面，自v1..x起容器运行权限发生重大变更!此操作遗漏会导致API服务无法启动!

bash

sudo chown -R : ./docker/volumes/app/storage

docker compose exec api flask db upgrade

WORKER_CONCURRENCY=4'

检查项	说明
数据库连接		确保.env中的DBHOST和docker-compose中定义的服务名完全一致。否则将报错:"Connection refused"
容器权限		若API服务启动失败,请重新执行chown命令!td/>
任务堆积		若工作流响应慢。可在.env中增加: 'CELERY

知识库问题 若搜索异常,建议在UI界面重新索引或重传知识库!td/>

docker compose ps

docker compose logs -f api | grep "ERROR"

---