Dify与RAGFlow同机部署的Redis冲突解决方案：端口与实例名调整实战

最新推荐文章于 2026-06-19 14:53:02 发布

原创

最新推荐文章于 2026-06-19 14:53:02 发布 · 857 阅读

1. 问题背景与现象分析

最近在尝试将Dify和RAGFlow部署到同一台服务器时，遇到了一个让人头疼的问题：RAGFlow突然无法登录了。经过排查发现，原来是Dify的部署把RAGFlow的Redis实例给删除了。这种情况在同时部署多个依赖Redis的服务时并不少见，但每次遇到还是会让人措手不及。

深入分析后发现，问题的根源在于两个服务都使用了默认的Redis配置。具体表现为：

两个服务的Redis容器名称都叫"redis"
两个服务的Web端口都默认使用80和443
当Dify执行docker compose down时，会误删RAGFlow的Redis容器

这种冲突会导致RAGFlow无法连接到Redis，进而引发登录失败。在实际生产环境中，这种问题可能会造成服务中断，因此需要特别注意。

2. 冲突原因深度解析

要彻底解决这个问题，我们需要先理解Docker Compose的工作机制。当多个服务使用相同的容器名称时，后启动的服务会覆盖先前的服务。具体到我们的场景：

Redis实例名称冲突：
- Dify和RAGFlow的docker-compose.yml中都定义了一个名为"redis"的服务
- Docker无法区分这两个Redis实例，导致操作一个会影响另一个
端口占用问题：
- 两个服务默认都使用80(HTTP)和443(HTTPS)端口
- 当第一个服务占用了这些端口，第二个服务就无法启动
环境隔离不足：
- 默认情况下，Docker Compose会将所有服务放在同一个网络中
- 缺乏适当的网络隔离会导致服务间相互干扰

理解这些底层机制后，我们就能有针对性地制定解决方案了。

3. 解决方案：修改Redis实例名称

解决Redis冲突最直接的方法就是修改其中一个服务的Redis实例名称。这里我们选择修改Dify的配置，因为它的配置相对简单。

3.1 修改docker-compose.yml

找到Dify的docker-compose.yml文件，搜索"redis"部分，修改为以下配置：

# The redis cache.
cache:
  image: redis:6-alpine
  restart: no
  environment:
    REDISCLI_AUTH: ${REDIS_PASSWORD:-difyai123456}
  volumes:
    # Mount the redis data directory to the conta

标签