> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cyberun.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 上传模型

> 为你的团队添加 checkpoint、LoRA、embedding 或 ControlNet。

本页讲解自定义模型的上传流程。关于概念概览见
[模型](/zh/cloud/concepts/models)。侧边栏必须出现 **模型** 入口 ——
如果没有，说明此部署在你的部署上未提供自定义模型。

## 开始之前

* 你要上传的本地文件。
* 一个你所属的团队。任何成员都可以上传。

## 上传

1. 打开侧边栏中的 **模型**。

2. 点击 **上传模型**。

3. 选择文件。

4. 填写元数据：

   | 字段  | 说明                                                                                               |
   | --- | ------------------------------------------------------------------------------------------------ |
   | 显示名 | 在参数选择器中显示的人类可读标签。最多 255 个字符。                                                                     |
   | 类型  | ComfyUI 模型子目录的名称 —— `checkpoints`、`loras`、`vae`、`controlnet`，… 自由字符串，最多 50 个字符；选择你的工作流所期望的目录。    |
   | 路径  | 必填。代理的 ComfyUI 模型目录内的相对路径（例如 `models/checkpoints/sdxl_base_1.0.safetensors`）。不能是绝对路径，也不能包含 `..`。 |

5. 点击 **上传**。控制台会上传文件并注册该记录；随后它会出现在列表中。

## 接下来会发生什么

文件会保存在平台存储中。每个标签集匹配且所在团队拥有该模型的代理
都会把它拉到本地缓存。代理在下载期间会上报
`syncing`。一旦缓存完成，该代理上的后续任务会重用本地副本。

你不需要把文件推到任何特定的机器上。

## 编辑或删除

从某个模型所在行：

* **编辑** —— 修改显示名、类型、路径或状态
  （`active` / `disabled`）。文件字节本身不会通过
  编辑替换；如需推送不同的字节请上传新的记录。
* **删除** —— 移除该记录。代理会保留本地的缓存文件
  直到自行驱逐；新加入的代理则不会再看到它。

## 批量删除

在列表中多选行，并使用批量操作栏。

## 故障排查

**上传成功但工作流找不到模型** —— 确认 **路径** 与
工作流参数所期望的相符。该路径正是代理相对其
ComfyUI 模型目录所看到的路径。

**代理一直停在 `syncing`** —— 代理在首次使用时正在下载该模型。
后续运行很快。

## 相关

* [模型](/zh/cloud/concepts/models) —— 概念。
* [自定义节点](/zh/cloud/guides/install-custom-nodes) —— 节点包采用相同模式。
* [工作流](/zh/cloud/concepts/workflows) —— 模型在哪里被引用。