Dify Windows 原生部署（无 Docker、纯本地）

CodeMartain2026-05-22 19:22

装机必备:

python环境

python3.X

bash 复制代码

python --version
Python 3.10.9

pg环境

最好是PostgreSQL 15+

bash 复制代码

postgres --version
postgres (PostgreSQL) 17.5

node环境

node版本最好使用nvm来管理,不然就有得麻烦了

bash 复制代码

 nvm list installed

    24.15.0
  * 22.22.1 (Currently using 64-bit executable)
    20.14.0
    18.17.0
    16.16.0
    14.15.0

本次选用的是22.22.1版本--至于为啥,请看下面的报错

bash 复制代码

pnpm install
[ERR_PNPM_UNSUPPORTED_ENGINE] Unsupported environment (bad pnpm and/or Node.js version)

Your Node version is incompatible with "D:\AI\dify".

Expected version: ^22.22.1
Got: v24.15.0

This is happening because the package's manifest has an engines.node field specified.
To fix this issue, install the required Node version.

git环境

bash 复制代码

git --version
git version 2.53.0.windows.1

拉取tidy最新代码

bash 复制代码

git clone https://gitee.com/dify_ai/dify.git

开始部署

环境准备好之后,代码拉取到本地之后,

进入api文件夹

bash 复制代码

cd D:\AI\dify\api

安装uv

bash 复制代码

irm https://astral.sh/uv/install.ps1 | iex

安装依赖

bash 复制代码

uv sync

复制换配置

把api里面的.env.example 复制一份，改名为 .env

修改下面几个配置

bash 复制代码

SECRET_KEY=1234567890abcdefghijklmnopqrstuvwxyz
#数据库配置
DB_HOST=localhost
DB_PORT=5432
DB_USERNAME=postgres
DB_PASSWORD=123456 #改为自己的数据库密码
DB_DATABASE=dify
#Redis配置
REDIS_USERNAME=
REDIS_PASSWORD=

初始化数据库

bash 复制代码

uv run flask db upgrade

启动后端

bash 复制代码

uv run flask run --host=0.0.0.0 --port=5001

启动前端

进入web文件夹

bash 复制代码

cd D:\AI\dify\web

安装前端依赖

bash 复制代码

pnpm install

启动前端

bash 复制代码

pnpm dev

启动成功

bash 复制代码

PS D:\AI\dify\web> pnpm dev
$ next dev
▲ Next.js 16.2.6 (Turbopack)
- Local:         http://localhost:3000
- Network:       http://172.30.208.1:3000