*Window和Linux本地化部署都试过，推荐在Linux系统使用 Docker Compose 部署 Dify ，这是很成熟很方便的一个方案

一、部署前准备

在开始部署前，请确保您的环境满足以下最低要求：

配置项	最低要求	推荐配置（生产环境）
操作系统	Linux / macOS / Windows (WSL2)	Ubuntu 22.04 LTS
CPU	≥ 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镜像源（推荐新手）

这是官方推荐的安装方式，通过阿里云等国内源来安装，稳定且方便后续更新

1. 安装必要依赖

   sudo yum install -y yum-utils device-mapper-persistent-data lvm2

2. 添加阿里云的 Docker 仓库

   sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

3. 更新YUM缓存并安装Docker

   sudo 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核心功能，可暂时忽略。

4. 启动并验证

   sudo systemctl start docker
   sudo systemctl enable docker
   sudo docker version

   

三、安装git

# 更新系统软件包列表
sudo yum update -y
# 安装 Git
sudo yum install git -y

四、安装Dify

第一步、验证与准备工作

到你指定安装的文件夹下面，例如 /opt/ 下面进行安装，先验证下docker

cd /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 --zone=public --add-port=80/tcp --permanent

# 重新加载防火墙配置

sudo firewall-cmd --reload

第五步：登录web

首次登录需要等几分钟……（耐心点）

web网址：             http://服务器ip/install（如 http://localhost/install）

登录

第一次登录的时候需要自己去注册用户名和密码，然后登陆进去后就是如下界面：

设置

点击最右边图标

点击设置

添加模型

如添加通义，如下图

******在安装过程中，我遇到下载模型超时问题，解决方案如下

修改 .env 文件中的三个参数：

# 延长Python环境初始化超时时间 (秒) 
PLUGIN_PYTHON_ENV_INIT_TIMEOUT=6400 
# 延长插件最大执行超时时间 (秒) 
PLUGIN_MAX_EXECUTION_TIMEOUT=2400
#配置镜像源
PIP_MIRROR_URL=https://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

六、应用