Ubuntu 本地部署 Dify 详细教程
在 Ubuntu 系统上通过 Docker Compose 本地部署 Dify 开源大语言模型应用开发平台的完整流程。内容涵盖环境准备、Docker 安装与配置、镜像源设置、源码获取、环境变量调整及服务启动步骤。部署完成后,用户可通过浏览器访问 localhost/apps 创建管理员账号并使用聊天助手、文本生成、Agent 及工作流等功能。

在 Ubuntu 系统上通过 Docker Compose 本地部署 Dify 开源大语言模型应用开发平台的完整流程。内容涵盖环境准备、Docker 安装与配置、镜像源设置、源码获取、环境变量调整及服务启动步骤。部署完成后,用户可通过浏览器访问 localhost/apps 创建管理员账号并使用聊天助手、文本生成、Agent 及工作流等功能。

① 支持主流商业模型(如 OpenAI GPT、Claude、DeepSeek、ChatGLM 等)及开源模型(如 Llama、Mistral);
② 提供 模型管理 功能,支持快速切换和自定义接入。
聊天助手:多轮对话交互(如客服机器人);
文本生成:自动化创作、翻译、摘要等;
Agent:任务分解、工具调用(如数据分析、API 集成);
工作流:可视化编排复杂流程(如条件分支、多节点任务)。
RAG(检索增强生成):
① 支持文档上传、分块、向量化索引(如 PDF、Notion 同步);
② 提供混合检索(向量 + 全文搜索)和重排序优化。Agent 框架:
① 支持 Function Calling 和 ReAct 推理模式,集成工具(如搜索、代码执行)。
① 通过可视化界面编排 Prompt、上下文和插件,无需深入编码;
② 提供模块化设计,如拖拽式工作流构建。
# 安装 Docker
sudo apt update
sudo apt install -y docker.io
# 启动 Docker 服务
sudo systemctl start docker
sudo systemctl enable docker
# 安装 Docker Compose
sudo apt install -y docker-compose
# 将当前用户添加到 docker 组(避免每次使用 sudo)
sudo usermod -aG docker $USER
# 克隆 Dify 仓库
git clone https://github.com/langgenius/dify.git

cd dify/docker

# 复制环境变量示例文件
cp .env.example .env
如果需要,请卸载,如果不需要请跳过。
# 卸载现有 Docker
sudo apt purge -y docker.io docker-compose
sudo rm -rf /var/lib/docker /var/lib/containerd
# 重新安装
sudo apt update
sudo apt install -y docker.io docker-compose
# 启动服务
sudo systemctl start containerd
sudo systemctl start docker
# 将当前用户添加到 docker 组(避免每次使用 sudo)
sudo usermod -aG docker $USER
sudo vim /etc/docker/daemon.json
{"registry-mirrors":["https://docker.xuanyuan.me","https://docker.1ms.run"]}
sudo systemctl daemon-reload
sudo systemctl restart docker
docker info | grep -A 10-i registry
sudo pkill dockerd
sudo rm -f /var/run/docker.pid
sudo systemctl daemon-reexec
sudo systemctl daemon-reload
sudo systemctl restart docker
检查是否有镜像路径写死在 docker-compose.yaml 文件中;
使用 sed 批量替换镜像地址(仅适用于明文配置):
sed -i 's#registry-1.docker.io#docker.xuanyuan.me#g' docker-compose.yaml
docker pull docker.xuanyuan.me/library/redis:6-alpine
docker pull docker.1ms.run/library/nginx:alpine
玄元云:https://docker.xuanyuan.me
1ms:https://docker.1ms.run
阿里云:登录 阿里云容器镜像服务 获取;
清华大学:https://docker.tuna.tsinghua.edu.cn;
中科大:https://docker.mirrors.ustc.edu.cn
# 启动所有服务
docker-compose up -d
# 查看服务状态
docker-compose ps

部署完成后,通过浏览器访问:http://localhost/apps;

首次访问时,系统会引导创建管理员账号,按照提示完成设置即可。

常用命令: 停止服务:docker-compose down 查看日志:docker-compose logs -f 重启服务:docker-compose restart

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online