快速安装（Docker Compose，推荐）

最低配置：2 核 CPU、4GB 内存（Mac 上给 Docker 至少 2 vCPU + 8GB，否则容易失败）(Dify 文档)
步骤：

1. 克隆代码（拉最新发行版分支）

git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git
cd dify/docker

2. 准备环境变量并启动

cp .env.example .env
docker compose up -d     # Docker Compose V2
# 若是 V1：docker-compose up -d

正常会启动 3 个核心服务（api / worker / web）与 6 个依赖（weaviate / db / redis / nginx / ssrf_proxy / sandbox）(Dify 文档)

3. 访问初始化与控制台

• 初始化页面：http://localhost/install（服务器上则用 http://<你的IP>/install）
• Web 控制台：http://localhost（或 http://<你的IP>） (Dify 文档)

小贴士：官方 docker-compose 位于仓库的 dify/docker 目录，需在该目录执行 compose 命令；不必把 yml 复制到项目根目录。(GitHub)

常用运维

• 查看容器状态：docker compose ps（确认端口映射如 80/443、Redis 6379、Postgres 5432 等是否正常）(Dify 文档)

• 升级（保数据）：

  cd dify/docker
  docker compose down
  git pull origin main
  docker compose pull
  docker compose up -d
  

  升级前可打包 volumes 目录做离线备份：tar -cvf volumes-$(date +%s).tgz volumes。升级后记得同步 .env.example 的新变量到你的 .env。(GitHub)

模型接入（本地/离线优先：Ollama）

在同一台机或内网主机装好 Ollama，拉你要用的模型（如 DeepSeek R1 7B）：

ollama run deepseek-r1:7b

在 Dify 的「Profile → Settings → Model Providers」里选择 Ollama，Base URL 填 http://<你的宿主机IP>:11434（注意不是 127.0.0.1）。若 Mac/Linux 里容器访问宿主服务有问题，可用 http://host.docker.internal:11434，并将 OLLAMA 服务改为 0.0.0.0 监听（OLLAMA_HOST=0.0.0.0）(Dify 文档)。

官方用例文档对「Ollama + DeepSeek + Dify 私有部署」的端到端步骤、FAQ（端口/地址）写得很清楚，可对照完成模型接入。(Dify 文档)

离线/内网部署要点

• 预下载镜像：在可联网环境 docker compose pull 拉齐后保存镜像，内网再导入运行。
• 插件（如 Ollama 插件）离线安装：支持把插件打包为 .difypkg，在 Dify 插件页通过“从本地文件安装”导入（社区 issue 提供了具体说明与讨论）。(GitHub)
• 向导与 FAQ：如果你把模型跑在宿主机，容器内访问 127.0.0.1 会失败（那是容器自己的回环地址），请改填宿主机局域网 IP 或 host.docker.internal。(Dify 文档)

可选部署方式（K8s / 一键化）

• Kubernetes/Helm：社区已有 Helm Chart，可一键在 K8s 上起 Dify（ArtifactHub/社区仓库）。(Artifact Hub)
• 第三方一键脚本/编排：例如 Pigsty 集成了 Dify，可复用其 PostgreSQL/pgvector 与备份方案（注意版本适配）。(Pigsty)

常见问题速查

• 80 端口被占用：修改 docker/nginx 对外暴露端口或停用占用服务后重启。
• 上传文件大小限制：通过环境变量提高数据集文档的大小/数量限制（见官方 FAQ 的环境变量说明）。(Dify 文档)
• 前后端地址不一致：启动后访问异常，多数是 .env 里外部可访问地址没配对（参考 docker/.env.example 注释，改完 docker compose down && up -d）。(Dify 文档)