Windows 11 手动部署 Dify 全流程解析：从环境配置到服务启动

1. 环境准备：搭建Dify运行的基础舞台

在Windows 11上手动部署Dify，就像组装一台高性能电脑，每个部件都需要精心挑选和安装。不同于使用Docker这种"一键装机"方案，手动部署能让你更深入理解系统运作机制。我去年在给团队搭建内部AI平台时就选择了这种方式，虽然多花了两小时，但后续排查问题时效率提升了三倍不止。

1.1 Python环境配置技巧

Python是Dify的后端核心语言，但版本选择有讲究。官方推荐Python 3.11，但实测3.12也能完美运行。这里有个小技巧：使用pyenv-win管理多版本Python，避免污染系统环境。安装步骤：

# 安装pyenv-win
pip install pyenv-win --target $HOME\.pyenv

然后在系统环境变量Path中添加%USERPROFILE%\.pyenv\pyenv-win\bin和%USERPROFILE%\.pyenv\pyenv-win\shims。我习惯在项目目录下创建.python-version文件，写入3.11.5，这样进入目录自动切换版本。

1.2 Node.js的黄金组合

前端部分需要Node.js 18+，但要注意两点：

1. 不要安装最新版，某些依赖可能不兼容
2. 必须配置国内镜像源

安装完成后运行：

npm config set registry https://registry.npmmirror.com
npm config set disturl https://npmmirror.com/dist
npm config set electron_mirror https://npmmirror.com/mirrors/electron/

这些配置能解决9