Dify升级到1.5.1详细操作步骤，规避和RAGFlow的镜像冲突问题
一、步骤概述
官方给出了操作方法。其核心步骤就是：
停止服务：在更新之前，先停止当前运行的服务。
备份文件：确保备份重要文件，包括 docker-compose.yaml 文件、.env 文件和 volumes 目录。
拉取新的版本相关文件。
更新文件：使用目标版本的对应文件（如 Dify v1.5.1），并更新相关参数，如 URL、数据库密码等。
启动更新后的服务。 清理旧镜像：可以选择清理不再需要的旧镜像以节省空间。 通过这些步骤，可以顺利完成 Dify 的版本升级。
二、停止服务
docker compose down
三、备份参数和数据
cp docker-compose.yaml docker-compose.yaml.20250709
cp .env .env.20250709
tar -cvf volumes-20250709.tgz volumes
压缩的时候可能会报错，也可以用winrar的压缩自行备份，直接拷贝目录也行。
三、拉取最新版本
git checkout main
git pull origin main
注意：拉取的过程需要开启科学上网。有时还需要登录docker。
四、修改参数
在本机用docker安装了ragflow的情况下防止镜像冲突，需要修改默认容器和端口，如果感觉还不保险可以指定network，这里我只修改默认容器，用不同容器和端口来隔离。
内容很长，举两个片段，看标红颜色的地方，就是指定容器。
# The redis cache.
redis:
image: redis:6-alpine
container_name: dify-redis
restart: always
environment:
REDISCLI_AUTH: ${REDIS_PASSWORD:-difyai123456}
volumes:
# Mount the redis data directory to the container.
- ./volumes/redis/data:/data
# Set the redis password when startup redis server.
command: redis-server --requirepass ${REDIS_PASSWORD:-difyai123456}
healthcheck:
test: [ 'CMD', 'redis-cli', 'ping' ]
# The DifySandbox
sandbox:
image: langgenius/dify-sandbox:0.2.12
container_name: dify-sandbox
restart: always
environment:
# The DifySandbox configurations
# Make sure you are changing this key for your deployment with a strong key.
# You can generate a strong key using `openssl rand -base64 42`.
API_KEY: ${SANDBOX_API_KEY:-dify-sandbox}
GIN_MODE: ${SANDBOX_GIN_MODE:-release}
WORKER_TIMEOUT: ${SANDBOX_WORKER_TIMEOUT:-15}
ENABLE_NETWORK: ${SANDBOX_ENABLE_NETWORK:-true}
HTTP_PROXY: ${SANDBOX_HTTP_PROXY:-http://ssrf_proxy:3128}
HTTPS_PROXY: ${SANDBOX_HTTPS_PROXY:-http://ssrf_proxy:3128}
SANDBOX_PORT: ${SANDBOX_PORT:-8194}
PIP_MIRROR_URL: ${PIP_MIRROR_URL:-}
volumes:
- ./volumes/sandbox/dependencies:/dependencies
- ./volumes/sandbox/conf:/conf
healthcheck:
test: [ 'CMD', 'curl', '-f', 'http://localhost:8194/health' ]
networks:
- ssrf_proxy_network
如果要嫌一个个改yml文件中每个镜像的容器名称繁琐，可以采用下面第五段中第二段中的方法，在启动容器时指定项目名称。当然这个依然还要在yml中改web端口和redis端口，使两个项目不冲突。
五、启动服务
检查Docker Compose版本：
docker compose version
根据docker版本选择启动命令，注意此处也需要科学上网：
V2版本执行：
docker compose up -d
V1版本执行：
docker-compose up -d
如果指定项目名称规避和ragflow的镜像冲突，用下面指令：
docker compose -p docker-dify up -d
docker-compose-p docker-dify up -d
