桌面左上角-关于本机
使用推荐设置(需要密码)
。这会让 Docker Desktop 自动设置必要的配置设置。Docker.dmg从页面顶部的下载按钮或发行 说明下载后,在终端中运行以下命令在应用程序文件夹中安装 Docker Desktop:
sudo hdiutil attach Docker.dmg
sudo /Volumes/Docker/Docker.app/Contents/MacOS/install
sudo hdiutil detach /Volumes/Docker
默认情况下,Docker Desktop 安装在/Applications/Docker.app。由于 macOS 通常在第一次使用应用程序时执行安全检查,因此该install命令可能需要几分钟才能运行。
该install命令接受以下标志:
为 Docker 虚拟机(VM)至少分配 2 个虚拟 CPU(vCPU) 和 8GB 初始内存,否则安装可能会失败。
参考文章:告别DockerHub 镜像下载难题:掌握高效下载策略,畅享无缝开发体验
{
"builder": {
"gc": {
"defaultKeepStorage": "20GB",
"enabled": true
}
},
"experimental": false,
"features": {
"buildkit": true
},
"registry-mirrors": [
"https://dockerpull.org",
"https://docker.1panel.dev",
"https://docker.foreverlink.love",
"https://docker.fxxk.dedyn.io",
"https://docker.xn--6oq72ry9d5zx.cn",
"https://docker.zhai.cm",
"https://docker.5z5f.com",
"https://a.ussh.net",
"https://docker.cloudlayer.icu",
"https://hub.littlediary.cn",
"https://hub.crdz.gq",
"https://docker.unsee.tech",
"https://docker.kejilion.pro",
"https://registry.dockermirror.com",
"https://hub.rat.dev",
"https://dhub.kubesre.xyz",
"https://docker.nastool.de",
"https://docker.udayun.com",
"https://docker.rainbond.cc",
"https://hub.geekery.cn",
"https://docker.1panelproxy.com",
"https://atomhub.openatom.cn",
"https://docker.m.daocloud.io",
"https://docker.1ms.run",
"https://docker.linkedbus.com"
]
}
安装 Dify 之前, 请确保你的机器已满足最低安装要求:
打开mac终端,执行指令,克隆 Dify 代码仓库,克隆 Dify 源代码至本地环境。
#进入目录
cd LLM
git clone https://github.com/langgenius/dify.git
进入 Dify 源代码的 Docker 目录,复制环境配置文件
cd dify/docker
cp .env.example .env
根据你系统上的 Docker Compose 版本,选择合适的命令来启动容器。你可以通过
$ docker compose version
命令检查版本,详细说明请参考 Docker 官方文档:
如果版本是 Docker Compose V2,使用以下命令:
docker compose up -d
如果版本是 Docker Compose V1,使用以下命令:
docker-compose up -d
如果没配置docker镜像会报错,网络问题!!! 回到章节配置
+] Running 9/9
✘ nginx Error context canceled 2.3s
✘ sandbox Error context canceled 2.3s
✘ api Error context canceled 2.3s
✘ weaviate Error context canceled 2.3s
✘ worker Error context canceled 2.3s
✘ redis Error context canceled 2.3s
✘ db Error context canceled 2.3s
✘ ssrf_proxy Error context canceled 2.3s
✘ web Error Head "https://registry-1.docker.io/v2/langgenius/dify-web/manifests/0.14.0": EOF 2.3s
Error response from daemon: Head "https://registry-1.docker.io/v2/langgenius/dify-web/manifests/0.14.0": EOF
运行命令后,你应该会看到类似以下的输出,显示所有容器的状态和端口映射:
[+] Running 11/11
✔ Network docker_default Created 0.0s
✔ Network docker_ssrf_proxy_network Created 0.0s
✔ Container docker-redis-1 Started 0.9s
✔ Container docker-db-1 Started 0.9s
✔ Container docker-ssrf_proxy-1 Started 0.9s
✔ Container docker-sandbox-1 Started 0.9s
✔ Container docker-weaviate-1 Started 0.9s
✔ Container docker-web-1 Started 0.9s
✔ Container docker-worker-1 Started 0.6s
✔ Container docker-api-1 Started 0.6s
✔ Container docker-nginx-1 Started 0.8s
最后检查是否所有容器都正常运行:
docker compose ps
在这个输出中,你应该可以看到包括 3 个业务服务 api / worker / web
,以及 6 个基础组件 weaviate / db / redis / nginx / ssrf_proxy / sandbox
。
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
docker-api-1 langgenius/dify-api:0.14.0 "/bin/bash /entrypoi…" api 34 seconds ago Up 33 seconds 5001/tcp
docker-db-1 postgres:15-alpine "docker-entrypoint.s…" db 34 seconds ago Up 33 seconds (healthy) 5432/tcp
docker-nginx-1 nginx:latest "sh -c 'cp /docker-e…" nginx 34 seconds ago Up 33 seconds 0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp
docker-redis-1 redis:6-alpine "docker-entrypoint.s…" redis 34 seconds ago Up 33 seconds (healthy) 6379/tcp
docker-sandbox-1 langgenius/dify-sandbox:0.2.10 "/main" sandbox 34 seconds ago Up 33 seconds (healthy)
docker-ssrf_proxy-1 ubuntu/squid:latest "sh -c 'cp /docker-e…" ssrf_proxy 34 seconds ago Up 33 seconds 3128/tcp
docker-weaviate-1 semitechnologies/weaviate:1.19.0 "/bin/weaviate --hos…" weaviate 34 seconds ago Up 33 seconds
docker-web-1 langgenius/dify-web:0.14.0 "/bin/sh ./entrypoin…" web 34 seconds ago Up 33 seconds 3000/tcp
docker-worker-1 langgenius/dify-api:0.14.0 "/bin/bash /entrypoi…" worker 34 seconds ago Up 33 seconds 5001/tcp
通过这些步骤,你应该可以成功在本地安装 Dify。
进入 dify 源代码的 docker 目录,按顺序执行以下命令:
cd dify/docker
docker compose down
git pull origin main
docker compose pull
docker compose up -d
同步环境变量配置 (重要!)
.env.example
文件有更新,请务必同步修改你本地的 .env
文件。
.env
文件中的所有配置项,确保它们与你的实际运行环境相匹配。你可能需要将 .env.example
中的新变量添加到 .env
文件中,并更新已更改的任何值。
你可以先前往管理员初始化页面设置设置管理员账户:
# 本地环境
http://localhost/install
# 服务器环境
http://your_server_ip/install
Dify 主页面:
# 本地环境
http://localhost
# 服务器环境
http://your_server_ip
然后进行注册账号即可使用了
编辑 .env
文件中的环境变量值。然后重新启动 Dify:
docker compose down
docker compose up -d
完整的环境变量集合可以在 docker/.env.example
中找到。