0 前言
Dify 社区版即开源版本,可通过以下两种方式之一部署 Dify 社区版:
-
Docker Compose 部署
-
本地源码启动
在 GitHub 上查看 Dify 社区版。
1 克隆 Dify 代码仓库
克隆 Dify 源代码至本地环境。
bash
git clone https://github.com/langgenius/dify.git
2 启动 Dify
-
进入 Dify 源代码的 Docker 目录
cd dify/docker -
复制环境配置文件
cp .env.example .env -
启动 Docker 容器
bash
# Docker Compose V1
docker-compose up -d
# Docker Compose V2
docker compose up -d
运行后看到以下输出,显示所有容器的状态和端口映射:
bash
[+] Running 11/11
✔ Network docker_ssrf_proxy_network Created 0.1s
✔ Network docker_default Created 0.0s
✔ Container docker-redis-1 Started 2.4s
✔ Container docker-ssrf_proxy-1 Started 2.8s
✔ Container docker-sandbox-1 Started 2.7s
✔ Container docker-web-1 Started 2.7s
✔ Container docker-weaviate-1 Started 2.4s
✔ Container docker-db-1 Started 2.7s
✔ Container docker-api-1 Started 6.5s
✔ Container docker-worker-1 Started 6.4s
✔ Container docker-nginx-1 Started 7.1s
最后检查是否所有容器都正常运行:
bash
docker compose ps
在这个输出中,你应该可以看到包括 3 个业务服务 api / worker / web,以及 6 个基础组件 weaviate / db / redis / nginx / ssrf_proxy / sandbox :

至此,成功在本地安装 Dify。
3 更新 Dify
进入 dify 源代码的 docker 目录,按顺序执行以下命令:
bash
cd dify/docker
docker compose down
git pull origin main
docker compose pull
docker compose up -d
同步环境变量配置 (重要!)
- 如果
.env.example文件有更新,请务必同步修改你本地的.env文件。 - 检查
.env文件中的所有配置项,确保它们与你的实际运行环境相匹配。你可能需要将.env.example中的新变量添加到.env文件中,并更新已更改的任何值。
4 访问 Dify
你可以先前往管理员初始化页面设置设置管理员账户:
bash
# 本地环境
http://localhost/install
# 服务器环境
http://your_server_ip/install

设置好后进入登录页:

进入和线上一样的Dify主页面:

5 自定义配置
编辑 .env 文件中的环境变量值。然后重新启动 Dify:
bash
docker compose down
docker compose up -d
完整的环境变量集合可在 docker/.env.example 中找到。