第一步：安装 Docker Desktop

到 docker.com 下载 AMD64 版并安装。国内网络环境下镜像拉取可能失败，科学上网或配置镜像源可解决。

第二步：用 Docker 启动 Dify

git clone https://github.com/langgenius/dify.git
cd dify/docker
copy .env.example .env    # Windows 用 copy 代替 cp
docker compose up -d

无 Git 的同学可直接下载 zip 解压（注意解压后目录名是 dify-main）。浏览器打开 http://localhost/install 完成初始化并注册账号。

第三步：关联本地 DeepSeek 模型

  • 在 Dify 的模型供应商中选择 Ollama（不要选 DeepSeek 在线供应商，那是付费云 API）
  • 模型名填你本地拉取的版本，如 deepseek-r1:1.5b
  • 首次关联可能报错：这是 Docker 与物理机网络隔离导致，配置本地环境变量
  • 关键：把关联地址设为 http://host.docker.internal:11434 指向宿主机的 Ollama

第四步：创建知识库与问答应用

  1. 在 Dify 中新建知识库，上传自己的文档（PDF / Word / Markdown）
  2. 选择嵌入模型完成向量化（可用本地嵌入模型，保证全程离线）
  3. 新建应用 → 关联知识库 → 即可开始基于文档的对话问答
  4. 小模型（1.5B）对长文档理解有限，建议换 8B 以上模型或改用在线 API
host.docker.internal:11434 是 Docker 访问宿主机 Ollama 的桥梁，90% 的关联失败都卡在这一步。