Dify 本地部署分步走：Ubuntu 系统的命令行操作详解

Dify 是一个开源的大语言模型应用开发平台，支持快速构建和部署 AI 应用。在 Ubuntu 系统上通过命令行进行本地部署，可以高效地搭建开发环境。本教程将分步讲解部署过程，确保您能顺利完成。部署前，请确保：

• 系统为 Ubuntu 20.04 或更高版本。
• 拥有管理员权限（sudo 命令可用）。
• 网络连接稳定。

步骤 1: 安装系统依赖

首先，更新系统包并安装必要的依赖工具。这些工具包括 Python、Git 和 pip，用于管理代码和依赖库。

sudo apt update
sudo apt upgrade -y
sudo apt install -y python3 python3-pip git

验证安装：

python3 --version
pip3 --version
git --version

步骤 2: 克隆 Dify 仓库

使用 Git 从官方仓库克隆 Dify 源代码到本地目录。这将获取最新版本的代码。

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

步骤 3: 安装 Python 依赖

进入项目目录后，使用 pip 安装所有 Python 依赖包。这些包包括 FastAPI、SQLAlchemy 等核心库。

pip3 install -r requirements.txt

步骤 4: 配置环境变量

Dify 需要设置环境变量来定义数据库和模型路径。创建并编辑配置文件，例如使用 .env 文件。

nano .env

在文件中添加以下内容（根据您的实际路径调整）：

DATABASE_URL=sqlite:///./dify.db
MODEL_PATH=/path/to/your/model

保存后退出编辑器（按 Ctrl+X，然后 Y 确认）。

步骤 5: 初始化数据库

运行初始化命令来创建数据库表和初始数据。这将设置应用的基础结构。

python3 manage.py db upgrade

步骤 6: 启动 Dify 服务

使用 Uvicorn 启动服务。这将运行一个本地服务器，监听默认端口 8000。

uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

步骤 7: 验证部署

在浏览器中访问 http://localhost:8000，检查是否出现 Dify 的欢迎界面。同时，在命令行查看日志输出，确保无错误。

# 在另一个终端窗口查看日志
tail -f nohup.out

常见问题解决

• 端口冲突：如果端口 8000 被占用，修改启动命令中的端口号，例如 --port 8080。
• 依赖错误：重新运行 pip3 install -r requirements.txt 并确保 Python 版本兼容。
• 权限问题：使用 sudo 运行命令，但注意安全风险。

完成以上步骤后，您已成功在 Ubuntu 上部署 Dify。接下来，您可以探索其 API 和界面来构建自定义 AI 应用。如需进一步优化，参考官方文档调整配置。