Dify 本地部署全攻略：Ubuntu 环境下零基础安装配置及连接 MySQL 数据库教程 (从入门到精通)

二、准备工作：安装 Docker 环境

在 Ubuntu 中安装 Dify 最简单的方式是使用 Docker。请依次执行以下命令来更新系统并安装 Docker：

# 更新包列表sudo apt-get update# 安装 Dockersudo apt-get install docker.io docker-compose -y# 启动并设置开机自启sudo systemctl start dockersudo systemctl enable docker

三、获取 Dify 源码与安装

这是 零基础Dify教程 的核心步骤。我们需要从 GitHub 克隆源码并启动服务：

# 克隆 Dify 代码仓库git clone https://github.com/langgenius/dify.git# 进入 docker 目录cd dify/docker# 复制环境变量配置文件cp .env.example .env# 启动 Difysudo docker-compose up -d

执行完成后，你可以通过浏览器访问 http://你的服务器IP 来查看 Dify 界面。

四、深度进阶：Dify配置MySQL连接

虽然 Dify 默认使用 PostgreSQL 存储自身数据，但在实际开发中，我们经常需要将 LLM应用开发平台 与现有的 MySQL 数据库进行连接，以便调用外部业务数据。

在 Dify 中连接 MySQL 的主要场景是在“工作流”或“数据集”中使用。以下是配置步骤：

• 步骤1： 登录 Dify 控制台，进入“工具”或“应用编排”界面。
• 步骤2： 选择“外部数据工具”或通过 Python 节点编写连接逻辑。
• 步骤3： 填入你的 MySQL 连接信息（主机地址、端口3306、用户名、密码）。
• 注意： 确保你的 Ubuntu 防火墙已开放 3306 端口，且 MySQL 允许远程连接。

五、常见问题排查

如果在执行 Dify配置MySQL 过程中遇到连接失败，请检查以下几点：

1. 检查 MySQL 的 my.cnf 配置文件，确保 bind-address 设置为 0.0.0.0。
2. 确认 Docker 容器网络与宿主机 MySQL 网络是否通畅。
3. 检查 MySQL 用户权限，确保该用户拥有访问目标数据库的权限。

六、总结

通过本篇 零基础Dify教程，你已经掌握了在 Ubuntu 上部署 Dify 的全过程。无论是 Ubuntu Dify安装 还是后续的数据库配置，只要按照步骤操作，都能轻松搞定。快去开启你的 AI 应用开发之旅吧！