作为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)版本过于老旧,需要运行以下命令进行更新

我们可以通过以下步骤来解决:
方法步骤
-
以管理员身份打开 PowerShell:
-
按下键盘上的
Win + R组合键,打开 “运行” 对话框。

-
在对话框中输入
powershell,然后按下回车键,即可打开 PowerShell 窗口点击复制命令
-

-
执行更新命令:
然后会弹出这样的一个窗口

-
在打开的 PowerShell 窗口中,输入
wsl --update命令,然后按下回车键:点击复制命令

-
系统会自动下载并安装 WSL 的更新,这个过程可能需要一些时间,具体取决于你的网络速度和更新文件的大小

-
重启电脑:
-
更新完成后,关闭 PowerShell 窗口,并重启你的计算机
-

-
重启 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:是否开启魔法工具,所有境外网站的访问都需要使用才可以访问
