
目录一、安装 Git二、下载dify方法一使用 SSH 方式克隆最推荐三、验证第一步创建并写入配置第二步确认文件内容第三步再次验证连接第四步可以直接git文件四、docker的下载五、Windows下docker的安装六、打开电脑虚拟化七、部署Dify八、打开使用dify2、模型选择ollama run qwen3-vl:4b一、安装 Git1.安装 GitGit 是开源的项目版本管理工具用于从 Github 拉取 Dify 源码非必要Dify 也提供了 zip 下载。安装就是一路 next 就搞定啦~官方地址https://git-scm.com/downloads/win网盘地址https://pan.baidu.com/s/1yw2Ql-VHwI9q96wJyVhA6Q?pwdm3i52、安装ollama官方地址Ollama二、下载dify1、下载dify出现问题git clone https://github.com/langgenius/dify.gitCloning into dify...fatal: unable to access https://github.com/langgenius/dify.git/: Failed to connect to github.com port 443 after 21110 ms: Could not connect to server解决方法方法一使用 SSH 方式克隆最推荐这是最稳定、一劳永逸的方法。它使用 SSH 协议端口 22而不是 HTTPS 协议端口 443可以绕过大部分网络限制。检查是否已有 SSH 密钥在 Git Bash 中运行以下命令查看是否已有密钥文件ls -al ~/.ssh如果看到id_rsa和id_rsa.pub或id_ed25519和id_ed25519.pub文件说明已有密钥可跳到第 3 步。生成新的 SSH 密钥如果没有密钥运行以下命令生成一个新的将your_emailexample.com替换为你的 GitHub 注册邮箱ssh-keygen -t ed25519 -C your_emailexample.com按三次回车使用默认设置即可。将公钥添加到 GitHub复制你的公钥内容cat ~/.ssh/id_ed25519.pub如果你用的是rsa算法命令则是cat ~/.ssh/id_rsa.pub登录 GitHub点击右上角头像 -Settings-SSH and GPG keys-New SSH key。Key密钥内容这是最关键的一步回到你的 Git Bash 窗口就是之前生成密钥的那个黑色窗口。输入命令cat ~/.ssh/id_ed25519.pub并回车。你会看到一长串以ssh-ed25519开头的内容。选中并复制这一整行。回到网页把这串内容粘贴到Key的大框里。三、验证验证安装输入ssh -T gitgithub.com运行报错ssh -T gitgithub.com ssh: connect to host github.com port 22: Connection refused你所在的网络环境比如公司、学校或家庭宽带屏蔽了 SSH 协议默认使用的22 端口。这在国内网络中非常常见。这就破案了报错信息No such file or directory说明配置文件根本没创建成功。刚才用notepad命令时可能因为窗口没弹出来或者被误关了导致文件并没有保存下来。别担心我们用 Git Bash 自带的命令行工具直接创建这样最稳妥。请依次复制执行以下 3 行命令第一步创建并写入配置直接复制下面这整段代码包含引号粘贴到 Git Bash 中并回车echo Host github.com ~/.ssh/config echo Hostname ssh.github.com ~/.ssh/config echo Port 443 ~/.ssh/config(注意第二行和第三行开头有两个空格这是 SSH 配置文件的标准格式不要删掉)第二步确认文件内容输入以下命令查看文件是否创建成功cat ~/.ssh/config如果屏幕上打印出了下面这三行内容就说明文件创建成功了Host github.com Hostname ssh.github.com Port 443第三步再次验证连接现在再次尝试连接ssh -T gitgithub.com这次应该就能通了如果看到Hi xxx!的提示就ok了。第四步可以直接git文件git clone gitgithub.com:langgenius/dify.git直接git太慢可以直接打开网站GitHub - langgenius/dify: Production-ready platform for agentic workflow development. · GitHub下载zip文件四、docker的下载从docker官网下载“docker desktop”Docker Desktop 官方下载页面链接如下https://www.docker.com/products/docker-desktop/Docker 的官方网站地址是Docker: Accelerated Container Application Development在官网首页你可以找到以下重要入口下载 Docker Desktop点击导航栏的 Products - Docker Desktop即可下载适用于 Windows、macOS 和 Linux 的安装包。官方文档点击 Docs 可以查阅详尽的安装教程、配置指南和命令手册。Docker Hub点击 Docker Hub 可以访问官方的容器镜像仓库用于搜索和拉取所需的镜像。这里选择AMD版本五、Windows下docker的安装完成安装之后下载更新wsl --install或wsl --update无法直接登录时直接下载地址可以下载watt tolkit如果你点击头像后没有看到 “Settings”可能是你当前处于组织或企业账户视图可以尝试直接访问这个链接https://github.com/settings/keys六、打开电脑虚拟化打开控制面板参考已经默认打开不用管七、部署Dify1、将下好的dify-main.zip粘贴到C:\Work\AI下并解压。打开到D:\AI\dify-main\dify-main\docker文件夹下将.env.example文件复制粘贴并将粘贴后的文件名改为.env防止改错配置可以恢复2、打开cmd窗口然后进入dify下的docker目录如下图3、采用命令docker compose up -d来启动Dify如下图报错解决方法把这个json文件里面的修改如下{ builder: { gcr: { defaultKeepStorage: 20GB, enabled: true } }, experimental: false, registry-mirrors: [ https://docker.m.daocloud.io, https://dockerproxy.com, https://docker.nju.edu.cn ] }现在正常了拉取了同时拉取老是出现网络问题这里挨个拉取docker pull langgenius/dify-api:1.15.0 docker pull langgenius/dify-web:1.15.0 docker pull postgres:15-alpine docker pull redis:6-alpine docker pull nginx:latest docker pull semitechnologies/weaviate:1.27.0 docker pull ubuntu/squid:latest docker pull busybox:latest docker pull langgenius/dify-sandbox:0.2.15 docker pull langgenius/dify-plugin-daemon:0.6.3-local启动成功八、打开使用dify1、添加ollama模型在浏览器地址栏中输入http://localhost看到Dify的登录/注册页面。首次访问时你需要创建一个管理员账户设置邮箱和密码之后可以开始使用Dify构建AI应用2、在集成里面先安装ollama然后点击添加模型1、qwen3:8b2、选择LLM3、组织 ID留空Ollama 不需要4、API Basehttp://host.docker.internal:114345、API 协议Chat CompletionsDify 后台→ 右上角头像 →设置→模型供应商。找到Ollama卡片点击添加模型。填入上表配置保存。打开你的工作流点击LLM 节点在模型选择下拉中切换到qwen3:8b。保存并运行测试。3、配置要点对照你的环境配置项填写内容Model Nameqwen3:8b与ollama list中的名称完全一致Base URLhttp://host.docker.internal:11434API Key任意占位符如ollama2、模型选择1. 系统推理模型 (必选)选择qwen3-vl:4b(Ollama)说明这就是你刚才配置好的那个大模型。选中它后以后新建对话机器人时默认就会用这个模型来回答问题。2. Embedding 模型 (强烈建议配置)选择点击下拉框 - 选择Ollama- 选择bge-m3(或者nomic-embed-text)说明这一步非常关键如果你要用 Dify 的“知识库”功能上传文档让 AI 学习就必须配这个。如果你还没在 Ollama 下载过请打开电脑终端运行ollama pull bge-m3。BGE-M3 是目前中文效果很好的开源向量模型。如果不填你的 Dify 将无法使用知识库检索功能。3. Rerank 模型 (可选)选择保持为空或选择模型设置- 暂时不选说明这是用来给搜索结果“二次精排”的能提高知识库回答的准确度。但对于本地部署尤其是显存有限的情况建议先留空否则运行时会同时加载三个模型容易爆显存。等跑通了再考虑加。4. 语音转文本 / 文本转语音 (可选)选择保持为空说明除非你要做语音通话机器人否则普通文字聊天不需要这两个留着空白即可。1、参考Windows 系统上Git详细图文安装及使用教程2、参考一文速通 Dify Ollama 本地化部署 从零配置到应用发布超详细保姆级教程3、参考Windows下Dify的安装4、参考DeepseekDockerDify手把手教学