1.2.1.1 Docker

2025年11月04日
作为Windows系统,如果你打算在本地运行 Dify,那么 Docker Desktop 基本是你绕不开的一步
它就像一艘小船,帮你把各种开发环境和应用运到你的电脑上。不过,如果你的 Windows 版本太老,就像码头设施不够齐全,小船可能根本停不下来——所以我们在开始之前要先确认环境
简单说,Docker Desktop 对电脑环境有一定要求:
  • Windows 10(版本1903及以上)或者 Windows 11,且开启了 WSL 2(Windows Linux 子系统)功能;
  • 系统需要是64位,且支持虚拟化技术;
  • 电脑硬盘空间建议预留至少20GB以上,毕竟后面会下载镜像和容器文件。
如果你的电脑版本过低或者不满足以上要求,建议先升级系统,或者考虑用云端环境运行 Dify,本地部署可能会遇到各种兼容性问题。我们自己也尝试过不少解决方案,花了不少时间,结果都没能彻底解决
你不需要有复杂的技术背景,也不用被各种英文提示吓到,照着做就行,中途如果碰到 WSL 版本过旧、镜像下载慢、系统盘空间不够这些常见坑,我们也会一起解决,让你少走弯路、少踩坑
如果是非Windows系统,请参考官方文档,这里不做赘述:点击直达

1:下载与安装

 
首先点击这里:Docker官网,打开官网,下载Windows版的
 
下载好之后,直接点击打开即可
 
打开之后会弹出这个界面,我们安装的是当前最新版本4.43.1
中间还有一个Allow Windows containers to be used with this installation需要点击
允许Windows容器与此安装一起使用
 
把它也勾选上,然后点击ok
 
接下来程序就会开始运行,跟我们安装软件的流程一样,比较简单
 
安装好之后,需要重启电脑,大家点击这个蓝色的按钮即可进行重启
 
重启之后我们的电脑会弹出一个这样的界面,点击Accept
如果大家没有弹出的话,在桌面上点击一下图标就会弹出
 

2:Docker启用相关步骤及问题

 
接下来会弹出这个界面,大家不要点击蓝色按钮进行登陆注册
直接点击下方的Continue继续即可
 
这里出现报错,说我们的Windows Linux子系统(WSL)版本过于老旧,需要运行以下命令进行更新
 
我们可以通过以下步骤来解决:

方法步骤

  1. 以管理员身份打开 PowerShell
     
    1. 按下键盘上的 Win + R 组合键,打开 “运行” 对话框。
     
    1. 在对话框中输入 powershell ,然后按下回车键,即可打开 PowerShell 窗口点击复制命令
 
  1. 执行更新命令:
然后会弹出这样的一个窗口
  • 在打开的 PowerShell 窗口中,输入 wsl --update 命令,然后按下回车键:点击复制命令
  • 系统会自动下载并安装 WSL 的更新,这个过程可能需要一些时间,具体取决于你的网络速度和更新文件的大小
  1. 重启电脑:
    1. 更新完成后,关闭 PowerShell 窗口,并重启你的计算机
  1. 重启 Docker Desktop:
重启后,点击桌面上的图标,打开Docker
打开是这样,我们点击Continue
然后会显示这个界面,说明我们的Docker desktop已经安装配置完毕
 
 

3:配置Docker镜像源及存储位置

 

配置镜像源

接下来需要在Docker Desktop中设置Docker下载image的镜像源:点击设置
 
然后点击Doceker Engine,接下来需要在蓝色方框内加上一段代码
为了防止镜像失效,拉取报错,所以这里我们多加一些镜像点击复制命令
"registry-mirrors": [
    "https://registry.docker-cn.com",   
    "https://s4uv0fem.mirror.aliyuncs.com",    
    "https://docker.1ms.run",    
    "https://registry.dockermirror.com",    
    "https://docker.m.daocloud.io",    
    "https://docker.kubesre.xyz",    
    "https://docker.mirrors.ustc.edu.cn",   
     "https://docker.1panel.live",    
     "https://docker.kejilion.pro",    
     "https://dockercf.jsdelivr.fyi",   
      "https://docker.jsdelivr.fyi",   
       "https://dockertest.jsdelivr.fyi",    
       "https://hub.littlediary.cn",    
       "https://proxy.1panel.live",   
        "https://docker.1panelproxy.com",    
        "https://image.cloudlayer.icu",    
        "https://docker.1panel.top",    
        "https://docker.anye.in",    
        "https://docker-0.unsee.tech",   
         "https://hub.rat.dev",   
          "https://hub3.nat.tf",    
          "https://docker.1ms.run",    
          "https://func.ink",    
          "https://a.ussh.net",    
          "https://docker.hlmirror.com",    
          "https://lispy.org",   
           "https://docker.yomansunter.com",    
           "https://docker.xuanyuan.me",    
           "https://docker.mybacc.com",    
           "https://dytt.online",    
           "https://docker.xiaogenban1993.com",   
            "https://dockerpull.cn",    
            "https://docker.zhai.cm",    
            "https://dockerhub.websoft9.com",   
             "https://dockerpull.pw",   
              "https://docker-mirror.aigc2d.com",    
              "https://docker.sunzishaokao.com",   
               "https://docker.melikeme.cn" 
 ]
注意是直接粘贴进来,不要更改任何内容
由于语法需要,粘贴进来之后,记得在false后面添加一个 ,
设置好之后,点击Apply
 

配置存储位置

因为后续Docker 镜像、容器和卷会占用大量磁盘空间(尤其是在开发环境中),长期使用可能导致系统盘爆满,影响系统性能,所以需要配置别的盘来作为存储位置
在配置之前,我们需要在目标存储盘中创建好一个空的文件夹(最好为二级目录)
在D盘新建一个文件夹即可,新建文件夹的名称为:docker-local-images
 
然后点击Resources,再点击蓝色按钮,选择刚刚新建的文件夹
 
改好之后,点击Apply
 
在弹窗中选择红色按钮
 
接下来需要重启一下Docker,这些配置才会生效
鼠标右击电脑右下角的这个小船一样的图标
 
在弹窗中选择Restart,即可完成重启

常见问题解答:
Q:为什么我打不开Docker官网? A:是否开启魔法工具,所有境外网站的访问都需要使用才可以访问