在WSL上部署Dify

安装准备

Dify安装部署依赖Docker和Docker Compose。安装Dify前需要先在WSL openEuler 24.03上安装好上述Docker软件。

配置Docker需要的内核参数，开启IP转发与桥接功能

# 配置内核参数
sudo tee /etc/sysctl.d/docker.conf << EOF
net.ipv4.ip_forward = 1
net.bridge.bridge-nf-call-iptables = 1
EOF
# 生效参数
sudo sysctl --system

安装Docker依赖的工具

# 安装 dnf 相关的工具包（openEuler 使用 dnf 作为包管理器）
sudo dnf install -y dnf-utils dnf-plugins-core
# 安装设备映射和 LVM2 工具
sudo dnf install -y device-mapper-persistent-data lvm2
# 安装其他可能需要的工具
sudo dnf install -y curl wget git vim

执行sysctl -a | grep ip_forward验证内核参数是否生效。如果有提示net.ipv4.ip_forward = 1则已经生效。

添加Docker源

由于docker源国内访问很慢，我们可以直接添加docker的国内镜像源。

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

使用如下命令修改源配置中的操作系统版本信息以适配openEuler 24.03

sudo sed -i 's/$releasever/8/g' /etc/yum.repos.d/docker-ce.repo

这个参数$releasever 在openEuler里面是24.03 LTS，因此执行安装命令过程中无法从docker源中找到软件，上述命令版本替换成8（对应CentOS 8版本）。

安装Docker软件

1. 安装docker软件

sudo dnf install -y docker-ce docker-ce-cli containerd.io

2. 验证安装结果

# 启动Docker服务并设置开机自启
sudo systemctl start docker 
sudo systemctl enable docker 
# 验证Docker服务状态 
sudo systemctl status docker 
# 将当前用户加入docker组（避免每次sudo） 
sudo usermod -aG docker $USER 
# 重新登录生效后验证Docker版本 
docker --version

安装Docker Compose

1. 下载并安装

# 下载Docker Compose二进制文件
sudo curl -L "https://github.com/docker/compose/releases/download/v5.1.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose 
# 赋予执行权限
sudo chmod +x /usr/local/bin/docker-compose 
# 创建符号链接 
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose 
# 验证安装 
docker-compose --version

其中第一步也可以直接从https://github.com/docker/compose/releases下载最新的Linux x86_64版本的。

2. 配置用户权限

# 避免频繁使用
sudo sudo groupadd docker
sudo usermod -aG docker $USER 
# 重新登录生效
newgrp docker 
# 验证非特权用户操作
docker ps

配置docker hub国内镜像

编辑/etc/docker/daemon.json，配置docker hub的镜像地址：

{
  "registry-mirrors": [
    "https://docker.xuanyuan.me",
    "https://docker.1ms.run",
    "https://docker.m.daocloud.io"
  ]
}

注意：上述的镜像可能失效，需要查询最新可用的镜像。如果不配置国内镜像或者国内镜像不可用会导致后续安装Dify失败。保存后需要重启docker 服务 sudo systemctl restart docker。

安装Dify

git clone https://github.com/langgenius/dify.git
cd dify
cp .env.example .env
docker-compose up -d

第一步也可以从github网站上手工下载最新的dify release版本，再解压缩。
.env 文件是配置文件，Dify主要配置参数都可以再这里修改。第一次启动Dify时会从docker hub上拉取依赖的镜像。因此需要与配置好docker hub国内镜像源。第一次安装时建议先不使用-d 参数，方便观察启动信息。

在Windows 浏览器中输入http://wsl虚拟ip/install，如果可以访问Dify即安装成功。其中wsl虚拟ip地址可以在wsl 中用过ifconfig | grep 172查询，对应eth0虚拟网卡的地址。

配置Dify

Dify主要的配置都在.env文件。可以通过编辑 .env文件，配置Dify。几个推荐修改配置如下：

1. PIP国内镜像PIP_MIRROR_URL=https://mirrors.aliyun.com/pypi/simple。配置此镜像的目的是因为Dify插件都是python包形式组织。安装插件即安装对应的python软件包。

2. 配置插件初始化时间
   PLUGIN_PYTHON_ENV_INIT_TIMEOUT=600 # 默认是120秒，当安装比较大的插件是和容易超时，可以配置成600秒；

3. 配置WEB UI端口

EXPOSE_NGINX_PORT=5080 # 默认是80端口，可能会和Windows上服务端口冲突，修改成其他端口。

注意：Dify启动、配置的其他问题都可以将错误直接丢给DeepSeek询问如何解决。比自己搜索快很多：）。

启动停止Dify

进入到Dify安装的目录中执行以下命令启动/停止Dify：

docker-compose up -d # 启动Dify
docker-compose down # 停止Dify