Dify个人助理本地搭建快速入门

关于在本地搭建Dify个人智能助手这件事，其实核心思路很清晰：先搞定Docker这个运行环境，然后下载并启动Dify项目，最后把本地知识库和模型接入进来。说白了，就是三步走。下面我们一步步拆开来看，力争零基础也能跑通。

Docker安装

1. 官网选择自己的版本

先从Docker说起，这是整个基础设施的基石。去官网根据你的操作系统下载安装包，Windows、macOS还是Linux，对应版本选好就行。没什么特别的操作，一路下一步。

2. 查看是否安装成功

装完之后，总得确认一下它是不是真的能用了。命令行敲一句检查一下：

docker version

如果能看到版本信息，说明Docker已经乖乖上岗了。

3. Docker运行

需要注意一点：运行命令的时候，务必确保当前目录下包含了正确的 Compose 文件（通常是 docker-compose.yml），不然会提示找不到文件。

启动项目

• 启动项目（记得先切到对应的项目目录下面）

docker-compose up

• 如果想让它在后台安静跑着，不占用当前终端窗口，那就加个参数：

docker-compose up -d

• 如果是已经存在但停了的容器，想要重新启动，用这条命令不会创建新容器：

docker-compose start

• 想看看当前有哪些服务在运行、状态如何：

docker-compose ps

停止运行

• 如果是在前台窗口跑的，直接按Ctrl + C组合键，容器就会停止。
• 只停止容器，不删除它们：

docker-compose stop

• 如果希望彻底停掉所有服务，并且把Compose文件里定义的容器、网络和卷都一并清理：

docker-compose down

日志查看

• 如果运行过程中间出了问题，或者想看看服务都输出些什么信息，可以查日志：

docker-compose logs

Dify下载

下载地址：https://github.com/langgenius/dify/releases

运行

• 1. 切到 dify/docker 目录。
• 2. 复制配置文件，把示例文件变成实际使用的配置：

cp .env.example .env

• 3. 执行启动命令（注意当前文件目录要正确）：

docker compose up

• 4. 访问本地地址。默认80端口，直接在浏览器输入 http://127.0.0.1 就能看到界面。

设置模型

进去之后，干这么几件事：先把模型配好。这个环节通常需要你填入模型的API Key等信息，具体看你的模型供应商。配好之后才能让助手有“脑子”。

创建知识库

有了模型还不够，要让助手回答你指定的内容，就得建一个知识库。把本地文档、数据导进去，让它能检索到相关信息。

创建成功后和应用结合

• 这里建议先创建一个聊天助手类型的应用。

• 然后在应用配置里关联你刚刚建好的知识库（

  记得提前把本地内容传进去
  ）。

标注

• 如果只是少量数据需要手动纠正或补充，直接用界面上的自定义维护功能就行，简单直接。

• 如果需要批量处理，也有对应的批量操作入口。

提示词（

谨慎参考 哈哈

）

• 提示词这块，尽量用自然语言的逻辑去写。Dify在数据提取部分已经内置了字段类型可选，你不需要完全从零开始。

• 其实你也可以不点生成，直接在提示词框子里按自己的思路写逻辑，效果也OK。

开场白

开场白就是助手第一次跟用户说话时的招呼语。按你的应用场景，写一段合适的开场白，能让用户更快上手。