#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

系统要求：

新手提示：如果只是学习 Dify，优先使用 Dify Cloud，免安装、免维护。只有在需要本地部署、私有化数据、企业内网使用或深度定制时，才建议尝试 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

自定义配置

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

docker compose up -d

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

docker compose restart

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

docker compose down
docker compose up -d

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

#桌面端

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

#移动端

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

#多端同步

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

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