本文档由 AI 自动翻译。如有任何不准确之处,请参考 英文原版。
部署前准备
确保机器满足以下最低系统要求。硬件
- CPU >= 2 Core
- RAM >= 4 GiB
软件
部署并启动
1
克隆 Dify
克隆 Dify 源代码到本地机器。
此命令需要
git、curl 和 jq。如提示 command not found,安装缺少的工具后重新运行命令。2
启动 Dify
-
进入 Dify 源代码中的
docker目录: -
复制必要的环境配置文件:
如需自定义部署,参见 自定义。
-
启动容器:
Dify 需要 Docker Compose 2.24.0 或更高版本。运行
docker compose version确认版本。启动以下容器:- 6 个核心服务:
api、api_websocket、worker、worker_beat、web、plugin_daemon - 6 个依赖组件:
weaviate、db_postgres、redis、nginx、ssrf_proxy、sandbox - 1 个一次性任务:
init_permissions,用于设置存储文件权限,完成后自动退出(状态显示为Exited是正常的)
- 6 个核心服务:
-
验证所有容器是否成功运行:
每个容器的状态应为
Up或healthy。
访问
-
打开管理员初始化页面,设置管理员账户:
-
完成管理员账户设置后,在以下地址登录 Dify:
自定义
如需自定义部署,编辑相关文件中的环境变量,然后重启 Dify。1
编辑环境变量
-
必要的启动值 位于
docker/.env文件中(部署时从docker/.env.example复制创建)。直接编辑即可。 -
可选或特定提供商的设置 在
docker/envs/下有对应模板。要覆盖默认值,复制相应模板(去掉.example后缀),然后编辑副本。 例如:
docker/.env 中的值优先于任何 docker/envs/*.env 文件中的值。2
重启 Dify
升级
不同版本的升级步骤可能有所不同。详见 Releases 页面中提供的目标版本升级指南。升级后,对照各
.env.example 文件检查对应的 .env,确认是否有新增或变更的变量。