Docker 部署 Langfuse 遇到 Redis 镜像拉取失败解决方案

Docker 部署 Langfuse 遇到 Redis 镜像拉取失败解决方案

在安装 Langfuse 的过程中，可能会遇到如下错误：

Error response from daemon: failed to resolve reference "docker.io/library/redis:7": failed to do request: Head "https://registry-1.docker.io/v2/library/redis/manifests/7": dialing registry-1.docker.io:443 container via direct connection because Docker Desktop has no HTTPS proxy: connecting to registry-1.docker.io:443: dial tcp [2a03:2880:f12c:83:face:b00c:0:25de]:443: connectex: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.

问题排查

执行 ping 命令测试网络连通性：

ping registry-1.docker.io

结果显示无法稳定连接。尝试使用 AI 助手查询解决方案，但未能找到直接有效的修复方法。

解决方案

修改 Docker Desktop 的引擎配置，添加镜像加速地址和 DNS 设置。

1. 打开 Docker Desktop UI。
2. 进入 Settings -> Docker Engine。
3. 将输入框的内容替换为以下 JSON 配置：

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "features": {
    "buildkit": true
  },
  "registry-mirrors": [
    "https://dockerpull.pw",
    "https://dockerhub.icu",
    "https://hub.rat.dev",
    "https://register.librax.org",
    "https://docker-0.unsee.tech",
    "https://docker-cf.registry.cyou",
    "https://docker.1panel.live"
  ],
  "dns": [
    "8.8.8.8",
    "114.114.114.114"
  ]
}

如图所示：

4. 修改之后，点击【Apply & Restart】按钮。

5. 然后再执行 docker compose up 命令：

6. 再次查看 Docker 界面，确认服务已启动成功：

此时 Langfuse 应能正常运行。