一站式玩转Dify（一）：Mac上快速部署Dify环境（Orbstack+Dify）

一、内容简介

Dify 是一款开源的大语言模型(LLM) 应用开发平台。它融合了后端即服务（Backend as Service）和 LLMOps 的理念，使开发者可以快速搭建生产级的生成式 AI 应用。支持可视化工作流、RAG、智能代理等核心能力。本次在 Mac 端采用 Orbstack 部署 Dify，相比 Docker Desktop，具备原生 Swift 架构、低内存/低CPU占用、轻量化、启动快等优势，完美适配轻量级开发部署。

二、安装 Orbstack(with docker)

本文选用轻量级的Orbstack来安装docker，运用他原生的swift架构将性能资源占用都由于docker desktop，两种方式的对比见官网OrbStack vs. Docker Desktop · OrbStack Docs

简单说下：

- OrbStack是轻量级，不像Desktop那么重那么全面，部署Dify相关的足够了

- Orbstack内置Docker，装完直接Mac中就有docker及docker compose等命令

- Orbstack基于原生Swift，对mac支持更好，运行更快，不怎么占磁盘内存

执行命令安装

brew install orbstack

安装完成后，双击打开 Orbstack 完成首次初始化，随后关闭即可；

终端输入docker --version，docker compose version，输出版本号即环境就绪。

三、配置Docker国内镜像地址

解决国内docker镜像拉取超时、中断问题

编辑配置文件

vim ~/.orbstack/config/docker.json

将如下镜像地址配置写入文件：

{ "registry-mirrors": [ "https://docker.1ms.run", "https://docker.xuanyuan.me", "https://docker.m.daocloud.io" ] }

重启docker，使镜像地址生效

orb restart docker

如遇到如下报错：

[-32098] read docker config: merge docker config: unmarshal overlay json: invalid character '\u00a0' looking for beginning of object key string

执行命令修复

sed -i '' $'s/\xc2\xa0/ /g' ~/.orbstack/config/docker.json

验证镜像地址是否生效

docker info | grep -A 5 "Registry Mirrors"

输出配置的镜像地址即生效。

四、拉取Dify源码

网络稳定用官方源，超时切换国内Gitee源

# 官方Github源

git clone https://github.com/langgenius/dify.git

# 国内Gitee备用源

git clone https://gitee.com/dify_ai/dify.git

五、初始化环境配置

cd ./dify/docker && cp .env.example .env

六、启动Dify服务

# 前台拉取中间件镜像PostgreSQL/Redis/Weaviate（防止网络不稳中断）

docker compose up

# 镜像拉取完成后，Ctrl+C终止，加-d参数后台启动服务

docker compose up -d

确认这些镜像服务是否ready

docker compose ps

列出的每个容器都是Up或health状态

七、访问Dify

浏览器打开地址http://localhost/，按提示完成初始化注册即可使用。