Shell / BashAI
Dify 本地部署安装教程（Windows + Docker）
在 Windows 系统上通过 Docker 快速部署 Dify，支持中文环境。步骤包括安装 Docker Desktop 和 Git，配置国内镜像源及存储目录，克隆项目源码并设置环境变量，调整端口避免冲突，最后启动容器并验证服务状态。文档涵盖常用管理命令及常见故障排查方法，帮助开发者搭建本地 AI 应用环境。
在 Windows 系统上通过 Docker 快速部署 Dify，支持中文环境。步骤包括安装 Docker Desktop 和 Git，配置国内镜像源及存储目录，克隆项目源码并设置环境变量，调整端口避免冲突，最后启动容器并验证服务状态。文档涵盖常用管理命令及常见故障排查方法，帮助开发者搭建本地 AI 应用环境。
目标：在 Windows 系统上通过 Docker 快速部署 Dify，支持中文环境，提升访问速度并合理管理磁盘空间。
Dify 使用 Docker 进行容器化部署，因此需要先安装 Docker。
⚠️ 注意：首次启动可能需要几分钟，等待'Docker Desktop is running'提示。
由于默认镜像源在国外，拉取镜像速度慢，建议配置国内镜像加速器。
操作步骤：
Settings → Docker Engineregistry-mirrors，例如使用中科大镜像加速：{
"registry-mirrors": [
"https://docker.mirrors.ustc.edu.cn",
"https://registry.docker-cn.com"
]
}
Apply & Restart 生效。默认情况下，Docker 所有镜像和容器数据都保存在 C 盘，长期使用容易占满。
操作步骤：
Settings → Resources → AdvancedDisk image location 到其他盘（如 D:\Docker）Apply & Restart⚠️ 此操作会迁移现有数据，可能耗时较长，请耐心等待。
用于克隆 Dify 项目源码。
git --version
输出示例：
git version 2.xx.x.windows.1
表示安装成功 ✅
打开命令行工具（推荐 PowerShell 或 Git Bash），执行：
git clone https://github.com/langgenius/dify.git
📁 默认会在当前目录创建
dify文件夹。
进入 Docker 配置目录：
cd dify/docker
复制示例环境变量文件为正式配置：
cp .env.example .env
💡 此文件包含数据库、API 密钥等关键配置，
.env.example是模板，.env是实际运行使用的文件。
打开 .env 文件（可用记事本或 VS Code 编辑），找到以下行：
# HTTP port
NGINX_PORT=80
# SSL settings are only applied when HTTPS_ENABLED is true
NGINX_SSL_PORT=443
EXPOSE_NGINX_PORT=80
EXPOSE_NGINX_SSL_PORT=443
如果你的 80 或 443 端口被占用（如 IIS、Apache、Nginx 等服务），建议修改对外暴露端口：
EXPOSE_NGINX_PORT=8080
EXPOSE_NGINX_SSL_PORT=8443
✅ 例如改为
8080，则后续通过http://localhost:8080访问 Dify。
确保你在 dify/docker 目录下，运行：
docker compose up -d
首次运行会自动：
启动成功后，终端输出类似 docker 运行状态信息。
docker ps
确保所有容器状态为 Up。
打开浏览器，输入：
http://localhost
或你修改过的端口，如：
http://localhost:8080
✅ 正常情况下第一次等待一会儿将看到 Dify 登录/注册页面，表示部署成功！
| 功能 | 命令 |
|---|---|
| 停止服务 | docker compose down |
| 重启服务 | docker compose restart |
| 查看日志 | docker compose logs 或 docker compose logs api |
| 删除容器和数据（重置） | docker compose down -v |
⚠️
-v会删除数据卷（包括数据库），慎用！
错误提示如：
(HTTP code 500) server error - Ports are not available: exposing port TCP 0.0.0.0:80 -> 127.0.0.1:0: listen tcp 0.0.0.0:80: bind: An attempt was made to access a socket in a way forbidden by its access permissions.
解决方法：
netstat -ano | findstr :80 查看占用进程.env 中的 EXPOSE_NGINX_PORT请确认已配置国内镜像源（见上文）。
尝试清理后重新拉取：
docker compose down -v
docker system prune -a --volumes
然后重新执行 docker compose up -d
通过以上步骤，你已经成功在本地 Windows 系统部署了 Dify，可用于开发、测试或学习 AI 应用构建。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online