在Windows本地部署Dify详细操作

Dify官网文档:产品简介 - Dify Docs

1.硬件要求

2.部署方式选择

本次我选择Docker Compose 部署,接下来我将根据官方文档指引,在windows电脑上完成dify本地部署

3.DockerCompose本地部署Dify

3.1 安装WSL2

官方安装WSL2的操作说明入口:

查看自己系统版本快捷键:Win+I—>系统—>系统信息

 

根据自己电脑版本,选择wsl2安装方式:

3.2 安装docker desktop

根据dify官网文档给的windows docker desktop安装方式,下载docker desktop

 下载后,直接双击.exe文件安装

3.3 docker desktop配置

配置docker镜像下载地址:

启动docker-desktop,不需要登录,点击左上角【设置】

在【Docker Engine】里,配置docker镜像为国内下载地址,然后右下角点击【Apply&restart】

{
    "registry-mirrors": [
        "https://mirror.aliyuncs.com",
        "https://mirror.baidubce.com",
        "https://docker.m.daocloud.io"
    ]
}

3.4 安装dify

1.查看dify版本https://github.com/langgenius/dify

2.克隆 dify 源代码至本地

git clone https://github.com/langgenius/dify.git --branch 1.3.1 D:\dify-1.3.1

3.配置dify源码

将克隆下来的源码docker⽬录,重命名为: docker-dify-1.3.1

修改后

在docker-dify-1.3.1⽬录下,将 .env.example ⽂件复制⼀份,重命名为 .env

复制重命名后

4.启动dify容器

启动docker desktop

检查启动状态:

启动dify容器方法一:在线下载镜像并启动dify

在cmd下进入 docker-dify-1.3.1 目录,执⾏命令:

docker compose up -d

docker会⾃动下载dify所需的镜像,并启动dify,如下图:

下载过程

下载完后自动启动

启动完成后,进入docker desktop页面,会看到dify容器

以后只需要启动docker desktop即可启动dify

如果因为网络原因下载失败,可以使⽤离线的dify镜像包启动dify

启动dify容器方法二:使用离线的dify镜像包

dify-1.3.1-离线镜像包下载链接:

链接:https://pan.baidu.com/s/1oaOQ7p7Ojp466hvwSeM7og 
提取码:H7s3

dify-1.3.1-离线镜像包.zip 解压,放在任意⼀个英文目录下。在cmd下,进⼊到镜像包解压后的目录,依次执⾏命令:

docker load -i dify-api.tar

docker load -i dify-sendbox.tar

docker load -i dify-web.tar

docker load -i nginx.tar

docker load -i postgres.tar

docker load -i redis.tar

docker load -i squid.tar

docker load -i weaviate.tar

执⾏下面的命令,检查镜像是否都已经成功导⼊。

docker images


在cmd下进⼊到docker-dify-1.3.1 目录下,执⾏以下命令启动dify镜像

docker compose up -d

查看docker下面的镜像:

docker images

4.访问dify

  •  如果dify安装在本地:登录地址:http://localhost/apps
  • 如果dify安装在其他计算机或者本地虚拟机里:登录地址为:http://计算机ip/apps,比如我公司里由于禁用docker desktop,dify是通过wsl2里的docker engine部署的,那登录地址为:http://172.23.67.XX/apps (172.23.67.XX是wsl2的地址)

第一次访 问需要注册

5.添加大模型到Dify平台

5.1 添加ollama管理的本地大模型

启动ollama:菜单栏双击羊驼的图标

查看ollama的本地大模型:ollama list

dify右上角个人头像——>设置——>模型供应商

在列表中找到对应的大模型——>安装

插件安装完成后,回到模型供应商页面,会在待配置列表里多出来一条记录:

在待配置列表点击【添加模型】

模型名称Ollama本地管理的模型名称,通过ollama list指令查看

