Linux 子系统与 Dify/Ollama 部署流程

一、安装适用于 Linux 的 Windows 子系统（WSL）

1. 推荐方式：一键安装

• 以管理员身份运行 PowerShell
  • 右键点击“开始菜单”，选择“以管理员身份运行”
  • 在 PowerShell 窗口输入以下命令：

wsl –install

• 重启计算机
  • 执行命令后，重启计算机
  • 系统将自动启用 WSL 并安装 Ubuntu 发行版

2. 备用方式：手动安装

• 如一键安装失败，可按以下步骤手动操作：

• 启用 WSL 功能

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

• 启用虚拟机平台

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

• 设置 WSL 2 为默认版本

wsl –set-default-version 2

3. 完成 WSL 设置

• 首次启动配置
  • 首次启动 Linux 分发版时，等待 1-2 分钟完成解压
  • 后续启动速度提升
• 创建用户账户
  • 按提示输入用户名和密码
  • 确认密码

提示： 您已成功安装并配置与 Windows 集成的 Linux 子系统！

二、Docker 安装与配置

1. 下载与安装

• 访问 Docker 官网
• 下载 Docker Desktop for Windows
• 运行安装程序，按向导完成安装

2. 配置 Docker 镜像加速

• 点击系统托盘 Docker 图标，选择 “Settings”
• 进入 “Docker Engine” 页面，在配置文件中添加镜像源：

{

  “registry-mirrors”: [

    “https://docker.1ms.run”,

    “https://docker.xuanyuan.me”

  ]

}

• 点击 “Apply & Restart” 应用并重启 Docker

3. 验证安装

• 打开 WSL 终端，运行：

docker –version

docker run hello-world

• 安装完成后，已具备以下能力：
  • ✅ WSL 2 安装与配置
  • ✅ Docker Desktop 安装
  • ✅ 镜像加速配置

三、Dify 部署与启动

1. 下载 Dify

• 访问 Dify GitHub 项目
• 点击 “Code” → “Download ZIP”
• 解压 dify-main.zip 至 D:\dify

2. 使用 Docker 启动 Dify

• 按 Win + R 输入 cmd 打开命令提示符
• 进入 Dify docker 目录：

cd dify\docker

• 复制环境配置文件：

copy .env.example .env

• 启动服务：

docker compose up -d

• 查看运行中的容器：

docker ps

• 查看服务日志：

docker compose logs -f

四、Dify 初始化与访问

1. 初始化流程

• 浏览器访问 http://localhost/install
  • 若端口冲突，尝试 http://localhost:80
• 首次注册账号，输入邮箱、密码（8位以上）并登录

注意： 使用前请确保 Docker Desktop 正在运行

五、Ollama 安装与模型运行

1. 安装 Ollama

• 访问 Ollama 官网
• 下载 Windows 版本安装包并完成安装

2. 启动与验证

• 命令行启动服务：

ollama serve

• 检查安装与命令：

ollama –version

ollama –help

3. 下载并运行 deepseek-r1:1.5b 模型

ollama run deepseek-r1:1.5b

4. 常用 Ollama 命令

六、Dify 集成 Ollama

1. 安装 Ollama 插件

• 登录 Dify 控制台 (http://localhost)
• 点击右上角用户头像，选择“设置”
• 在左侧菜单选择“模型供应商”
• 找到 Ollama，点击“安装”

2. 配置连接参数

• 模型名称：deepseek-r1:1.5b
• URL 地址：http://host.docker.internal:11434

3. 验证连接

• 点击“测试连接”按钮，确保显示“连接成功”

七、创建知识库应用

1. 创建新应用

• Dify 工作台点击“创建新应用”
• 选择“知识库”类型，填写应用名称与描述，点击“创建”

2. 配置模型参数

• 进入应用后，选择“提示词编排”
• 在对话节点配置模型：
  • 供应商：Ollama
  • 模型：deepseek-r1:1.5b
  • 温度：0.7（推荐）
  • 最大令牌数：2048

3. 上传知识文档

• 点击左侧“知识库”标签，选择“创建知识库”
• 支持上传格式：
  • PDF、Word (.doc/.docx)、文本 (.txt)、Markdown (.md)
• 等待文档处理完成，显示“索引完成”即可