技术手册 /
ComfyUI 本地部署 /
ComfyUI 本地部署 · 快速开始（绿色包）
ComfyUI 本地部署 · 快速开始（绿色包）
12-ComfyUI 本地部署 · 2026-10-12 · 3.8 KB
面向拿到「UnlimitCanvas 本地 ComfyUI 绿色包」（网盘下载）的用户：从解压到跑通第一个本地模板的完整路径。
⛔ 不需要命令行基础，照着点即可。
版本：comfyuiPackage 0.38.0 —— 包根目录的版本清单与包内 ComfyUI 本体都是 0.38.0（一致 ✓）
⚠ 版本会随包更新 ⇒ 以你包内那份版本清单 / 启动器显示为准 ✓（本页快照 2026-10-12）
⚠ 本专题手工维护；唯一由脚本生成的是 02-模型依赖总表.md（表头已注明 ✓）。
一、包里有什么（先认识它）
| 目录 / 文件 | 是什么 |
|---|---|
ComfyUI\ | ComfyUI 本体，已预装 80+ 个自定义节点（nunchaku / LTXVideo / GGUF / IPAdapter-plus / ReActor / Seed-VC / Qwen3-TTS / VoxCPM / Bernini / MSR / 万象 等） |
python_embeded\ | 便携版 Python —— 免装环境，这就是"绿色"的意思 ✓ |
UnlimitCanvas启动器\ | 启动器（UnlimitCanvasLauncher.exe）：检测环境 / 检查缺失权重 / 启动 ComfyUI；可自动更新（旧版备份在 data\launcher-backups\）✓ |
ComfyUI\models\ | 模型（权重）目录，下分 46 个分类子目录 ⇒ 权重必须放对分类 ✓ |
tools\ | ffmpeg / ffprobe（视频处理用，随包自带） |
data\ | 启动器的状态数据（模型清单 / 缺失检测 / 校验报告），不要手改 ✓ |
run_nvidia_gpu.bat | NVIDIA 显卡启动脚本（另有 run_cpu.bat 纯 CPU、run_nvidia_gpu_fast_fp16_accumulation.bat 加速版） |
二、下载与解压（三步）
- 从网盘下载压缩包（⚠ 大：权重全量在 400 GB 量级，见 §六；建议用网盘客户端，并保留压缩包以便日后比对完整性）
- 解压到空间充足的非系统盘，路径尽量纯英文、层级要浅（例如
D:\ComfyUI_Unlimit_Canvas）
⛔ 不要放在桌面 / 含中文 / 含空格的深层路径 —— 这是新手最常见的一个坑 ✗
- 解压完成后，先别删压缩包 ✓
三、先把 ComfyUI 跑起来（不依赖应用）
- 双击包内
run_nvidia_gpu.bat（N 卡）；或先开UnlimitCanvas启动器\UnlimitCanvasLauncher.exe（带检测界面 —— 新手更推荐，它会告诉你缺什么 ✓） - 等控制台出现
Starting server/To see the GUI go to: http://127.0.0.1:8188⇒ 服务起来了 ✓ - 用浏览器打开
http://127.0.0.1:8188，能看到 ComfyUI 界面 ⇒ 本体没问题 ✓
⚠ 首次启动会加载/编译 80+ 节点，等 1~3 分钟是正常的，别重复双击 ✓
四、在 UnlimitCanvas 里接上它（关键一步）
打开应用 → 设置 → 本地 ComfyUI：
| 项 | 怎么填 |
|---|---|
| 启动文件 | 点选择 → 选包里的 run_nvidia_gpu.bat ⇒ 应用会自动推导根目录 ✓ |
| ComfyUI 根目录 | 一般自动填好（就是包根目录）；不对可手改 |
| 端口 | 默认 8188（与包一致）⇒ 若你改过端口，两边都要改 |
| 状态 / 测试连接 | 卡片上显示进程与联通状态；点「测试连接」应为连通 ✓ |
然后点「引擎自检」：检查 服务 / 版本 / 节点是否齐 / 插件依赖 ⇒ 有红项按提示处理 ✓
已经自己开着 ComfyUI 也行：只要端口通，应用能自动识别 ✓
五、跑通第一个本地模板（按这个顺序，别乱点）
⚠ 先挑"权重已就位"的模板，不要一上来跑最重的模型：
- 新建/打开一张画布 → 从模板库选 Z-Image 文生图（
zimage.t2i）
（它所需权重较少，且多数随包已就位：z_image_turbo_bf16 / qwen_3_4b / ae 等；个别 LoRA/量化件可能要补 ✓）
- 写一句提示词 → 运行
- 看任务区：排队 → 运行 → 完成；产物会自动进入本地资产库 ✓
- 跑不通、报"找不到模型" ⇒ 说明权重没齐/没放对 ⇒ 见 §六 +
01-模型依赖与目录规范.md - 怎么知道某个模板缺哪些 ⇒ 查
02-模型依赖总表.md（按模板查），或用启动器的缺失检测 ✓
六、权重（模型）怎么补齐 —— 三种途径
| 途径 | 做法 | 适合 |
|---|---|---|
| 网盘增量包（推荐） | 按需下载"常用权重包"，解压覆盖到 ComfyUI\models\ | 大多数人 |
| 启动器检测 + 手动放 | 跑启动器看缺失清单 → 自己去来源下载 → 放进对应分类目录 | 只想跑特定模板 |
| 复用已有 ComfyUI 的权重 | 用 extra_model_paths.yaml 指向你已有的 models（包内给了 .example 模板，改名即生效） | 老 ComfyUI 用户 |
⚠ 两条铁律：
- 必须放对分类目录（放错＝等于没放）⇒ 逐条对照
01-模型依赖与目录规范.md✓ - 看到
.part后缀 ⇒ 那是没下完的文件 ⇒ 重新下载/补下，别硬跑 ✗
七、常见问题（对号入座）
| 现象 | 原因 | 处置 |
|---|---|---|
| 应用里「测试连接」不通 | ComfyUI 没起来 / 端口不一致 / 防火墙拦截 | 先浏览器试 http://127.0.0.1:8188；对不上就改端口（两边一致） |
AI 工具报本地引擎不可用（comfyui:false） | 同上 —— 健康判据就是"能访问 ComfyUI 的 /system_stats" | 先把本体跑起来 ✓ |
| 双击脚本闪退 | 路径含中文/空格；杀软拦截；缺运行库 | 换纯英文短路径；加杀软白名单；补装运行库 |
| 卡在加载节点很久 | 首次加载/编译节点（正常） | 等 1~3 分钟，⛔ 别重复启动 |
| 任务报「找不到模型 xxx」 | 权重缺失 / 放错目录 / 没下完（.part） | 对照 02-模型依赖总表.md 放对目录 ✓ |
| 爆显存 / 跑到一半失败 | 模型档位超出显卡能力 | 换低显存档（见 03-排错与维护.md），或换更轻的模型 |
| 端口 8188 被占用 | 已有别的 ComfyUI 或程序在用 | 换端口（包与应用两边同步改） |
| 想和旧 ComfyUI 共用权重 | —— | 用 extra_model_paths.yaml（见 §六 途径三） |
八、本专题导航
| 篇 | 讲什么 |
|---|---|
00-快速开始（绿色包）.md | 本文：解压 → 启动 → 在应用里接上 → 跑通第一个模板 |
01-模型依赖与目录规范.md | models\ 分类目录怎么放 · 字段↔目录映射 · 最容易放错的几类 |
02-模型依赖总表.md | 逐模板的必需权重清单（⚙ 表格由脚本生成，随时可重跑） |
03-排错与维护.md | 启动/连接/显存/更新/共享权重 的进阶处理 |
04-局域网算力集群.md | 把自己另一台机器也拉进算力池：★ 不加预算 · 免 token · inputDirectory 必填 · ⭐ 走本地模板库 · 无卡会被排除出调度 · 怎么登记与验证 · ⚠ 四条边界 |
来源：E:/workbuddyProj/unlimitCanvas/ai_manual/comfyui_local/00-快速开始（绿色包）.md