跳转至

使用公共模型

如果您是应用创作者：让您可以方便的制作镜像，不再因为模型占用体积大和下载速度慢困扰；
如果您是使用应用的用户：如果有其他用户已经上传您需要的模型，那么您也可以直接在公共模型中找到来使用。

ComfyUI 模型软链接使用

什么是软链接？

软链接是 Linux/Unix 系统中的一种特殊文件，它指向另一个文件或目录。类似于 Windows 系统中的快捷方式。

怎么在 ComfyUI 中使用软链接？

我们只要在 ComfyUI 的模型目录创建好软链接快捷方式，ComfyUI 则可以直接使用该模型

mkdir -p <创建要放的目标目录>
ln -s <自己上传或者从公共模型库获得的链接> <要放的目标目录>

示例：

需将 flux1-dev-fp8.safetensors 放在该目录 /root/ComfyUI/models/checkpoints/

然后当我上传或者从公共模型库可以搜索到 flux1-dev-fp8.safetensors 对应的原始文件路径是/.autodl/23/73/8c/23738c26b548113ea2d392abd91d3fd0，那么我们就可以直接在终端运行这个命令：

mkdir -p /root/ComfyUI/models/checkpoints/
ln -s /.autodl/23/73/8c/23738c26b548113ea2d392abd91d3fd0 /root/ComfyUI/models/checkpoints/flux1-dev-fp8.safetensors

然后你就可以看到 /root/ComfyUI/models/checkpoints/flux1-dev-fp8.safetensors 文件存在，但是占用很少的空间。

Flux 模型软链接配置示例

Flux 模型在 ComfyUI 中分布在多个目录，下面以 Flux 为例展示如何配置软链接。

1. Checkpoints（检查点模型）

目录： /root/ComfyUI/models/checkpoints

Flux 模型示例：

# 创建目录（如果不存在）
mkdir -p /root/ComfyUI/models/checkpoints

# Flux.1-dev FP8 版本
ln -s /.autodl/23/73/8c/23738c26b548113ea2d392abd91d3fd0 /root/ComfyUI/models/checkpoints/flux1-dev-fp8.safetensors

# Flux.1-dev 无文本版本
ln -s /.autodl/e3/a1/73/e3a173071931d69f3611a4e8d52d07f5 /root/ComfyUI/models/checkpoints/flux1-knotext-dev_fp8_e4m3fn.safetensors

说明：

  • flux1-dev-fp8.safetensors：标准 Flux.1-dev 模型（FP8 量化版本）
  • flux1-knotext-dev_fp8_e4m3fn.safetensors：无文本编码器版本，适合不需要文本输入的场景

2. Diffusion Models（扩散模型，之前用unet模型的也放在这目录里面即可）

目录： /root/ComfyUI/models/diffusion_models

NUNCHAKU 版 Flux 相关模型示例：

# 创建目录
mkdir -p /root/ComfyUI/models/diffusion_models

# Flux.1-dev Kontext 缩放版本
ln -s /.autodl/94/57/42/945742dcc89ab1c9d617e77d51c29c7a /root/ComfyUI/models/diffusion_models/flux1-dev-kontext_fp8_scaled.safetensors

# Flux.1-dev Krea 缩放版本
ln -s /.autodl/6f/5b/e3/6f5be396c15608c4e1e6992f10a9c6a2 /root/ComfyUI/models/diffusion_models/flux1-krea-dev_fp8_scaled.safetensors

3. ControlNet（控制网络）

目录： /root/ComfyUI/models/controlnet

Flux ControlNet 示例：

# 创建目录
mkdir -p /root/ComfyUI/models/controlnet

# FLUX.1-dev ControlNet Union Pro 2.0
ln -s /.autodl/9c/46/6d/9c466ddc75c10f28d7f89f0c41caa44e /root/ComfyUI/models/controlnet/FLUX.1-dev-ControlNet-Union-Pro-2.0.safetensors

目录： /root/ComfyUI/models/xlabs/controlnets

Flux ControlNet v3 系列：

