零基础也能搞定！Windows11+Docker快速部署Dify的保姆级教程

Windows 11 零基础部署 Dify从 Docker 安装到应用配置全指南最近在帮几个完全没接触过 Docker 的朋友部署 Dify 时发现市面上大多数教程都默认读者已经具备一定技术基础。这让我意识到对于真正的新手来说从零开始的完整指引其实非常稀缺。本文将用最直白的语言带你一步步完成 Windows 11 系统下的 Dify 部署每个操作都配有详细截图和问题排查方法。1. 准备工作与环境检查在开始之前我们需要确保你的 Windows 11 系统满足基本要求。建议使用最新版本的 Windows 11 22H2 或更高版本系统类型需要是 64 位操作系统。你可以通过以下步骤检查右键点击开始菜单选择系统在关于页面查看Windows 规格和系统类型提示如果你的系统是 Windows 10大部分步骤也适用但建议升级到 Windows 11 以获得更好的 Docker 支持硬件方面建议至少4GB 内存8GB 或以上更佳20GB 可用磁盘空间支持虚拟化的 CPU大多数现代处理器都支持验证 CPU 虚拟化支持systeminfo | find Hyper-V 要求如果看到已检测到虚拟机监控程序说明虚拟化已启用如果显示否则需要进入 BIOS 启用虚拟化技术具体方法因主板品牌而异。2. Docker 安装与基础配置2.1 下载和安装 Docker Desktop访问 Docker 官网下载页面选择Download for Windows版本。这里有个小技巧如果你不确定该下载哪个版本直接选择推荐的 Docker Desktop 安装包即可。安装过程中有几个关键选项需要注意勾选Use WSL 2 instead of Hyper-V推荐安装完成后不要立即重启先完成后续配置安装完成后你会在开始菜单中找到 Docker Desktop 快捷方式。首次运行时可能会看到以下提示Docker Desktop starting...这可能需要几分钟时间特别是在第一次启动时。2.2 验证 Docker 安装打开命令提示符CMD或 PowerShell输入docker --version如果安装成功你会看到类似这样的输出Docker version 24.0.2, build cb74dfc接下来测试一个简单的容器docker run hello-world这个命令会下载一个小型测试镜像并运行它。如果一切正常你将看到Hello from Docker!的欢迎信息。2.3 配置 Docker 镜像加速由于网络原因直接从 Docker Hub 拉取镜像可能会很慢。我们可以配置国内镜像源来加速下载右键点击系统托盘中的 Docker 图标选择Settings导航到Docker Engine选项卡在配置文件中添加或修改以下内容registry-mirrors: [ https://docker.mirrors.ustc.edu.cn, https://hub-mirror.c.163.com ]点击Apply Restart保存设置并重启 Docker3. 获取 Dify 项目文件3.1 安装 Git 工具虽然可以直接下载 ZIP 包但我强烈建议安装 Git因为后续更新会更方便。从 Git 官网下载 Windows 版安装程序安装时保持默认选项即可。验证 Git 安装git --version3.2 克隆 Dify 仓库选择一个合适的目录存放 Dify 项目比如 D:\dify。打开命令提示符执行cd D: mkdir dify cd dify git clone https://github.com/langgenius/dify.git这个过程可能会花费一些时间因为 Dify 的仓库比较大约 80MB。注意如果遇到网络问题导致克隆失败可以尝试多次执行命令或者使用 GitHub 的 ZIP 下载功能4. 配置和启动 Dify 服务4.1 准备环境变量进入 Dify 的 docker 目录cd dify/docker这里我们需要创建一个 .env 文件来配置必要的环境变量。复制提供的示例文件copy .env.example .env然后用文本编辑器如 Notepad 或 VS Code打开 .env 文件至少需要设置以下关键参数DB_PASSWORDyour_strong_password DB_USERNAMEdify DB_DATABASEdify4.2 启动 Docker 容器确保 Docker Desktop 正在运行然后执行docker compose up -d这个命令会下载所有必需的 Docker 镜像并启动容器。首次运行可能需要较长时间取决于你的网速因为需要下载多个 GB 的镜像文件。你可以用以下命令查看容器状态docker ps正常情况下你应该看到 8-10 个运行中的容器包括 api、web、worker 等。4.3 常见问题排查如果遇到容器启动失败的情况可以查看特定容器的日志docker logs docker-api-1将api替换为你想查看的容器名称。常见问题及解决方法端口冲突如果 80 端口被占用可以修改 docker-compose.yml 中的端口映射磁盘空间不足Docker 镜像会占用大量空间确保有至少 20GB 可用空间内存不足在 Docker 设置中增加内存分配建议至少 4GB5. 初始化 Dify 应用5.1 访问 Dify 管理界面所有容器成功启动后打开浏览器访问http://localhost你应该会看到 Dify 的初始化页面。第一次访问时系统会自动进行数据库迁移等初始化操作这可能需要几分钟时间。5.2 配置管理员账户按照页面提示设置管理员邮箱和密码配置 SMTP 邮件服务可选但推荐设置以便密码重置设置系统名称和 logo5.3 连接 AI 模型服务Dify 本身不提供 AI 模型需要连接第三方 API进入设置 模型供应商添加 OpenAI、Anthropic 或其他支持的 API 密钥测试连接确保配置正确专业建议初次使用时可以先配置 OpenAI 的 GPT-3.5 模型进行测试它的成本较低且响应速度快6. 创建你的第一个 AI 应用现在让我们创建一个简单的问答应用点击创建应用选择对话型应用输入应用名称和描述在提示词编排页面可以尝试以下简单模板你是一个乐于助人的AI助手。请用友好、专业的语气回答用户问题。 用户问题{{query}}保存并发布应用你可以立即在右侧的测试窗格中与你的 AI 应用交互。试着问它一些问题看看效果如何。7. 日常维护与更新7.1 停止和启动服务当不需要使用 Dify 时可以停止容器以节省资源docker compose down需要时再启动docker compose up -d7.2 更新 Dify 版本要更新到最新版本cd D:/dify/dify git pull cd docker docker compose down docker compose up -d --build7.3 数据备份最重要的是定期备份你的数据库docker exec docker-db-1 pg_dump -U dify dify dify_backup.sql这个命令会将数据库导出到当前目录下的 dify_backup.sql 文件。8. 进阶配置与优化8.1 性能调优如果你的机器配置较高可以调整 docker-compose.yml 中的资源限制services: api: deploy: resources: limits: cpus: 2 memory: 4G8.2 启用 HTTPS对于生产环境建议启用 HTTPS在 .env 文件中设置 CERTBOT_EMAIL 和 CERTBOT_DOMAIN修改 nginx 配置以支持 SSL重新生成容器docker compose up -d --force-recreate8.3 多语言支持Dify 支持多语言界面在系统设置中修改默认语言创建多语言提示词模板配置自动语言检测在实际项目中我发现将 Docker 数据目录移动到非系统盘可以显著提高性能。只需在 Docker Desktop 的设置中修改Advanced选项卡下的磁盘镜像位置即可。另外定期运行docker system prune可以清理不再使用的镜像和容器节省磁盘空间。