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"