Docker Compose部署Yacht后仪表盘无法加载，报Internal Server Error

问题原因 #

错误提示的readlink /var/lib/docker/overlay2/l/<id>: no such file or directory，是Docker overlay2存储驱动的临时层链接失效或损坏导致的。Yacht通过挂载的/var/run/docker.sock访问Docker API时，需要读取这些链接获取容器文件系统信息，链接丢失就会触发内部服务器错误。

解决步骤 #

• 停止并彻底清理现有Yacht容器和关联卷：

  docker-compose down -v
  

  （-v参数会删除Yacht的配置卷，避免缓存的错误数据干扰）

• 清理Docker失效资源并重启服务：

  1. 停止所有运行中的容器：

     docker stop $(docker ps -aq)
     

  2. 重启Docker服务（根据系统环境选择命令）：
     • Linux（systemd系统）：

       systemctl restart docker
       

     • Windows/macOS：打开Docker Desktop，点击右上角菜单选择Restart
  3. 强制清理所有未使用的Docker资源（镜像、容器、卷、网络）：

     docker system prune -af
     

     （注意：此操作会删除未在使用的Docker资源，确认这些资源无保留必要后再执行）

• 重新部署Yacht：

  docker-compose up -d
  

• （可选）验证Docker存储驱动：
  确认Docker使用的是overlay2存储驱动（现代系统默认都是，若不是可能需要调整）：

  docker info | grep "Storage Driver"
  

内容的提问来源于stack exchange，提问作者El3ctro4ndre