基础URL是指dify访问ollama的地址

  • 如果ollama和dify安装在同一台计算机上:默认:http://host.docker.internal:11434
  • 如果ollama和dify是安装在不同的计算机,或者dify是安装在虚拟机里,这个地址是指:ollama所在计算机的地址。至于端口,ollama的端口默认是11434,但是要看自己的计算机11434端口是否被占用。

      比如我公司里计算机11434端口被占用,安装ollama时系统环境变量里配置了端口:
      变量名:OLLAMA_HOST 

      变量值(端⼝)::8000(8000前⾯有个冒号)

     由于公司禁用docker desktop ,dify是安装在pc的里,pc的地址为:添加大模型时我的这个地址为:​​​​​​http://10.219.24.xx:8000 (10.219.24.xx是我的pc计算机ip)

添加完成后,会在模型列表中看到ollama:

5.2 添加远端大模型

5.2.1 添加硅基流动

在模型供应商里找到硅基流动

安装插件:

​ 在待配置列表里右下角点击【添加模型】

 

模型名称获取方式:打开硅基流动平台——>模型广场,点击模型,复制名称

API Key获取方式:打开硅基流动平台——>API秘钥,复制Key

API Key申请方式:请查阅我的另外一篇文章申请deepseek Api Key的三种方式

 右下角保存后,回到模型供应商可以看到硅基流动

5.2.2 添加火山引擎

大模型供应商列表里找到火山引擎

安装插件:
 在待配置列表右下角点击【添加模型】

 

模型名称:火山引擎平台——>模型广场,复制模型名称

鉴权方式:下拉选择Api Key

API Key:火山引擎平台——>API Key管理,复制Key

火山引擎地域:不用管

API Endpoint Host:不用管

Endpoint ID:火山引擎平台——>在线推理,复制接入点ID

API Key和Endpoint ID申请方法请查阅我的另外一篇文章申请deepseek Api Key的三种方式

 基础模型:下拉找到你想要的模型

 最后右下角点击【保存】后,在回到模型供应商可以看到火山引擎了

### Dify 本地部署教程 (Windows) #### 启用硬件和软件支持 为了确保 Docker 和其他依赖项正常运行,在 Windows部署 Dify 需要先配置一些系统设置。确认任务管理器中的 CPU 虚拟化选项已被激活[^2]。接着,通过控制面板进入程序和功能部分,开启 Hyper-V 或者 WSL(适用于 Linux 的 Windows 子系统)。 #### 安装 Docker Desktop 安装最新版的 Docker Desktop 并启动服务。由于 Dify 是基于容器化的应用,因此拥有一个稳定工作的 Docker 环境至关重要。完成安装后,请验证 Docker 是否能够成功拉取镜像并运行简单的测试容器。 #### 数据库准备 对于持久化存储需求,需预先搭建 PostgreSQL 数据库环境。按照指定指南操作来创建超级用户、设定 root 密码以及建立名为 `dify` 的数据库实例[^3]: ```bash psql -U postgres CREATE USER dify WITH PASSWORD 'difyai123456'; ALTER ROLE dify SUPERUSER; CREATE DATABASE dify OWNER dify; ``` 同时定义必要的连接参数如下所示: - **DB_USERNAME**: `postgres` - **DB_PASSWORD**: 自定义密码 (`difyai123456`) - **DB_HOST**: `localhost` - **DB_PORT**: 默认端口为 `5432` - **DB_DATABASE**: `dify` #### 缓存层集成 除了关系型数据库外,还需要 Redis 来提供缓存机制和支持消息队列等功能。遵循官方文档指示完成 Redis 的安装过程。 #### 获取与启动 Dify 应用 最后一步是从 GitHub 或其他源获取项目文件,并依据 README.md 中给出的具体指令执行构建流程。通常情况下会涉及到编辑 `.env` 文件以适应个人开发环境变量设置,之后利用 docker-compose 命令一键启动整个应用程序栈。 ```yaml version: "3" services: app: image: ghcr.io/dify-community/dify:latest ports: - "8000:8000" environment: POSTGRES_USER: ${DB_USERNAME} POSTGRES_PASSWORD: ${DB_PASSWORD} POSTGRES_DB: ${DB_DATABASE} REDIS_URL: redis://redis:6379/0 depends_on: - db - redis ... ``` 以上即是在 Windows 操作系统上实现 Dify 社区版本地部署的主要步骤概述。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值