Shell / BashSaaSAI
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