InvokeAI 本地部署教程:从安装到首次出图的完整指南
【免费下载链接】InvokeAIInvoke is a leading creative engine for Stable Diffusion models, empowering professionals, artists, and enthusiasts to generate and create visual media using the latest AI-driven technologies. The solution offers an industry leading WebUI, and serves as the foundation for multiple commercial products.项目地址: https://gitcode.com/GitHub_Trending/in/InvokeAI
InvokeAI 是基于 Stable Diffusion、FLUX 等开源模型的本地 AI 图像生成引擎,提供 WebUI、节点工作流和统一画布。本文覆盖它的本地部署全过程:判断是否适合你、系统与显存门槛、用启动器完成安装启动、加载模型,以及首次出图和常见故障排查。
InvokeAI 是什么,适合谁
一句话定位:它把"装环境、下模型、跑图"整合进一个本地 Web 应用,你只需要装一次,剩下都在浏览器里完成。
它主要解决两类痛点。第一类是环境:依赖版本、CUDA、模型格式兼容这些坑由启动器统一处理;第二类是出图之后的二次创作:统一画布支持局部重绘、图层和刷笔修改,节点工作流让整条生成链路可以保存复用。
和同类工具对比:ComfyUI 纯节点,自由度最高但学习曲线陡;A1111 的 WebUI 上手简单但迭代慢。InvokeAI 取中间路线——默认给你一个开箱即用的生成面板,想深入时再切到节点和画布。适合想在本地可控地批量出图、精修图像的个人和小团队;如果你的诉求是调远程 API,它的强项并不在这里。
部署门槛:系统与显存够不够
InvokeAI 本地部署支持 Windows 10+、macOS 14+ 和 Linux(Ubuntu 20.04+ 验证最充分)。硬件按你打算跑的模型来选:
| 模型 | 最低配置 | 推荐配置 |
|---|---|---|
| SD1.5(512×512) | NVIDIA 10xx / 4GB 显存 / 8GB 内存 | NVIDIA 20xx / 6GB / 16GB |
| SDXL(1024×1024) | NVIDIA 20xx / 8GB 显存 / 16GB 内存 | NVIDIA 30xx / 12GB / 32GB |
| FLUX.1(1024×1024) | NVIDIA 20xx / 10GB 显存 / 32GB 内存 | NVIDIA 40xx / 16GB / 64GB |
显存略低的卡通常也能跑,只是更慢,可以后续开低显存模式优化。特殊平台的边界记一句话:Apple Silicon 全系可用但建议 16GB 统一内存以上,AMD 显卡仅支持 Linux,Intel Arc 支持 Windows 和 Linux,ARM64 Linux(如树莓派 5)只有 CPU 模式。完整要求见 系统要求文档。
用启动器完成安装
安装走官方启动器,它负责下载、更新和管理整个 InvokeAI 环境。三个平台各一步:Windows 直接运行下载到的 exe;macOS 把 dmg 里的应用拖进 Applications;Linux 给 AppImage 加上执行权限后运行。
启动后点Install,用默认路径即可。Python 3.12、torch 等依赖由启动器统一装好,总量约 500MB 到 2GB,视网速等待。已有旧安装的话,也可以选目录让启动器接管。
再点Launch,首次运行会要求选择 GPU:NVIDIA 卡选对应型号,AMD 选 ROCm(仅 Linux),只有集显就选 CPU 模式,能跑但很慢,不推荐。启动成功后浏览器自动打开 WebUI。
⚠️ Linux 用户注意:如果临时目录挂载为 tmpfs,先确认它空间足够,否则生成中途可能写爆磁盘。
想手动装或跑在服务器上
跳过图形界面的路线:用uv建虚拟环境(uv venv --python 3.12),再uv pip install invokeai(NVIDIA 20xx 及更老显卡改用invokeai[xformers]),最后执行invokeai-web --root 安装目录启动。无 GPU 的服务器同样能起,本地生成慢但可以接外部 API 模型。完整细节在 手动安装指南。
模型怎么装
首次启动会弹窗引导你进 Model Manager。最省事的是Starter Models标签页,里面是官方整理过的一揽子流行模型,勾选安装即可——新手装一个 SDXL 基模就够日常出图。
手里已有模型文件的话,用Scan Folder指向本地目录,扫出来后一键导入;不想挪文件就勾选 In-place install。也支持粘贴 URL 或 HuggingFace repo ID 直接下载,ckpt、safetensors、diffusers 三种格式都认。
提示:部分模型带非商用许可条款,上架到公网服务前自己确认授权。
更多安装方式见 模型文档。
第一次出图怎么做
在 txt2img 页做三件事:提示词填a photo of a cat wearing sunglasses, 4k, realistic,模型选刚装的 SDXL,点Generate。首张图要先加载模型,约 10–30 秒,之后 SDXL 在 1024×1024 下一张大约 10–30 秒(20xx 以上显卡)。
出图之后,两个参数最值得先摸:
- Steps(采样步数):20–30 步是质量和速度的平衡点,低于 15 步细节会明显变糙。
- 分辨率:每个模型有甜点位——SD1.5 在 512、SDXL 在 1024,偏离越多效果越差,别一上来就拉 2K。
画布(Canvas)用来把图拖进去做局部重绘、放大和刷笔修改,适合精修;工作流则可以把整条生成链路存成模板反复调用。
常见故障:显存不足、启动报错、下载慢 🔧
显存爆了(Out of memory):两条路。一是降分辨率,从 1024 降到 768 甚至 512;二是开低显存模式,让模型权重在 CPU 和 GPU 之间调度。Windows 上的 NVIDIA 卡还有个坑叫 sysmem fallback——显存写满后自动掉到系统内存,速度骤降,按低显存指南显式关掉它更稳。
启动失败:先看启动器输出和安装目录日志。最常见的是invokeai.yaml里有非法配置项触发ValidationError,报错会指出具体字段,删掉或改回默认值即可;依赖损坏可以执行uv cache clean后重装。
模型下载慢:换自己下。用浏览器或下载工具把文件拉好,再回 Model Manager 用 Scan Folder 导入,省得盯着进度条。
更多问题按 FAQ 逐条排查。
下一步建议:从 Starter Models 装一个 SDXL,跑一张 1024 的图,把 Steps 从 20 拉到 30 对比效果。卡住了先看 FAQ,再进项目 Discord 社区提问。
【免费下载链接】InvokeAIInvoke is a leading creative engine for Stable Diffusion models, empowering professionals, artists, and enthusiasts to generate and create visual media using the latest AI-driven technologies. The solution offers an industry leading WebUI, and serves as the foundation for multiple commercial products.项目地址: https://gitcode.com/GitHub_Trending/in/InvokeAI
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考