ComfyUI 模型下载加速：ComfyUI-Manager 接入 aria2 完整指南

ComfyUI 模型下载加速ComfyUI-Manager 接入 aria2 完整指南【免费下载链接】ComfyUI-ManagerComfyUI-Manager is an extension designed to enhance the usability of ComfyUI. It offers management functions to install, remove, disable, and enable various custom nodes of ComfyUI. Furthermore, this extension provides a hub feature and convenience functions to access a wide range of information within ComfyUI.项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager一次 5GB 的 LoRA 集合下载用默认方式跑起来往往要等上几十分钟中途断一次就得从头再来。ComfyUI-Manager 内置了一个下载加速通道只要本机有一个开启 RPC 接口的 aria2 实例它就能接管 ComfyUI 模型下载用多线程分片和断点续传来缩短等待。结论先行接入后能得到什么启用 aria2 通道后ComfyUI-Manager 的模型下载会从单连接请求切换为多连接并行拉取实际提速幅度因带宽与源站限制而异一般网络环境下 GB 级文件的耗时可从几十分钟降到原来的几分之一。除速度外还有两个实打实的收益中断后不用从零开始以及下载全程能看到每秒刷新的进度条。一眼判断是否生效的办法只有一个下载时看 ComfyUI 终端。进度条每秒跳动、速度数值持续刷新就是 aria2 通道在工作如果长时间无反应、只有文件在慢慢变大说明走的仍是默认下载路径。原理一句话分片并行 任务复用aria2 是一个独立的多线程下载程序这里把它当作一个后台下载服务使用。ComfyUI-Manager 本身不直接操作文件而是通过 RPC远程过程调用可以理解成通过网络喊一声、让对方干活的接口把下载任务交给它。整个机制可以拆成三点分片并行aria2 把一个文件切成多个区间用多条连接同时拉取尽量把带宽用满任务复用同一个文件如果已有下载任务Manager 会直接复用而不是重复建任务这是续传的基础进度轮询Manager 每秒向 aria2 询问一次任务状态据此刷新终端进度条。判断逻辑写在 glob/manager_downloader.py 里模块加载时检查环境变量一旦检测到 aria2 服务地址所有模型下载就改走 aria2 分支否则回退到原有方式。也就是说切换是全自动的不需要在界面上做任何操作。最小配置路径从安装到验证安装并启动 aria2 下载服务Linuxsudo apt-get install aria2 -y aria2c --enable-rpc --rpc-listen-all --rpc-allow-origin-all --rpc-secret你的密钥第二条命令启动 RPC 接口你的密钥换成自己随手定的字符串。执行后终端持续滚动日志即为服务就绪保持窗口不关。CentOS/RHEL 把apt-get换成yum即可。macOSbrew install aria2 aria2c --enable-rpc --rpc-listen-all --rpc-allow-origin-all --rpc-secret你的密钥Homebrew 会先装好程序再执行启动命令日志持续输出即正常。Windows从 aria2 官网下载 Windows 版本并解压在解压目录里打开命令行执行aria2c --enable-rpc --rpc-listen-all --rpc-allow-origin-all --rpc-secret你的密钥窗口不关闭、持续显示接收日志即代表服务存活。注意--rpc-secret相当于这个服务的钥匙务必加上否则同网段的其他设备也能借用你的下载服务。不想装在主机上可以用容器跑docs/en/use_aria2.md 提供了一份现成的 docker-compose 示例把其中RPC_SECRET改成自己的值、启动容器后 6800 端口开始监听就算成功。让 ComfyUI-Manager 识别加速服务只需要两个环境变量一个告诉 Manager 服务在哪一个提供密钥。在启动 ComfyUI 的那个终端里执行export COMFYUI_MANAGER_ARIA2_SERVERhttp://127.0.0.1:6800 export COMFYUI_MANAGER_ARIA2_SECRET你的密钥执行后无输出这是正常的。想让配置长期有效把这两行追加到~/.bashrc或~/.zshrc末尾。Windows 用户则在启动 ComfyUI 的同一命令窗口里执行$env:COMFYUI_MANAGER_ARIA2_SERVERhttp://127.0.0.1:6800和$env:COMFYUI_MANAGER_ARIA2_SECRET你的密钥。改完后重启一次 ComfyUI新环境才会被加载。验证 aria2 通道已生效打开 ComfyUI-Manager 的模型面板随便选一个模型点下载看 ComfyUI 终端应出现一条带文件名的进度条且进度和速度每秒刷新一次交叉验证——在另一个窗口跑一句查询脚本python -c import aria2p;print(aria2p.API(aria2p.Client(http://127.0.0.1,6800,secret你的密钥)).get_downloads())能打印出任务列表、且其中包含你刚下载的文件说明 Manager 确实把任务交给了 aria2。若第 2 步进度条不动先确认环境变量是否导出在了 ComfyUI 所在终端再确认 aria2 窗口还开着。再提速三个方向的参数参考aria2 的默认值已经可用想再榨一点速度只需在启动命令上追加参数按下面的方向调整即可不用死记完整命令。参数方向关键参数适用场景并发--split、--max-connection-per-server带宽富裕、源站不限速时各设为 8~16 起步观察速度是否继续上涨磁盘缓存--disk-cache如128M目标盘是机械硬盘时减少频繁刷盘容错--max-tries、--retry-wait、--timeout跨境下载、网络波动大调大重试次数与等待间隔两个提醒网盘类源站常对单 IP 并发数设上限连接数开得过高反而会被限流出现大量超时此时应调低而不是调高--disk-cache不要超过可用内存太多内存紧张时保持默认即可。避坑指南四个高频问题速度没变化现象配置完一切正常但下载速度和以前一样。原因九成出在环境变量export只对它所在的那个终端生效而 ComfyUI 是在另一个终端启动的。处理在真正启动 ComfyUI 的终端里重新执行那两条export再完整重启 ComfyUI。断点续传失效现象中断后重新下载进度归零。两个常见原因目录空间不足导致任务直接失败或手动删掉了 aria2 生成的.aria2控制文件它记录着已完成的分片。处理确保下载目录剩余空间不小于文件大小清理缓存时不要碰.aria2结尾的文件。进度条停在 0%现象任务建出来了但进度一动不动。通常是 RPC 连不上或密钥不匹配aria2 窗口已关闭、端口没监听、COMFYUI_MANAGER_ARIA2_SECRET与--rpc-secret不一致。处理先确认 aria2 进程活着再逐字核对两处的密钥。HTTPS 证书报错现象下载部分 HTTPS 源站时任务反复失败并提示证书错误多出现在自签证书的镜像站上。处理在 aria2 的配置文件~/.config/aria2/config里加一行bypass_ssl true后重启服务。这条建议只对确认可信的内网镜像开启。收尾一张可勾选的行动清单aria2 进程已带--rpc-secret长期运行日志正常滚动启动 ComfyUI 的终端已导出COMFYUI_MANAGER_ARIA2_SERVER与COMFYUI_MANAGER_ARIA2_SECRET并重启了 ComfyUI下载模型时终端进度条每秒刷新速度持续非零用查询脚本能列出 aria2 当前任务与正在下载的文件对得上断网测试过一次中断后重新触发同一模型下载进度从断点继续参考资料均在项目仓库内下载模块源码环境检测与 aria2 任务调度glob/manager_downloader.pyaria2 环境变量与 docker-compose 示例文档docs/en/use_aria2.md项目主文档README.md如果这套配置在你的环境里跑通了可以顺手把自己的并发参数记录一份方便下次在新机器上直接复用跑不通的话从验证一节的小脚本开始查基本都能在三步内定位到问题所在。【免费下载链接】ComfyUI-ManagerComfyUI-Manager is an extension designed to enhance the usability of ComfyUI. It offers management functions to install, remove, disable, and enable various custom nodes of ComfyUI. Furthermore, this extension provides a hub feature and convenience functions to access a wide range of information within ComfyUI.项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考