*Window和Linux本地化部署都试过推荐在Linux系统使用 Docker Compose 部署 Dify 这是很成熟很方便的一个方案一、部署前准备在开始部署前请确保您的环境满足以下最低要求配置项最低要求推荐配置生产环境操作系统Linux / macOS / Windows (WSL2)Ubuntu 22.04 LTSCPU≥ 2 核≥ 4 核内存≥ 4 GB≥ 16 GB磁盘≥ 50 GB (SSD)≥ 100 GB软件Docker 19.03 Docker Compose 2.24.0同上网络稳定互联网国内用户建议配置镜像加速Windows用户请务必确保系统已安装WSL2并将Docker Desktop设置为WSL2后端。GPU支持如需使用GPU进行本地模型推理请额外安装NVIDIA Container Toolkit。下面以liunx的centos系统为例做详细的安装实践讲解二、安装 Docker 与 Docker Compose使用国内YUM镜像源推荐新手这是官方推荐的安装方式通过阿里云等国内源来安装稳定且方便后续更新安装必要依赖sudo yum install -y yum-utils device-mapper-persistent-data lvm2添加阿里云的 Docker 仓库sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo更新YUM缓存并安装Dockersudo yum makecache fast sudo yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin注意最后这条命令中的docker-buildx-plugin和docker-compose-plugin为可选组件即使安装失败也不影响Docker核心功能可暂时忽略。启动并验证sudo systemctl start docker sudo systemctl enable docker sudo docker version三、安装git# 更新系统软件包列表 sudo yum update -y # 安装 Git sudo yum install git -y四、安装Dify第一步、验证与准备工作到你指定安装的文件夹下面例如 /opt/ 下面进行安装先验证下dockercd /opt docker --version新版 Docker 已集成docker compose命令注意中间没有横线无需单独安装。安装 Docker 后直接运行docker compose version即可验证如果显示v2.20.0或更高版本说明已就绪。配置镜像加速为了后续拉取镜像更快可以配置 Docker 镜像加速器。使用以下命令写入配置并重启 Docker 服务这个很重要推荐弄# 1. 创建配置目录 sudo mkdir -p /etc/docker # 2. 写入国内可用的镜像源配置 sudo tee /etc/docker/daemon.json -EOF { registry-mirrors: [https://docker.m.daocloud.io, https://dockerpull.com, https://docker.1panel.live] } EOF # 3. 重载配置并重启 Docker 服务 sudo systemctl daemon-reload sudo systemctl restart docker配置完成后可以运行sudo docker info在输出结果中查找Registry Mirrors字段确认镜像地址已成功添加。*因为我是在root用户下操作的所以用不用sudo都可以你们根据具体情况操作第二步获取 Dify 源码使用git clone命令将 Dify 的源码下载到本地。推荐使用 Gitee 镜像在国内下载速度更快因为外网的原因Github地址经常不稳所以推荐用Gitee# 使用 Gitee 镜像克隆 Dify 源码 git clone https://gitee.com/mirrors/dify.git克隆完成后会生成一个名为dify的文件夹。第三步配置与启动 Dify进入 Docker 配置目录并复制环境变量文件# 进入 Dify 源代码的 Docker目录 cd dify/docker # 复制环境配置文件 cp .env.example .env可选修改 Web 服务端口Dify 默认使用80端口。为了防止与其他服务冲突或是因为防火墙原因建议修改为一个自定义端口例如8080。# 使用 vim 编辑 .env 文件 vim .env在文件中找到EXPOSE_NGINX_PORT这一行将后面的80修改为你想要的端口号比如8080然后保存退出。这样后续就能通过http://你的服务器IP:8080来访问了。启动 Dify 服务docker compose up -d这个命令会自动拉取所需的 Docker 镜像约 5-10 个大小约 5-7GB耗时取决于网络状况并在后台启动所有容器如下图你可以使用docker compose ps命令来检查各个容器的运行状态确保它们都是Up或healthy状态# 查看服务状态 docker compose ps # 查看日志 docker compose logs -f第四步开发端口以及防火墙# 开放 80 端口请替换为你实际设置的端口 sudo firewall-cmd --zonepublic --add-port80/tcp --permanent # 重新加载防火墙配置 sudo firewall-cmd --reload第五步登录web首次登录需要等几分钟……耐心点web网址 http://服务器ip/install如 http://localhost/install登录第一次登录的时候需要自己去注册用户名和密码然后登陆进去后就是如下界面设置点击最右边图标点击设置添加模型如添加通义如下图******在安装过程中我遇到下载模型超时问题解决方案如下修改 .env 文件中的三个参数# 延长Python环境初始化超时时间 (秒) PLUGIN_PYTHON_ENV_INIT_TIMEOUT6400 # 延长插件最大执行超时时间 (秒) PLUGIN_MAX_EXECUTION_TIMEOUT2400 #配置镜像源 PIP_MIRROR_URLhttps://mirrors.aliyun.com/pypi/simple/然后需要重启服务才能生效docker compose down docker compose up -d配置模型添加API密钥凭据名称随你填配置完成五、关闭以及启动服务电脑关机前推荐先关掉dify服务# 方式一优雅停止保留容器下次启动快 docker compose stop # 方式二停止并删除容器/网络保留数据卷下次重新创建 docker compose down启动服务docker compose up -d######如果遇到web打不开那么重启docker并重启服务可能是上次没有正常关闭服务造成sudo systemctl restart docker docker compose down docker compose up -d六、应用 
长河君 · 2026/9/14 18:03:46 · 阅读 1.2k 安装部署Dify（linux系统）步骤详细图文并用
*Window和Linux本地化部署都试过推荐在Linux系统使用 Docker Compose 部署 Dify 这是很成熟很方便的一个方案一、部署前准备在开始部署前请确保您的环境满足以下最低要求配置项最低要求推荐配置生产环境操作系统Linux / macOS / Windows (WSL2)Ubuntu 22.04 LTSCPU≥ 2 核≥ 4 核内存≥ 4 GB≥ 16 GB磁盘≥ 50 GB (SSD)≥ 100 GB软件Docker 19.03 Docker Compose 2.24.0同上网络稳定互联网国内用户建议配置镜像加速Windows用户请务必确保系统已安装WSL2并将Docker Desktop设置为WSL2后端。GPU支持如需使用GPU进行本地模型推理请额外安装NVIDIA Container Toolkit。下面以liunx的centos系统为例做详细的安装实践讲解二、安装 Docker 与 Docker Compose使用国内YUM镜像源推荐新手这是官方推荐的安装方式通过阿里云等国内源来安装稳定且方便后续更新安装必要依赖sudo yum install -y yum-utils device-mapper-persistent-data lvm2添加阿里云的 Docker 仓库sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo更新YUM缓存并安装Dockersudo yum makecache fast sudo yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin注意最后这条命令中的docker-buildx-plugin和docker-compose-plugin为可选组件即使安装失败也不影响Docker核心功能可暂时忽略。启动并验证sudo systemctl start docker sudo systemctl enable docker sudo docker version三、安装git# 更新系统软件包列表 sudo yum update -y # 安装 Git sudo yum install git -y四、安装Dify第一步、验证与准备工作到你指定安装的文件夹下面例如 /opt/ 下面进行安装先验证下dockercd /opt docker --version新版 Docker 已集成docker compose命令注意中间没有横线无需单独安装。安装 Docker 后直接运行docker compose version即可验证如果显示v2.20.0或更高版本说明已就绪。配置镜像加速为了后续拉取镜像更快可以配置 Docker 镜像加速器。使用以下命令写入配置并重启 Docker 服务这个很重要推荐弄# 1. 创建配置目录 sudo mkdir -p /etc/docker # 2. 写入国内可用的镜像源配置 sudo tee /etc/docker/daemon.json -EOF { registry-mirrors: [https://docker.m.daocloud.io, https://dockerpull.com, https://docker.1panel.live] } EOF # 3. 重载配置并重启 Docker 服务 sudo systemctl daemon-reload sudo systemctl restart docker配置完成后可以运行sudo docker info在输出结果中查找Registry Mirrors字段确认镜像地址已成功添加。*因为我是在root用户下操作的所以用不用sudo都可以你们根据具体情况操作第二步获取 Dify 源码使用git clone命令将 Dify 的源码下载到本地。推荐使用 Gitee 镜像在国内下载速度更快因为外网的原因Github地址经常不稳所以推荐用Gitee# 使用 Gitee 镜像克隆 Dify 源码 git clone https://gitee.com/mirrors/dify.git克隆完成后会生成一个名为dify的文件夹。第三步配置与启动 Dify进入 Docker 配置目录并复制环境变量文件# 进入 Dify 源代码的 Docker目录 cd dify/docker # 复制环境配置文件 cp .env.example .env可选修改 Web 服务端口Dify 默认使用80端口。为了防止与其他服务冲突或是因为防火墙原因建议修改为一个自定义端口例如8080。# 使用 vim 编辑 .env 文件 vim .env在文件中找到EXPOSE_NGINX_PORT这一行将后面的80修改为你想要的端口号比如8080然后保存退出。这样后续就能通过http://你的服务器IP:8080来访问了。启动 Dify 服务docker compose up -d这个命令会自动拉取所需的 Docker 镜像约 5-10 个大小约 5-7GB耗时取决于网络状况并在后台启动所有容器如下图你可以使用docker compose ps命令来检查各个容器的运行状态确保它们都是Up或healthy状态# 查看服务状态 docker compose ps # 查看日志 docker compose logs -f第四步开发端口以及防火墙# 开放 80 端口请替换为你实际设置的端口 sudo firewall-cmd --zonepublic --add-port80/tcp --permanent # 重新加载防火墙配置 sudo firewall-cmd --reload第五步登录web首次登录需要等几分钟……耐心点web网址 http://服务器ip/install如 http://localhost/install登录第一次登录的时候需要自己去注册用户名和密码然后登陆进去后就是如下界面设置点击最右边图标点击设置添加模型如添加通义如下图******在安装过程中我遇到下载模型超时问题解决方案如下修改 .env 文件中的三个参数# 延长Python环境初始化超时时间 (秒) PLUGIN_PYTHON_ENV_INIT_TIMEOUT6400 # 延长插件最大执行超时时间 (秒) PLUGIN_MAX_EXECUTION_TIMEOUT2400 #配置镜像源 PIP_MIRROR_URLhttps://mirrors.aliyun.com/pypi/simple/然后需要重启服务才能生效docker compose down docker compose up -d配置模型添加API密钥凭据名称随你填配置完成五、关闭以及启动服务电脑关机前推荐先关掉dify服务# 方式一优雅停止保留容器下次启动快 docker compose stop # 方式二停止并删除容器/网络保留数据卷下次重新创建 docker compose down启动服务docker compose up -d######如果遇到web打不开那么重启docker并重启服务可能是上次没有正常关闭服务造成sudo systemctl restart docker docker compose down docker compose up -d六、应用