核心结论：本教程基于直播实操流程，拆解Mac和Windows系统下Docker安装、Dify部署及模型配置的完整步骤，含避坑要点和问题解决，零基础可按步骤落地。
一、前期准备
1. 安装包获取
- Mac系统（苹果芯片/英特尔芯片）：从直播群下载对应安装包，苹果芯片和英特尔芯片版本需区分，避免下错。
- Windows系统：从直播群下载安装包，优先选择AMD格式（多数Windows设备适配）。
- 注意：无需提前修改代理地址、配置文件等，默认设置即可，乱改易导致后续运行崩溃。
2. 设备环境确认
- Mac系统：无特殊要求，直接安装即可。
- Windows系统：需提前确认开启虚拟化（后续步骤详解），未开启会导致Docker无法正常运行。
二、Docker安装步骤
（一）Mac系统安装
- 双击下载的Docker安装包，按提示"下一步"完成安装，无需额外配置。
- 安装完成后，Docker会自动启动，右下角（或左下角）显示绿色"Running"标识，说明启动成功。
- 若弹出注册登录提示，需完成账号验证（邮箱接收验证码），未验证会导致后续运行报错。
- 验证完成后，Docker界面为空属正常现象，无需操作。
（二）Windows系统安装（关键步骤，需按顺序）
- 开启虚拟化检查：右键任务栏→打开"任务管理器"→切换到"性能"选项卡→查看"虚拟机"项，显示"已启用"则正常，显示"已禁用"需后续开启。
- 安装WSL（Windows子系统）：
- 搜索"命令提示符"→选择"以管理员身份运行"。
- 输入指令"WSL --install"（复制群内指令直接粘贴），按回车，系统会自动安装Ubuntu（Linux子系统）。
- 安装完成后，系统会提示"重启电脑"，务必重启（不重启后续无法安装Docker）。
- 安装Docker：
- 重启后，双击Docker安装包，进入安装界面。
- 关键选项：勾选"Use WSL instead of Hyper-V (recommend)"，未勾选会导致兼容性问题。
- 按提示完成安装，安装后查看Docker是否显示"Running"标识。
- 常见问题解决：
- 虚拟化未开启：进入BIOS系统（不同电脑快捷键不同，常见F2、Del）→找到"高级选项"→开启"虚拟化技术"（英特尔CPU关键词"Intel VT-x"，AMD CPU关键词"AMD-V"）。
- Hyper-V冲突：按"Win+R"→输入"optional features"→弹出"启用Windows功能"→取消"Hyper-V"勾选→重启电脑。
三、Dify部署步骤
1. 下载Dify源代码
- 从直播群下载Dify压缩包（约159兆），或从GitHub官网下载（需能访问海外资源，群内提供替代下载链接）。
- 下载后解压到电脑任意文件夹，建议将文件夹命名为"dify"（避免后续路径识别问题）。
2. 配置终端路径
（1）Mac系统
- 找到解压后的"dify"文件夹→进入"Docker"子文件夹。
- 右键任意文件名→选择"显示简介"→复制"位置"中的路径（后续终端需使用）。
（2）Windows系统
- 找到解压后的"dify"文件夹→进入"Docker"子文件夹。
- 在地址栏最前方输入"CMD "（注意空格），按回车，直接进入该路径的终端界面。
3. 复制环境变量文件
- 在终端中输入群内提供的复制指令（核心作用：拷贝.env.example文件为.env，存储环境变量），按回车执行。
- 注意：.env文件为隐藏文件，Mac系统按"Command+Shift+. "显示隐藏文件，Windows系统需开启"显示隐藏项目"。
- 严禁修改.env文件内的任何内容（如IP地址、端口号等），默认配置已适配，修改会导致报错。
4. 拉取Docker镜像（部署核心步骤）
- 确认Docker处于"Running"状态，终端已进入"dify/Docker"路径。
- 输入指令"docker-compose -p dify up -d"（群内提供现成指令，直接复制粘贴），按回车。
- 系统会自动识别缺失的依赖镜像，逐一下载（约3-5个G，耗时取决于网速），下载过程中终端会显示进度。
- 下载完成后，Docker界面"Containers"项会显示多个运行中的容器（如sandbox、db、web等），均为绿色"Running"标识则部署成功。
5. 网络问题解决（下载慢/下载失败）
- 若无法访问海外资源，需配置国内镜像源：
- 打开Docker→右上角"设置"→找到"Docker Engine"选项。
- 在配置文件中添加国内镜像地址（群内提供可靠地址，如宝塔面板镜像），格式为数组形式（需加引号和逗号）。
- 点击"Apply & Restart"，重启Docker后重新执行拉取镜像指令。
- 注意：镜像源可能失效，若配置后仍无法下载，可换用群内提供的替代镜像地址。
四、Dify初始化配置
1. 访问Dify界面
- 打开浏览器，在地址栏输入"localhost/install"，进入Dify初始化页面。
- 填写账号信息：邮箱（任意有效邮箱即可，无需验证）、用户名、密码（需牢记，后续登录使用）。
- 点击"设置"，直接进入Dify主界面，初始化完成。
2. 模型配置
- 点击右上角用户名→选择"设置"→切换到"模型供应商"选项卡。
- 推荐安装3个模型（按需选择，至少安装2个）：
- Deepseek：配置简单、额度充足且便宜，适合日常使用。
- 通义千问：支持视觉识别，下节课必备。
- Kimi：适合代码编写，后续实操常用。
- 模型配置步骤（以通义千问为例）：
- 点击"安装"，等待安装完成后点击"设置"。
- 跳转阿里云百炼平台（群内提供链接）→登录账号→创建/复制API Key。
- 将API Key粘贴到Dify模型配置框，"使用国际端点"选择"否"→点击"保存"。
- 若报错"Internal Server Error"，可尝试降级模型版本（如选择5.4版本）。
五、关键注意事项
- 所有指令均从群内复制粘贴，避免手动输入（易出错），执行指令后需查看系统反馈，不看反馈直接下一步易踩坑。
- 卸载重装：若安装过程中出错，直接卸载Docker→删除WSL（群内提供卸载指令）→重新按步骤安装，无需保留残留文件。
- 资源配置：Docker设置中，内存（Memory）建议至少分配8GB（默认可能为2GB，需手动调整），避免因内存不足导致崩溃（设置路径：Docker→Settings→Resources→调整内存大小）。
- 后续使用：每次启动Dify前，需确保Docker已启动（显示"Running"），否则无法访问"localhost/install"界面。
六、常见问题速查
- Mac系统Docker安装后打不开：右键Docker图标→"退出"→重新启动，仍无效则卸载重装。
- Windows系统WSL安装失败：以管理员身份重新运行命令提示符，重新输入"WSL --install"，确保网络正常。
- Dify镜像拉取慢：配置国内镜像源，或换用更快的网络（推荐联通、电信宽带）。
- 模型配置报错：检查API Key是否正确，国际端点是否选择"否"，版本是否适配。