Easy Diffusion 保姆级部署教程：一键安装 Stable Diffusion，零基础也能在本机跑 AI 绘图

本文所有命令与配置均照搬 Easy Diffusion 官方仓库 README（github.com/easydiffusion/easydiffusion，main 分支）与官方 Wiki（github.com/easydiffusion/easydiffusion/wiki），未作任何改动与发挥。信息核验日期：2026-11-01。

一、项目介绍

Easy Diffusion 是一个"在自己电脑上安装和使用 Stable Diffusion"的桌面级开源工具，官方 README 副标题为"An easy way to install and use Stable Diffusion on your computer"。它的核心目标是零技术门槛：不需要预先安装任何软件、不需要配置 Python 环境，下载安装包后一键即可使用，同时保留了任务队列、ControlNet、SDXL、自定义模型等高级能力。

官方 README 介绍其已更新到 3.0/4.0 引擎，新增对 Flux 1/2、Z-Image、Ernie、Lumina、Anima 以及量化模型的支持。项目提供 Windows、Linux、macOS 三种安装包，由 cmdr2 与社区贡献者共同维护，配套 Discord 社区与官方 Wiki 故障排查指南。

二、功能拆解

按官方 README「Features」一节，核心能力如下：

三、官方/GitHub 链接

• GitHub 仓库：https://github.com/easydiffusion/easydiffusion
• 官方 Wiki（用户指南）：https://github.com/easydiffusion/easydiffusion/wiki
• 故障排查指南：https://github.com/easydiffusion/easydiffusion/wiki/Troubleshooting
• 如何使用：https://github.com/easydiffusion/easydiffusion/wiki/How-to-Use
• UI 插件列表：https://github.com/easydiffusion/easydiffusion/wiki/UI-Plugins
• Discord 社区：https://discord.com/invite/u9yhsFmEkB
• Releases 下载：https://github.com/easydiffusion/easydiffusion/releases/latest

四、环境要求

官方 README「Hardware requirements」一节原文：

• Windows：NVIDIA¹ 或 AMD 显卡（最低 2GB 显存），或使用 CPU 运行。
• Linux：NVIDIA¹ 或 AMD² 显卡（最低 2GB 显存），或使用 CPU 运行。
• Mac：M1/M2/M3/M4 或 AMD 显卡（Intel Mac），或使用 CPU 运行。
• 系统内存：最低 8 GB。
• 磁盘空间：至少 25 GB。
• ¹ NVIDIA 需 CUDA Compute capability 3.7 或更高。
• ² AMD Linux 需 ROCm 5.2 或更新。

官方强调："The installer will take care of whatever is needed."——安装包会自动装好所需一切，不需要预装 Python 或 Conda。

五、部署步骤

方式 A：Windows 安装（官方 README「On Windows」）

步骤 1：下载安装包

点击官方 README 中的 Windows 下载按钮，即 https://github.com/easydiffusion/easydiffusion/releases/latest/download/Easy-Diffusion-Windows.exe 。

步骤 2：运行安装程序

运行下载的 Easy-Diffusion-Windows.exe 文件

逐段解释：官方原文"Run the downloaded Easy-Diffusion-Windows.exe file."。若 Windows SmartScreen 阻止运行，点击 More info 后选择 Run anyway（官方原文）。

步骤 3：启动

安装完成后运行 Easy Diffusion；也可从开始菜单或桌面快捷方式启动。

官方提示（Windows 10）："On Windows 10, please install at the top level in your drive, e.g. C:\EasyDiffusion or D:\EasyDiffusion. This will avoid a common problem with Windows 10 (file path length limits)."——务必装在盘符根目录下短路径，避免 Windows 10 路径长度限制。

方式 B：Linux / macOS 安装（官方 README「On Linux/Mac」）

步骤 1：下载并解压

从官方 README 下载按钮获取：
- Linux：https://github.com/easydiffusion/easydiffusion/releases/latest/download/Easy-Diffusion-Linux.zip
- Mac：https://github.com/easydiffusion/easydiffusion/releases/latest/download/Easy-Diffusion-Mac.zip

官方原文："Unzip/extract the folder easy-diffusion which should be in your downloads folder, unless you changed your default downloads destination."

步骤 2：打开终端并进入目录

cd easy-diffusion

逐段解释：把下载解压得到的 easy-diffusion 目录（默认在 ~/Downloads 下）用 cd 进入；后续启动脚本就在该目录内。

步骤 3：启动

./start.sh

或官方给出的等价写法：

bash start.sh

逐段解释：start.sh 是官方启动脚本，首次运行会自动下载并安装 Stable Diffusion 运行时（Conda 环境、模型权重等），并在本地起 Web 界面。

执行成功后预期输出参考： 终端打印安装与启动日志，最终提示在浏览器打开本地 Easy Diffusion 界面（首次启动需等待较长时间下载依赖与模型）。

六、配置参数详解

Easy Diffusion 以"零配置"为目标，绝大多数参数在 Web UI 内调整。官方 README 中明确提到的可配置项：

