Ubuntu本地部署Dify完全指南：从零搭建你的AI应用平台 （小白也能轻松上手）

一、环境准备

在开始本地部署Dify之前，请确保你的Ubuntu系统满足以下条件：

• Ubuntu 20.04/22.04 LTS 或更高版本
• 至少4GB内存（推荐8GB）
• 10GB以上可用磁盘空间
• 具有sudo权限的用户

首先更新系统并安装必要依赖：

    sudo apt update && sudo apt upgrade -ysudo apt install -y curl git wget  

二、安装Docker与Docker Compose

Dify推荐使用Docker进行部署，因此我们需要先安装Docker环境。这是Dify安装教程中最关键的一步。

1. 安装Docker

    curl -fsSL https://get.docker.com -o get-docker.shsudo sh get-docker.shsudo usermod -aG docker $USERnewgrp docker  # 或者重新登录使权限生效  

2. 安装Docker Compose

    sudo apt install -y docker-compose-plugin# 验证安装docker compose version  

三、获取Dify源代码

克隆Dify官方仓库到本地，并进入目录：

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

如果你访问GitHub较慢，可以使用国内镜像源替换地址。

四、配置环境变量

复制示例配置文件并编辑：

    cp .env.example .envnano .env  

对于本地部署Dify，默认配置通常足够，你只需要修改以下关键项（如需）：

• SECRET_KEY：随机生成一个长字符串用于加密
• CONSOLE_API_URL 和 SERVICE_API_URL：如果使用IP访问，可改为你的服务器IP

保存并退出（Ctrl+O, Ctrl+X）。

五、启动Dify服务

使用Docker Compose一键启动所有服务：

    docker compose up -d  

该命令会拉取所需镜像（PostgreSQL、Redis、Weaviate等），并启动Dify后端、前端、Worker等容器。首次启动可能需要几分钟，请耐心等待。

查看容器运行状态：

    docker compose ps  

所有服务状态应为 Up 或 running。

六、访问与使用

部署成功后，通过浏览器访问 http://你的服务器IP:80（默认端口80），即可看到Dify的初始化页面。按照引导创建管理员账号，就能开始体验这个强大的AI应用开发平台了。

至此，你已经完成了Ubuntu部署Dify的全部流程！后续你可以探索Dify的知识库、工作流编排、API集成等功能，快速构建属于你自己的AI应用。

七、常见问题与维护

• 端口冲突：如果80端口被占用，可以在 .env 中修改 EXPOSE_NGINX_PORT 为其他端口，然后重新启动。
• 查看日志：docker compose logs -f 可以实时查看服务日志，帮助排查问题。
• 停止服务：docker compose down 停止并移除容器；docker compose stop 仅停止容器。
• 更新Dify：进入 dify/docker 目录，执行 git pull 拉取最新代码，然后重新 docker compose up -d。

通过这份教程，相信即使是技术小白也能顺利完成本地部署Dify。现在就开始你的AI应用开发之旅吧！