前提条件

参考官方文档：https://docs.dify.ai/zh-hans/getting-started/install-self-hosted/docker-compose#%E5%89%8D%E6%8F%90%E6%9D%A1%E4%BB%B6

安装 Dify 之前, 请确保你的机器已满足最低安装要求：

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

我的系统环境是macos，安装Docker桌面端即可：《在 Mac 内安装 Docker 桌面端》

克隆 Dify 代码仓库

克隆 Dify 源代码至本地环境。

1
2
# 假设当前最新版本为 1.7.1
git clone https://github.com/langgenius/dify.git --branch 1.7.1

很多人可能访问github有问题，所以也可以用gitee：

1
git clone https://gitee.com/dify_ai/dify.git --branch 1.7.1

启动Dify

step1: 进入 Dify 源代码的 Docker 目录

1
cd dify/docker

step2: 复制环境配置文件

1
cp .env.example .env

step3: 启动 Docker 容器 根据你系统上的 Docker Compose 版本，选择合适的命令来启动容器。你可以通过 $ docker compose version 命令检查版本，详细说明请参考 Docker 官方文档：

  • 如果版本是 Docker Compose V2，使用以下命令：
    1
    docker compose up -d
  • 如果版本是 Docker Compose V1，使用以下命令：
    1
    docker-compose up -d

运行命令后，你应该会看到类似以下的输出，显示所有容器的状态和端口映射：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
[+] Running 13/13
 ✔ Network docker_ssrf_proxy_network  Created                                          0.1s 
 ✔ Network docker_default             Created                                          0.1s 
 ✔ Container docker-redis-1           Started                                          4.2s 
 ✔ Container docker-weaviate-1        Started                                          4.3s 
 ✔ Container docker-sandbox-1         Started                                          4.2s 
 ✔ Container docker-web-1             Started                                          4.3s 
 ✔ Container docker-ssrf_proxy-1      Started                                          4.9s 
 ✔ Container docker-db-1              Healthy                                         51.3s 
 ✔ Container docker-plugin_daemon-1   Started                                         52.5s 
 ✔ Container docker-worker_beat-1     Started                                         51.8s 
 ✔ Container docker-worker-1          Started                                         52.2s 
 ✔ Container docker-api-1             Started                                         52.0s 
 ✔ Container docker-nginx-1           Started                                         54.2s

最后检查是否所有容器都正常运行：

1
docker compose ps

在这个输出中，你应该可以看到包括 3 个业务服务 api / worker / web，以及 6 个基础组件 weaviate / db / redis / nginx / ssrf_proxy / sandbox 。

1
2
3
4
5
6
7
8
9
10
11
12
NAME                     IMAGE                                       COMMAND                   SERVICE         CREATED              STATUS                        PORTS
docker-api-1             langgenius/dify-api:1.7.1                   "/bin/bash /entrypoi…"   api             About a minute ago   Up 32 seconds                 5001/tcp
docker-db-1              postgres:15-alpine                          "docker-entrypoint.s…"   db              About a minute ago   Up About a minute (healthy)   5432/tcp
docker-nginx-1           nginx:latest                                "sh -c 'cp /docker-e…"   nginx           About a minute ago   Up 29 seconds                 0.0.0.0:80->80/tcp, [::]:80->80/tcp, 0.0.0.0:443->443/tcp, [::]:443->443/tcp
docker-plugin_daemon-1   langgenius/dify-plugin-daemon:0.2.0-local   "/bin/bash -c /app/e…"   plugin_daemon   About a minute ago   Up 31 seconds                 0.0.0.0:5003->5003/tcp, [::]:5003->5003/tcp
docker-redis-1           redis:6-alpine                              "docker-entrypoint.s…"   redis           About a minute ago   Up About a minute (healthy)   6379/tcp
docker-sandbox-1         langgenius/dify-sandbox:0.2.12              "/main"                   sandbox         About a minute ago   Up About a minute (healthy)   
docker-ssrf_proxy-1      ubuntu/squid:latest                         "sh -c 'cp /docker-e…"   ssrf_proxy      About a minute ago   Up About a minute             3128/tcp
docker-weaviate-1        semitechnologies/weaviate:1.19.0            "/bin/weaviate --hos…"   weaviate        About a minute ago   Up About a minute             
docker-web-1             langgenius/dify-web:1.7.1                   "/bin/sh ./entrypoin…"   web             About a minute ago   Up About a minute             3000/tcp
docker-worker-1          langgenius/dify-api:1.7.1                   "/bin/bash /entrypoi…"   worker          About a minute ago   Up 32 seconds                 5001/tcp
docker-worker_beat-1     langgenius/dify-api:1.7.1                   "/bin/bash /entrypoi…"   worker_beat     About a minute ago   Up 32 seconds                 5001/tcp

通过这些步骤，你可以在本地成功安装 Dify。

更新 Dify

进入 dify 源代码的 docker 目录，按顺序执行以下命令：

1
2
3
4
5
cd dify/docker
docker compose down
git pull origin main
docker compose pull
docker compose up -d

同步环境变量配置 (重要！)

  • 如果 .env.example 文件有更新，请务必同步修改你本地的 .env 文件。
  • 检查 .env 文件中的所有配置项，确保它们与你的实际运行环境相匹配。你可能需要将 .env.example 中的新变量添加到 .env 文件中，并更新已更改的任何值。

访问 Dify

你可以先前往管理员初始化页面设置设置管理员账户：

1
2
3
4
5
# 本地环境
http://localhost/install

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

img.png

img_1.png

Dify 主页面：

1
2
3
4
5
# 本地环境
http://localhost

# 服务器环境
http://your_server_ip

img_2.png

自定义配置

编辑 .env 文件中的环境变量值。然后重新启动 Dify：

1
2
docker compose down
docker compose up -d

完整的环境变量集合可以在 docker/.env.example 中找到。