官方未在 README 中给出端口号、环境变量清单或配置文件路径；如需修改监听端口等高级项，请参考官方 Wiki（github.com/easydiffusion/easydiffusion/wiki）与 Troubleshooting 页。

七、启动与运维

• 启动：Windows 双击快捷方式；Linux/Mac 在 easy-diffusion 目录执行 ./start.sh。
• 停止：关闭 Easy Diffusion 主窗口，或在运行 start.sh 的终端按 Ctrl+C。
• 后台常驻 / 开机自启：官方 README 未提供后台常驻或开机自启方式。
• 自动更新：官方 Features 内置"Auto-updater"——"Gets you the latest improvements and bug-fixes"，由程序自身在启动时检查并升级。
• 数据持久化：所有下载的包、模型与生成图均保存在 EasyDiffusion 目录内（官方卸载说明反推："Just delete the EasyDiffusion folder to uninstall all the downloaded packages."）。
• 卸载：官方原文"To remove/uninstall: Just delete the EasyDiffusion folder to uninstall all the downloaded packages."——直接删除整个 EasyDiffusion 文件夹即可。

八、实操验证

1. 启动后，按官方 README 引导在浏览器打开 Easy Diffusion 本地界面（首次启动需等待安装包自动下载依赖与基础模型）。
2. 在 prompt 框输入一句英文提示词，例如 a photo of an astronaut riding a horse。
3. 保持默认采样器与步数，点击生成按钮。
4. 按官方 README 性能数据："Creates a 512x512 image with euler_a in 5 seconds, on an NVIDIA 3060 12GB"——数秒后界面出现生成图。
5. 验证任务队列：连续输入多句 prompt 排队，观察队列依次执行。
6. 验证自定义模型：下载一个 .safetensors 文件放入 models/stable-diffusion/ 目录，回到 UI 模型下拉应能看到新模型。
7. 验证图片保存：官方 Features"Save generated images to disk"——生成图自动保存在 EasyDiffusion 目录内的输出目录中。

九、故障排查

案例 1：Windows SmartScreen 阻止运行

• 报错原文（系统弹窗）：Windows protected your PC。
• 报错原因：官方 README 明确——未签名的开源 exe 首次运行会触发 SmartScreen。
• 分步解决：按官方原文点击 More info，再点击 Run anyway。

案例 2：Windows 10 报路径过长 / 安装失败

• 报错现象：解压或安装过程中出现文件路径过长相关错误。
• 报错原因：官方 Windows 10 提示——未装在盘符根目录短路径。
• 分步解决：按官方建议改装到 C:\EasyDiffusion 或 D:\EasyDiffusion 这种顶层短路径后重新运行。

案例 3：Linux/Mac 下 ./start.sh 无执行权限

• 报错原文（常见形式）：bash: ./start.sh: Permission denied。
• 报错原因：解压后脚本未带可执行位。
• 分步解决：官方 README 给出的等价写法——改用 bash start.sh 直接以 bash 解释器运行，无需 chmod。

案例 4：GPU 显存不足 / 想要使用 CPU 模式

• 报错现象：生成时报 CUDA OOM，或机器无兼容显卡。
• 报错原因：官方 Features 列出"Use CPU setting: If you don't have a compatible graphics card, but still want to run it on your CPU"——默认走 GPU，可在 UI 设置中切换。
• 分步解决：在 Easy Diffusion UI 设置中选择 CPU 模式（官方 Features 原文）；或参考官方 Troubleshooting Wiki：https://github.com/easydiffusion/easydiffusion/wiki/Troubleshooting 。

十、升级、回滚与卸载

升级： 官方内置 Auto-updater（Features 原文），启动时自动拉取最新改进与修复；无需手动命令。

回滚： 官方未提供一键回滚命令；如需回退，可在 Releases 页（https://github.com/easydiffusion/easydiffusion/releases ）下载历史版本安装包重新安装（注意备份 EasyDiffusion 目录下已下载模型与生成图）。

卸载： 官方原文——"Just delete the EasyDiffusion folder to uninstall all the downloaded packages." 即删除整个 EasyDiffusion 文件夹即可。

十一、商用许可合规说明

• 许可证：采用基于 CreativeML Open RAIL-M 的自定义许可证（官方 LICENSE 文件标题"License"，Copyright (c) 2022 cmdr2 and contributors；正文明确"subject to the ... 'CreativeML Open RAIL-M' license accompanying this License"）。
• LICENSE Section I 授予自由使用、复制、修改、合并、发布、分发、再许可与销售的权利，但须满足：① 保留版权声明与许可文本；② 遵守 Section II 的 Use-based restrictions。
• LICENSE Section II 与官方 README Disclaimer 明确：使用者仅可为合法目的使用，不得分享任何"违反法律、对他人造成伤害、传播用于伤害的个人信息、传播错误信息、针对弱势群体"的内容（README 原文列出的五项禁止）。
• 商用前请完整阅读 LICENSE 全文与 Open RAIL-M 使用限制；生成内容的责任由用户自行承担（官方 Disclaimer："The authors of this project are not responsible for any content generated using this interface."）。