MacBook M1 Pro 本机 Docker 部署 Dify + DeepSeek V4-Pro + Ollama 本地谷歌Gemma4 12B大模型终极教程
本文目标:帮助零基础用户在 MacBook M1 Pro(或同类配置机型) 上,通过 Docker 完整部署 Dify 知识库平台,并同时接入 DeepSeek V4-Pro 云端模型与 Ollama 本地大模型(Google Gemma 4 12B),实现"云端+本地"双模型驱动的 AI 工作流。
阅读时长:约 15 分钟
操作时长:约 30-45 分钟
适用平台:macOS + Apple Silicon(M1/M2/M3/M4/M5 系列)
一、为什么要在本地部署 Dify?
Dify 是一款开源的 LLM 应用开发平台,支持知识库管理、工作流编排、Agent 构建等功能。对于开发者而言,本地部署的核心价值在于:
- 数据隐私:敏感业务数据无需上传至第三方平台;
- 模型自由:可同时对接云端 API(如 DeepSeek)与本地模型(如 Ollama);
- 成本可控:本地模型运行零 API 调用费用;
- 深度定制:可修改源码、调整配置、扩展插件。
本文将完整记录从环境准备到双模型跑通的全部过程,并重点记录部署过程中遇到的Docker Compose 版本兼容性等工程化问题及解决方案。
二、环境准备
2.1 硬件与系统要求
本文基于以下环境编写,其他配置可参考调整:
| 项目 | 配置 |
|---|---|
| 机型 | MacBook Pro 14 英寸 |
| 芯片 | Apple M1 Pro |
| 内存 | 32 GB(建议最低 16 GB,本地模型运行需占用较多内存) |
| 系统 | macOS 26.2 |
| 磁盘空间 | 剩余 20 GB 以上(Docker 镜像与模型文件占用较大) |
重要提示:Apple Silicon 芯片(M1/M2/M3/M4/M5)需使用 ARM64 架构的 Docker 镜像。Dify 官方镜像已支持多架构,无需额外配置。
2.2 安装 Docker Desktop
- 访问 Docker 官网 下载 macOS 版本;
- 双击
.dmg文件,将 Docker 拖入 Applications; - 首次启动时,系统会请求授权,点击"允许";
- 进入 Settings → Resources,建议分配至少 4 核 CPU、8 GB 内存、20 GB 磁盘;
- 确认 Settings → General → Use Virtualization Framework 已勾选(Apple Silicon 必需)。
2.3 验证 Docker 与 Docker Compose 版本
打开终端,执行以下命令:
| docker --version docker-compose --version |
预期输出示例:
| Docker version 24.0.7, build afdd53b Docker Compose version v2.23.0 |
关键检查点:本文后续部署涉及 Docker Compose 文件语法兼容性。若你的docker-compose版本低于v2.20.0,可能会遇到与本文相同的版本兼容性问题。建议通过 Docker Desktop 内置的 Compose 插件(docker compose)执行命令,而非独立的docker-compose二进制文件。
本机环境如下:
三、Dify 本机 Docker 部署
3.1 获取 Dify 源码
在终端中执行以下命令,将 Dify 官方仓库克隆到本地:
| cd ~ git clone https://github.com/langgenius/dify.g |