# 创建目录
mkdir -p /root/ComfyUI/models/xlabs/controlnets

# Canny 边缘检测 ControlNet
ln -s /.autodl/ac/10/ca/ac10ca3285ce6e53f32733afdc975856 /root/ComfyUI/models/xlabs/controlnets/flux-canny-controlnet-v3.safetensors

# Depth 深度图 ControlNet
ln -s /.autodl/ce/2c/15/ce2c152b34e7c7731c3f6464df505a4b /root/ComfyUI/models/xlabs/controlnets/flux-depth-controlnet-v3.safetensors

# HED 边缘检测 ControlNet
ln -s /.autodl/14/ff/ed/14ffed15f7be1294e756b4834eae8403 /root/ComfyUI/models/xlabs/controlnets/flux-hed-controlnet-v3.safetensors

4. LoRA（低秩适应模型）

目录： /root/ComfyUI/models/loras

Flux LoRA 示例：

# 创建目录
mkdir -p /root/ComfyUI/models/loras

# Flux.1 Turbo Alpha LoRA
ln -s /.autodl/67/6a/6d/676a6d9ee21a28e661358e830b46bb20 /root/ComfyUI/models/loras/flux.1-turbo-alpha.safetensors

5. Text Encoders（文本编码器）

目录： /root/ComfyUI/models/text_encoders

Flux 文本编码器示例：

# 创建目录
mkdir -p /root/ComfyUI/models/text_encoders

# Flux.1 T5XXL 文本编码器（AWQ INT4 量化版本）
ln -s /.autodl/25/bc/60/25bc60531e95fff51850dd3f62e4a000 /root/ComfyUI/models/text_encoders/awq-int4-flux.1-t5xxl.safetensors

完整配置脚本示例

以下是一个完整的 Flux 模型配置脚本，可以一次性创建所有必要的软链接：

#!/bin/bash

# ComfyUI Flux 模型软链接配置脚本

# 1. Checkpoints
mkdir -p /root/ComfyUI/models/checkpoints
ln -s /.autodl/23/73/8c/23738c26b548113ea2d392abd91d3fd0 /root/ComfyUI/models/checkpoints/flux1-dev-fp8.safetensors
ln -s /.autodl/e3/a1/73/e3a173071931d69f3611a4e8d52d07f5 /root/ComfyUI/models/checkpoints/flux1-knotext-dev_fp8_e4m3fn.safetensors

# 2. Diffusion Models
mkdir -p /root/ComfyUI/models/diffusion_models
ln -s /.autodl/0b/4e/c9/0b4ec9158f141bc73a3e697147c1affa /root/ComfyUI/models/diffusion_models/svdq-fp4_r32-flux.1-dev.safetensors
ln -s /.autodl/fa/ab/2e/faab2e54c84fb3bcc3da70a49c767bb5 /root/ComfyUI/models/diffusion_models/svdq-fp4_r32-flux.1-kontext-dev.safetensors
ln -s /.autodl/6d/64/29/6d642975c3832fb01616d259e7150e6a /root/ComfyUI/models/diffusion_models/svdq-fp4_r32-flux.1-krea-dev.safetensors
ln -s /.autodl/1a/50/45/1a5045c90162d94b9f1681cd24102411 /root/ComfyUI/models/diffusion_models/svdq-fp4_r32-flux.1-fill-dev.safetensors
ln -s /.autodl/c5/b2/db/c5b2db29714fb1d6d3b55cdb3173a8f2 /root/ComfyUI/models/diffusion_models/flux1-fill-dev-fp8.safetensors
ln -s /.autodl/94/57/42/945742dcc89ab1c9d617e77d51c29c7a /root/ComfyUI/models/diffusion_models/flux1-dev-kontext_fp8_scaled.safetensors
ln -s /.autodl/6f/5b/e3/6f5be396c15608c4e1e6992f10a9c6a2 /root/ComfyUI/models/diffusion_models/flux1-krea-dev_fp8_scaled.safetensors
ln -s /.autodl/81/c9/d2/81c9d2059e57c8a4df4c0fc34699e402 /root/ComfyUI/models/diffusion_models/flux1-dev2pro.safetensors
ln -s /.autodl/fc/0e/92/fc0e920817971213e74f0adb63fe83e0 /root/ComfyUI/models/diffusion_models/flux1-dev.sft

