macOS部署dify及问题解决记录

走上未曾设想的道路

1630人浏览 · 2025-03-19 16:55:26

走上未曾设想的道路 · 2025-03-19 16:55:26 发布

dify部署及问题解决

1. dify是什么
- 1.1 Dify 的主要作用和功能
2 docker安装
3 dify下载安装
4 打开dify

1. dify是什么

Dify 是一个开源的大语言模型（LLM）应用开发平台，融合了后端即服务（Backend as Service, BaaS）和 LLMOps 理念，旨在简化和加速生成式AI应用的创建和部署。它支持多种大型语言模型（如OpenAI的GPT系列、Claude3等），并提供强大的数据集管理功能、可视化的 Prompt 编排以及应用运营工具。

1.1 Dify 的主要作用和功能

低代码/无代码开发：通过可视化界面，开发者可以轻松定义Prompt、上下文和插件，无需深入底层技术细节。
模块化设计：采用模块化设计，每个模块功能清晰，开发者可根据需求选择性地使用。
丰富的功能组件：包括AI工作流、RAG管道、Agent、模型管理等，支持从原型到生产的全过程。
支持多种大语言模型：已支持主流的模型，开发者可以根据需求选择最适合的模型来构建AI应用。
RAG功能：提供从文档摄取到检索的广泛RAG功能，支持从PDF、PPT等常见文档格式中提取文本。
代理功能：内置50多个工具（如Google Search、Stable Diffusion等），支持自定义工具，可基于LLM函数调用或ReAct定义代理。
LLMOps：支持监控和分析应用程序日志和性能，根据生产数据和注释不断改进提示、数据集和模型。
后端即服务：所有产品都附带相应的API，方便将Dify集成到自己的业务中。

2 docker安装

注意：dify安装需要docker，必须先行安装。

系统环境：macbook m4，芯片是apple silicon，需要下载对应版本的docker。
从doker官网下载对应系统和芯片版本的docker.dmg文件。官网地址：https://www.docker.com/。选择版本的时候需要注意，当前docker下载macOS版本的软件时，默认选择的是intel芯片的版本（我当时就踩坑了，以为选择macOS就可以），需要手动选择为apple silicon芯片的版本。
苹果电脑的docker安装比较简单，dmg文件拖进app的文件夹就行了。

3 dify下载安装

下载前要为dify源码找到一个合适的位置，你自己在电脑里设置一个位置就可以了。默认mac的命令行工具打开是在你的user目录下的，不要直接放在里面，建议创建几层文件夹去存储。
通常介绍的下载方案是

git clone https://github.com/langgenius/dify.git

但是显然我们不会科学上网，那么可以用国内的gitee上别人拉过来的代码，我是用的是

git clone https://gitee.com/dify_ai/dify.git

下一步开始安装，通常使用命令

cd dify/docker
cp .env.example .env
docker compose up -d

显然，docker compose是很容易执行不通的，如图所示，这是因为docker需要的资源都在国外的问题。
目前有多种解决方案，我选择为docker添加registry-mirrors。打开docker的dashboard，通过右上角的小齿轮进入设置界面，选择docker engine
添加如下内容，记得在原先config的最后一行加逗号“，”，这是json文件格式要求。

"registry-mirrors": [
    "https://9cpn8tt6.mirror.aliyuncs.com",
    "https://registry.docker-cn.com",
    "https://mirror.ccs.tencentyun.com",
    "https://docker.1panel.live",
    "https://2a6bf1988cb6428c877f723ec7530dbc.mirror.swr.myhuaweicloud.com",
    "https://docker.m.daocloud.io",
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com",
    "https://your_preferred_mirror",
    "https://dockerhub.icu",
    "https://docker.registry.cyou",
    "https://docker-cf.registry.cyou",
    "https://dockercf.jsdelivr.fyi",
    "https://docker.jsdelivr.fyi",
    "https://dockertest.jsdelivr.fyi",
    "https://mirror.aliyuncs.com",
    "https://dockerproxy.com",
    "https://mirror.baidubce.com",
    "https://docker.m.daocloud.io",
    "https://docker.nju.edu.cn",
    "https://docker.mirrors.sjtug.sjtu.edu.cn",
    "https://docker.mirrors.ustc.edu.cn",
    "https://mirror.iscas.ac.cn",
    "https://docker.rainbond.cc"
  ]