垦荒学园
  • 中文

      • 安装与部署

      Dify 可以立刻用 Cloud，也可以用 Community Edition 自托管。官方最低硬件：CPU ≥ 2 核、内存 ≥ 4 GiB。Mac 上 Docker 虚拟机建议至少 2 vCPU / 8 GiB。Docker Compose 需要 2.24.0+（docker compose version 确认）。

      方式 A：Dify Cloud（最快）

      打开 https://cloud.dify.ai 注册。托管平台自带 免费 Sandbox，无需装 Docker，适合先走完 快速上手。数据在云端；内网或合规场景改走方式 B。

      方式 B：Docker Compose 自托管

      官方推荐：克隆最新 Release 标签，不要盲目跟 main。需要 git、curl、jq（Windows 也可用 PowerShell 取 tag）。

      Linux / macOS：

      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
cp .env.example .env
docker compose up -d

      Windows（PowerShell 7）： 先装 Docker Desktop 并启用 WSL 2。源码与绑定到 Linux 容器的数据请放在 Linux 文件系统（例如 \\wsl$\... 下的目录），不要放在 /mnt/c/...，否则卷性能差、还容易出权限问题。

      $tag = (Invoke-RestMethod https://api.github.com/repos/langgenius/dify/releases/latest).tag_name
git clone --branch $tag https://github.com/langgenius/dify.git
Set-Location dify/docker
Copy-Item .env.example .env
docker compose up -d

      拉镜像首次较慢。完成后：

      docker compose ps

      容器应为 Up / healthy。一次性任务 init_permissions 以 Exited 结束是正常的。

      会拉起哪些服务

      官方 Compose 会启动（名称以当前 Release 为准，升级后可能增减）：

      角色典型服务名
      核心api、api_websocket、worker、worker_beat、web、plugin_daemon、agent_backend
      依赖weaviate（向量）、db_postgres、redis、nginx、sandbox / local_sandbox、SSRF 代理等
      一次性init_permissions（修好存储权限后退出）

      浏览器只跟 nginx 说话：控制台一般是 http://localhost。定制项写在 docker/.env（从 .env.example 复制）；更细的模板在 docker/envs/。改完后：

      docker compose down
docker compose up -d

      第一个管理员

      1. 打开 **http://localhost/install**（远程机器则换成 http://<服务器IP>/install）
      2. 创建管理员邮箱与密码（这是工作空间的第一个 Owner）
      3. 完成后登录 http://localhost

      只有工作空间 Owner / Admin 能添加模型供应商密钥。密钥对整个工作空间生效，并走各厂商账单（Cloud 还可能消耗平台额度）。

      升级与备份（自托管必读）

      数据在 dify/docker/volumes/（Postgres、上传文件、Redis、向量库等）。升级前备份该目录和 .env。官方要求对照新版本的 .env.example 补变量；若改过 docker-compose.yaml，应把改动重新打到新文件上，不要一直用旧 Compose——新版本可能新增必需服务。具体步骤以 Releases 说明为准。

      可选：difyctl

      官方提供 CLI difyctl：在终端、脚本、CI 里列出并运行工作空间中的应用（difyctl auth login --host …，difyctl get app，difyctl run app <id> "…"）。Cloud 用 https://cloud.dify.ai。自托管需在环境变量里打开 OPENAPI_ENABLED=true 与 ENABLE_OAUTH_BEARER=true，否则登录走不通。应用发布仍以 Web / Service API 为主，CLI 是补充，详见 docs.dify.ai/en/cli。

      常见问题

      compose 不是命令？ 需要 Compose V2 插件，写成 docker compose（中间有空格），版本 ≥ 2.24.0。

      Windows 极慢或权限错？ 确认项目在 WSL 的 Linux 盘，而不是 C:\。

      端口 80 被占？ 改 nginx 映射或停掉占用 80 的服务后再 up。

      只想试用？ 先用 Cloud，本地模型再上自托管 + Ollama。

      下一步

      评论