跳转到主要内容
本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。
常见部署问题，详见 常见问题解答。

​
部署前准备

确保机器满足以下最低系统要求。

​
硬件

  • CPU >= 2 Core
  • RAM >= 4 GiB

​
软件

操作系统所需软件说明
macOS 10.14 或更高版本Docker Desktop（含 Docker Compose 2.24.0+）Docker 虚拟机至少配置 2 个虚拟 CPU 和 8 GiB 内存。

安装说明详见 Mac 版 Docker Desktop 安装指南。
Linux 发行版Docker 19.03+

Docker Compose 2.24.0+		安装说明详见 Docker 引擎安装指南 和 Docker Compose 安装指南。
Windows（启用 WSL 2）Docker Desktop（含 Docker Compose 2.24.0+）源代码和绑定到 Linux 容器的数据建议存储在 Linux 文件系统中，而非 Windows。

安装说明详见 Windows 版 Docker Desktop 安装指南。

​
部署并启动

1

克隆 Dify

克隆 Dify 源代码到本地机器。
git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git
此命令需要 git、curl 和 jq。如提示 command not found，安装缺少的工具后重新运行命令。
2

启动 Dify

  1. 进入 Dify 源代码中的 docker 目录： 
    cd dify/docker
  2. 复制必要的环境配置文件： 
    cp .env.example .env
    如需自定义部署，参见 自定义。
  3. 启动容器：
    Dify 需要 Docker Compose 2.24.0 或更高版本。运行 docker compose version 确认版本。
    docker compose up -d
    启动以下容器：
    • 6 个核心服务：api、api_websocket、worker、worker_beat、web、plugin_daemon
    • 6 个依赖组件：weaviate、db_postgres、redis、nginx、ssrf_proxy、sandbox
    • 1 个一次性任务：init_permissions，用于设置存储文件权限，完成后自动退出（状态显示为 Exited 是正常的）
  4. 验证所有容器是否成功运行： 
    docker compose ps
    每个容器的状态应为 Up 或 healthy。

​
访问

  1. 打开管理员初始化页面，设置管理员账户： 
    # 本地环境
http://localhost/install

# 服务器环境
http://your_server_ip/install
  2. 完成管理员账户设置后，在以下地址登录 Dify： 
    # 本地环境
http://localhost  

# 服务器环境
http://your_server_ip

​
自定义

如需自定义部署，编辑相关文件中的环境变量，然后重启 Dify。
1

编辑环境变量

  • 必要的启动值 位于 docker/.env 文件中（部署时从 docker/.env.example 复制创建）。直接编辑即可。
  • 可选或特定提供商的设置 在 docker/envs/ 下有对应模板。要覆盖默认值，复制相应模板（去掉 .example 后缀），然后编辑副本。 例如： 
    cd dify/docker
cp envs/vectorstores/milvus.env.example envs/vectorstores/milvus.env
docker/.env 中的值优先于任何 docker/envs/*.env 文件中的值。
所有变量的说明，详见 环境变量。
2

重启 Dify

docker compose down
docker compose up -d

​
升级

不同版本的升级步骤可能有所不同。详见 Releases 页面中提供的目标版本升级指南。
升级后，对照各 .env.example 文件检查对应的 .env，确认是否有新增或变更的变量。
最后修改于 2026年7月9日