主题
JupyterLab
JupyterLab 是内置于 ComfyCarry 中的网页文件管理与开发环境。你可以在浏览器中直接浏览实例目录、将本地模型与素材拖拽上传至 ComfyUI 对应目录、下载生成产物,或通过网页终端执行常用命令,无需在本地电脑配置额外的终端工具。

打开 JupyterLab
可以通过以下方式进入 JupyterLab:
- 快捷打开:已启用 Cloudflare Tunnel 时,点击页面顶部标题旁的 打开 JupyterLab(或 图标),将在新标签页中打开已自动完成登录的 JupyterLab 界面。
- 复制访问令牌(Access Token):在 访问令牌 卡片中点击复制按钮,在需要手动登录的浏览器或设备中粘贴作为访问凭证。
- 本地直连:本地 Docker 或已映射端口的实例,直接在浏览器中打开对应地址,在提示输入 Token 时粘贴卡片中的访问令牌。
查看运行指标与内核
运行概览卡片展示 JupyterLab 服务的运行状态与资源占用:
- 基础信息:显示当前版本号、进程编号以及运行端口。
- 系统资源:实时显示 Jupyter 进程占用的 CPU 使用率与内存大小。
- 可用内核:列出当前环境中支持的代码执行环境(例如
Python 3 (ipykernel)),带有勾选标记的为默认内核。
在 JupyterLab 中打开了 Notebook 或交互窗口时,页面会进一步显示:
- 活跃内核:显示当前正在运行的代码内核名称、运行状态(空闲 或 忙碌)与连接数。支持点击暂停按钮中断耗时计算,或点击重启按钮重置内核。
- 活跃会话:列出已打开的文件与会话类型,支持直接关闭不再使用的会话以释放系统内存。
管理网页终端
网页终端允许你在浏览器中直接使用命令行,适合快速执行环境检查或轻量维护:
- 在 终端 区域点击 新建终端 卡片。
- 点击列表中生成的终端名称,即可在新标签页打开命令行窗口,执行系统命令或查看运行状态。
- 终端使用完毕后,点击卡片右侧的删除图标即可关闭该终端。
上传模型与管理文件
JupyterLab 默认打开工作目录 /workspace,包含了 ComfyUI 的核心文件与模型路径:
- 模型存放路径:在左侧文件树中展开
ComfyUI/models/文件夹,按照模型类型存入对应子目录:- 基础模型放入
checkpoints/ - LoRA 模型放入
loras/ - VAE 文件放入
vae/ - ControlNet 模型放入
controlnet/ - 嵌入式词向量放入
embeddings/
- 基础模型放入
- 上传本地文件:直接从电脑文件管理器中将模型文件(如
.safetensors)拖拽到左侧目录树的目标文件夹中,等待上传完成。 - 下载生成结果:在左侧目录树中打开
ComfyUI/output/目录,找到需要保存的图片或视频文件,右键选择 Download 保存到本地电脑。
进程控制与运行日志
- 启动 / 停止 / 重启:通过页面右上角的按钮可以控制 JupyterLab 服务的运行状态。修改依赖环境或服务无响应时,点击 重启 重新加载。
- 运行日志:实时显示 JupyterLab 服务的启动信息、访问请求与运行记录。