#4. 应用安装

Dify 提供两种使用方式，覆盖不同场景需求。

#网页版（云服务）

直接访问 https://cloud.dify.ai 即可使用。

优势：免安装、零配置、即开即用

推荐浏览器：Chrome、Edge、Safari、Firefox

#自托管部署（Docker Compose）

通过 Docker Compose 在本地或服务器上部署 Dify。

部署文档：https://docs.dify.ai/zh/self-host/quick-start/docker-compose

系统要求：

说明：以上 CPU / 内存 / Docker 版本为官方 Docker Compose 文档给出的最低要求；磁盘空间为部署经验参考值，非官方规定。

部署步骤

第一步：克隆仓库

执行以下命令，自动拉取最新稳定版本：

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

第二步：进入 docker 目录

cd dify/docker

第三步：复制环境配置文件

cp .env.example .env

.env 文件包含所有可配置的环境变量，按需修改后再启动服务。

第四步：启动容器

根据本机 Docker Compose 版本选择对应命令（可通过 docker compose version 查看版本）：

# Docker Compose V2（推荐）
docker compose up -d

# Docker Compose V1
docker-compose up -d

注意：如果提示 docker: 'compose' is not a docker command，说明你的 Docker Compose 版本过旧，建议升级 Docker Desktop 或 Docker Compose。

启动成功后，将运行以下容器：

• 5 个核心服务：api、worker、worker_beat、web、plugin_daemon
• 6 个依赖组件：weaviate、db_postgres、redis、nginx、ssrf_proxy、sandbox

注意：具体容器名称和数量可能随版本变化，可通过docker compose ps命令查看。

第五步：验证容器状态

docker compose ps

所有容器的状态应显示为 Up 或 healthy。若出现异常状态，可通过以下命令查看具体日志：

docker compose logs [服务名]

初始化与访问

容器全部正常运行后，访问以下地址完成管理员账户的初始化设置：

# 本地环境
http://localhost/install

# 服务器环境
http://your_server_ip/install

初始化完成后，通过以下地址登录 Dify 控制台：

# 本地环境
http://localhost

# 服务器环境
http://your_server_ip

自定义配置

重要（v1.14.x 变更）：自 v1.14.1 起，Docker Compose 的环境变量做了拆分：

• 核心启动值仍在 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 中的同名值。 从旧版本升级到 1.14.x 时，请对照新的 docker/envs/** 布局重新套用你原先的自定义项。

修改 .env 后，可在 dify/docker 目录下执行：

docker compose up -d

如果配置没有生效，再执行：

docker compose restart

如需完全重新创建容器，可执行：

docker compose down
docker compose up -d

注意：执行自部署升级或重建容器前，建议先备份 docker/volumes 目录，避免误操作导致数据丢失。

#桌面端

暂无。Dify 目前未提供官方桌面客户端。

#移动端

暂无。Dify 目前未提供 iOS、Android版本的移动应用。

#多端同步

Dify 云服务登录同一账号后，可在不同设备的浏览器中访问相同的工作空间，以下内容自动同步：

• 所有应用配置和工作流
• 知识库与数据集
• 模型供应商设置
• 团队成员与权限