【每天一个小笔记】01 Dify 本地部署

第一步安装Dorker Desktop

        Docker是一个开源的应用容器引擎，简单来说，它能把应用程序及其依赖（比如代码、库、配置文件等）“打包” 成一个标准化的 “容器”，确保这个应用在任何支持 Docker 的环境中（比如你的电脑、服务器、云平台等）都能一致地运行，解决了 “在我这能跑，在你那跑不起来” 的经典问题。

        在Dify本地安装需要先安装Docker，到Docker Desktop官网下载

        下载后本地安装Docker，运行安装Docker时，一路点击下一步即可，该过程中Docker会自动拉取所需的内容。完成后会重启电脑，打开cmd，输入docker -v，如果下方出现Docker的版本提示就代表安装成功了

        在桌面中已经出现了Docker的图标，双击打开Docker，会出现下面这张图片，点击Accept接受：

        之后会出现登录界面，我们直接不登陆，跳过，

        之后界面会出现这样的报错：

        报错主要是提示WSL版本过低、WSL更新失败或者没有WSL，此时需根据提示针对性解决。我们根据Docker给出的提示进行wsl --update

        安装完成后点击Docker界面的restart重启一下Docker，就能够看到Docker能够正常使用的界面了：

        之后我们配置Docker国内的镜像源，因为没有配置国内镜像的原因导致在拉取所需内容的时候一直超时或者拉取到一半出现报错，为了解决这个问题需要配置一下Docker镜像。

 

        将下面的内容添加到配置中去：

#将下面的内容添加到配置中去：
{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "registry-mirrors": [
    "https://do.nark.eu.org",
    "https://dc.j8.work",
    "https://docker.m.daocloud.io",
    "https://dockerproxy.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://docker.nju.eu.cn"
  ]
}

        添加完成后，点击Apply&restarat：

第二步、安装部署Dify

       下载Dify源码，我这里是通过Gitee上面直接下载对应版本

        把dify安装包复制粘贴到你想要安装的位置。之后点击进入安装包的文件夹中的docker文件夹，将其中的.env.example文件复制一份，重命名为.env。

        在.env中存在许多的配置信息，如果想要修改dify的前端界面端口，需要进入到.env 中将EXPOSE_NGINX_PORT的端口改成想要的端口即可

        然后在当前的文件夹内打开cmd，或者通过之前的方式打开cmd后通过指令进入到当前文件夹（复制路径后，在cmd中输入cd 复制的路径即可）

        在cmd中输入指令docker compose -p dify up -d进行Dify的安装部署，如果安装报错了，建议多试几次，又可能是因为网络超时问题：

        安装完成后，在浏览器输入http://localhost/install访问并配置Dify，主要是注册和登录Dify，一定要记住自己的邮箱和密码，后续登录用。

        配置完成后点击设置即可进入到Dify的工作界面：

        后续登录只要在网址中输入http://localhost:80（或者我们更改后的端口）即可进入到我们自己部署到本地的Dify中了。

        电脑关机后重启也只需要重新启动Docker就可以继续使用Dify。

结尾补充说明

解析指令 docker compose -p dify up -d

该命令用于通过 Docker Compose 启动名为 dify 的服务堆栈，并在后台运行。以下是各参数的详细说明：

• docker compose

Docker Compose 是用于定义和运行多容器 Docker 应用程序的工具。通过编写 docker-compose.yml 文件，可以配置多个服务及其依赖关系，然后使用 docker compose 命令统一管理。

• -p dify

-p 参数用于指定项目的名称（dify）。Docker Compose 会为所有容器、网络和卷添加此名称前缀，便于隔离和管理。如果不指定，默认使用当前目录的名称作为项目名。

• up

up 命令用于根据 docker-compose.yml 文件创建并启动所有定义的服务。如果容器不存在，会先构建或拉取镜像；如果存在，则直接启动。

• -d

-d 表示以“分离模式”（后台运行）启动服务。不加此参数时，日志会直接输出到终端，而加上 -d 后，容器在后台运行，终端可继续输入其他命令。

执行效果

1. 服务启动：根据 docker-compose.yml 中的配置启动所有服务容器。

2. 资源命名：所有资源（容器、网络、卷）的名称会以 dify_ 为前缀。

3. 后台运行：容器启动后，终端不会阻塞，可通过 docker compose logs 查看日志。

常见后续操作

• 查看服务状态：docker compose -p dify ps

• 查看日志：docker compose -p dify logs -f

• 停止服务：docker compose -p dify down

常见的docker指令：

docker compose up -d 启动容器

docker compose down 关闭容器

docker compose -p dify up -d 启动容器，并给容器命名为dify

docker compose -p dify down关闭名为dify的容器

docker ps 查看docker容器

docker log “容器名称” 查看日志