∞ UnlimitCanvas 创作工作台
技术手册 / 云算力接入 / 用镜像创建实例

用镜像创建实例 🚧 筹备中

13-云算力接入 · 2026-10-12 · 3.9 KB
🚧 筹备中:本专题尚在筹备(内容仍在校对与补充 ⇒ 请以应用实际界面与平台控制台为准 ⚠)
"镜像"=一份预装好的系统盘快照。 引用现成镜像 = 省掉装环境、装节点、甚至装权重的全部麻烦 ✓
本文只写用户在平台上的操作(选什么、勾什么、抄什么),⛔ 不写镜像内部的构建与部署细节。
⚠ 平台界面与型号以控制台为准;文中实例地址/ID 一律用 <实例ID> 占位(真实地址只存在于你自己的控制台 ✓)。
⚠ 平台预期:本文操作基于「优云智算(CompShare)」—— 换平台时"镜像名 / 勾选项位置 / 地址形态"会不同(思路一样,照着找对应项 ✓)。

一、两条路线,先选一条

路线 A:社区镜像(推荐)路线 B:平台基础镜像
平台上选什么社区镜像里选 UnlimitCanvas(ComfyUI 配套镜像)基础镜像里选「ComfyUI 纯净版」
装环境不用(镜像里已完成)要自己装节点、配权重
启动服务自动起 ComfyUI(镜像内启动脚本)自己起
权重镜像内的校验工具会告诉你缺哪些并按档位补 ✓全部自己放
适合绝大多数人 ✓有经验、要完全自定义

⇒ 下面 §二 讲路线 A(主推),§三 给路线 B 的版本对照(只给"选什么",不给部署步骤)。


二、路线 A:用社区镜像开实例(逐步)

第 0 步:先进"创作者中心"确认镜像可用

平台右上角头像 → 创作者中心可以查看/管理镜像(发布者用);普通用户直接在部署实例页选"社区镜像"即可 ✓

第 1 步:部署实例 → 选镜像

在平台部署 GPU 实例页:

项选什么
镜像来源社区镜像
镜像UnlimitCanvas(名称含 comfyui-companion,即"ComfyUI 配套镜像")
镜像版本选最新(镜像自带版本号,越大越新)✓
这个镜像里已经装好:ComfyUI 本体(版本与手册口径一致)+ 启动脚本(开机自启)+ 权重校验工具 ✓

第 2 步:选区域与机型

项选什么为什么
区域上海二A(或华北一C)⚠ 必须与你的云存储同区,否则挂不上 ✗
实例类型容器只有容器能用平台的公共模型库 ✓
GPU32G RTX50 系、数量 1显存门槛见《规格·成本与必知》(≥24 GB 才稳)✓
CPU14C 64GB(能选就选,48GB 也可)编码/解码与预处理吃 CPU ✓
系统盘≥ 100 GB镜像体积 + 运行缓存都要地方 ✓

第 3 步:勾选与端口

部署表单里勾上:

  • ☑ 容器
  • ☑ 云存储 Pro(推荐:权重放这里才持久,实例删了也不丢 ✓)—— ⚠ 需要先建存储再建实例(见第 4 步)
  • ☑ 实例级端口配置
  • ☐ 独立 IP(一般不勾 ✓)
项值
应用端口8188 ✓ —— 镜像已声明 8188 ⇒ 平台会自动创建防火墙规则开放它 ✓
⚠ 如果平台没自动开:在实例的端口配置里手动加 8188 ✓

第 4 步:云存储(想持久就做)

  1. 先建文件系统:可用区选与实例同区 → 名称随意(例 uc-comfy-weights)→ 容量 200 GB(推荐) → 付费方式按月(包月欠费比包日宽容)✓
  2. 建实例时挂载它,挂载路径用 /cloud ✓
  3. 挂上后:权重放 /cloud/models/... ⇒ 以后换实例、重装镜像都不丢 ✓
⚠ 云盘内容不会进镜像;镜像里的内容也不会自动进云盘 —— 两者互相独立 ✓(所以"权重放云盘"是唯一稳妥做法)

第 5 步:开机,等它自己就绪

实例状态变成 Running 后:

  1. 首次启动会自动起 ComfyUI(镜像内的启动脚本)⇒ 等 1~3 分钟 ✓
  2. 首次启动会校验权重:缺哪些会明确告诉你(并按可用档位补齐或提示去补)⇒ 按提示做 ✓
  3. 服务就绪后,它会打印"要填进应用的地址"(见下面第 6 步)✓

第 6 步:★ 抄下三样(这一步做对,后面全通)

#抄什么从哪抄填到应用的哪里
①完整的自定义服务地址实例页「配置开放端口」里 8188 那一行的地址应用的 baseUrl(远程 ComfyUI)
②实例里 ComfyUI 的真实路径例 /root/ComfyUI(镜像会打印)应用的 「远端 input 目录」(= 该路径 + /input)
③实例 ID实例列表里那串 ID不用填,但报障/对账时要用 ✓

地址长什么样(两种形态,看你的平台/区域):


形态一(容器实例,常见):
  http://8188-<实例ID>-s1.pod.compshare.cn        ← 端口被"编进域名"(真实走 80),不带 token
形态二(另一种机型):
  https://<账号>-<实例ID>.xxx.example.com:8443     ← 带端口,可能还要带 token / 路径前缀

⚠ 两种形态的区别只有一句:地址那一栏整段照抄(含 :端口、含 token / 前缀),一个字符都别自己改 ✓


三、路线 B:用平台基础镜像(只给"选什么")

平台基础镜像 → ComfyUI 纯净版,版本组合按这张表选:

项选什么为什么
Ubuntu22.04平台标配
CUDA12.8RTX 50 系(Blackwell)的最低要求;⚠ 12.4 跑不起来 ✗;13.x 太新、第三方节点易编不过 ⚠
框架(ComfyUI 版本)与手册口径一致的那版(当前为 0.38.0)⚠ 版本不一致 ⇒ 模板会报"缺少节点类型" ✗(那是环境问题,不是模板错 ✓)
Python3.10(平台唯一选项)——
⚠ 选基础镜像意味着:节点、权重、启动方式都要你自己弄 ⇒ 若你不打算自己维护,请回到路线 A ✓
⚠ 版本一定要对齐:CUDA 12.8 + 框架 0.38.0 是"RTX50 能跑 + 模板节点齐"的组合 ✓

四、建完实例的自查(30 秒)

  • [ ] 实例状态 Running
  • [ ] 端口 8188 已开放(平台自动或手动)
  • [ ] 云存储已挂载在 /cloud(想持久的话)—— ⚠ 只是"有个同名目录"不算挂载(数据会写系统盘、随实例销毁 ✗)
  • [ ] 已抄下完整服务地址(含 token/前缀,原样)
  • [ ] 已抄下 ComfyUI 真实路径(用来填「远端 input 目录」)

⇒ 都打勾 ⇒ 去《在应用里连接云算力》填地址 ✓


五、这一篇最容易踩的三个错

错后果怎么避免
自己拼地址(只填 域名:端口,漏了 token / 前缀)所有请求 404,而且调度器静默跳过这台、不报错 ✗地址整段照抄 ✓
CUDA 版本太低(12.4)或框架版本不匹配RTX50 起不来 / 模板报"缺少节点类型"按 §三 的表选 ✓
以为 /cloud 挂上了,其实只是同名目录数据写系统盘,实例一销毁全丢且不报错 ✗建实例时勾选并挂载云存储 Pro ✓

来源:E:/workbuddyProj/unlimitCanvas/ai_manual/cloud_gpu/01-用镜像创建实例.md