# 3. ControlNet
mkdir -p /root/ComfyUI/models/controlnet
ln -s /.autodl/9c/46/6d/9c466ddc75c10f28d7f89f0c41caa44e /root/ComfyUI/models/controlnet/FLUX.1-dev-ControlNet-Union-Pro-2.0.safetensors

# 4. XLabs ControlNets
mkdir -p /root/ComfyUI/models/xlabs/controlnets
ln -s /.autodl/ac/10/ca/ac10ca3285ce6e53f32733afdc975856 /root/ComfyUI/models/xlabs/controlnets/flux-canny-controlnet-v3.safetensors
ln -s /.autodl/ce/2c/15/ce2c152b34e7c7731c3f6464df505a4b /root/ComfyUI/models/xlabs/controlnets/flux-depth-controlnet-v3.safetensors
ln -s /.autodl/14/ff/ed/14ffed15f7be1294e756b4834eae8403 /root/ComfyUI/models/xlabs/controlnets/flux-hed-controlnet-v3.safetensors

# 5. LoRA
mkdir -p /root/ComfyUI/models/loras
ln -s /.autodl/67/6a/6d/676a6d9ee21a28e661358e830b46bb20 /root/ComfyUI/models/loras/flux.1-turbo-alpha.safetensors

# 6. Text Encoders
mkdir -p /root/ComfyUI/models/text_encoders
ln -s /.autodl/25/bc/60/25bc60531e95fff51850dd3f62e4a000 /root/ComfyUI/models/text_encoders/awq-int4-flux.1-t5xxl.safetensors

echo "Flux 模型软链接配置完成！"

常见问题解决

1. 软链接创建失败：文件已存在

错误信息：

ln: failed to create symbolic link '/root/ComfyUI/models/checkpoints/flux1-dev-fp8.safetensors': File exists

解决方案：

选项 A：删除现有文件/链接后重新创建

rm /root/ComfyUI/models/checkpoints/flux1-dev-fp8.safetensors
ln -s /.autodl/23/73/8c/23738c26b548113ea2d392abd91d3fd0 /root/ComfyUI/models/checkpoints/flux1-dev-fp8.safetensors

选项 B：强制创建（覆盖现有链接）

ln -sf /.autodl/23/73/8c/23738c26b548113ea2d392abd91d3fd0 /root/ComfyUI/models/checkpoints/flux1-dev-fp8.safetensors

注意： 使用 -f 参数会覆盖现有文件，请谨慎使用！

2. 软链接指向的文件不存在

错误信息：

ls: cannot access '/root/ComfyUI/models/checkpoints/flux1-dev-fp8.safetensors': No such file or directory

检查步骤：

  1. 检查源文件是否存在
ls -lh /.autodl/23/73/8c/23738c26b548113ea2d392abd91d3fd0
  1. 如果源文件不存在，需要先下载模型
# 检查 autodl 目录结构
ls -la /.autodl/ | grep flux
  1. 如果路径错误，删除旧链接并重新创建
rm /root/ComfyUI/models/checkpoints/flux1-dev-fp8.safetensors
# 使用正确的源路径重新创建
ln -s <正确的源路径> /root/ComfyUI/models/checkpoints/flux1-dev-fp8.safetensors

3. 批量删除软链接

如果需要删除某个目录下的所有软链接：

# 方法1：删除特定目录下的所有软链接
find /root/ComfyUI/models/checkpoints/ -type l -name "*flux*" -delete

# 方法2：删除所有软链接（谨慎使用）
find /root/ComfyUI/models/checkpoints/ -type l -delete

# 方法3：手动删除
rm /root/ComfyUI/models/checkpoints/flux1-dev-fp8.safetensors