Comfy Studio

部署

选一条适合你的路径

官网只讲路径与边界;具体命令以仓库 README 与 docs 为准。

全链路架构

点击节点查看职责 · 推理永不离开本机

Studio

登录、创作(文生图 / 改图 / 图生视频)、队列、画廊、展馆与提示词库。

安全红线:不要把 ComfyUI 8188 暴露到公网。

本机自用

适合单机创作:本机跑 ComfyUI + FastAPI,用 Studio 或直接调 API。

检查清单

  1. ComfyUI 已能用目标工作流出图
  2. 克隆仓库,创建虚拟环境并安装依赖
  3. 复制 .env.example → .env,至少设置 API_KEY
  4. 确认 llm_workflow/ 下工作流与 mapping 路径正确
  5. 运行 scripts/start_api.ps1,访问 /health/ready

要点

  • 推理在本机 GPU;无需 FRP / 公网域名
  • Gateway 可用来启停服务、管理用户与提示词库
  • 详细步骤见仓库 README

远程创作(FRP + Nginx)

适合把创作端放在另一台机器:公网只暴露 HTTPS 入口,本机 GPU 通过隧道接到云端。

检查清单

  1. 云主机:Nginx(HTTPS)+ frps
  2. 本机:ComfyUI + FastAPI + frpc(可用 Gateway 管理)
  3. Studio 填写公网 Base URL 与账号 / API Key
  4. 用 Studio「测试连接」确认链路

安全边界

禁止把 ComfyUI 8188 或 FastAPI 直接绑到公网 0.0.0.0 当「临时方便」。公网入口应是 Nginx HTTPS,隧道落到本机环回地址。

  • 上游润色 Key 只留服务端(POLISH_*)
  • 客户端密钥走主进程安全存储,不在渲染进程明文落盘
  • 部署模板见仓库 deploy/,长文见 docs/