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-ManagerComfyUI-Manager 是 ComfyUI 的常用扩展除了安装和管理自定义节点还负责从网络下载模型文件。默认通道用单连接串行写入遇到 GB 级文件时速度通常跑不满带宽。本文讲如何用 Manager 内置的 aria2 通道把模型下载切到多线程模式包含最小配置、验证方法和目录映射这些容易踩坑的部分。 原理Manager 何时把下载交给 aria2先说结论切换是自动的你只需要设两个环境变量。Manager 的下载模块源码在 glob/manager_downloader.py启动时会读取COMFYUI_MANAGER_ARIA2_SERVER。只要这个变量存在它就通过 aria2p 库连上 aria2 的 RPC 接口之后的模型下载都提交给 aria2 执行变量不存在时走默认的单连接下载。RPCRemote Procedure Call远程过程调用可以理解为 aria2 开放的控制端口别的程序通过它下发下载这个地址的指令。aria2 本身是支持多线程的下载器把文件切成多段用多条并行连接同时拉取带宽利用率和断点续传中断后从已下载的位置继续不用从头来都比单连接好。两种通道的差异如下对比项默认下载aria2 通道网络连接1 条连接多条并行由 aria2 的--split与--max-connection-per-server参数决定中断处理不完整的文件需要重新下载断点续传依托.aria2控制文件接着下文件落盘位置直接写 ComfyUI 的 models 目录写在 aria2 侧配置的目录需映射回 ComfyUI见进阶部分 最小配置安装 aria2 并开启 RPC 端口最少要完成两件事跑一个 aria2 服务再在 ComfyUI 的 Python 环境装好连接它的库。安装并启动 aria2 服务以下命令在 Linux 下安装 aria2并以守护进程方式开启 RPC 接口密钥换成你自己的随机字符串sudo apt-get install aria2 aria2c --enable-rpc --rpc-secret换成你自己的密钥 --daemontruemacOS 用户把第一条换成brew install aria2启动命令相同。服务默认只监听本机 127.0.0.1 的 6800 端口无需额外放行防火墙。在 ComfyUI 环境中安装 aria2pManager 依赖 aria2p 库来调用 aria2 的 RPC 接口它不在默认依赖列表里需要在 ComfyUI 的虚拟环境中手动安装pip install aria2p⚙️ 设置环境变量让 ComfyUI-Manager 接管下载启动 ComfyUI 之前设置两个变量前者是 aria2 服务的地址后者要和 aria2 启动时的密钥一致。export COMFYUI_MANAGER_ARIA2_SERVERhttp://127.0.0.1:6800 export COMFYUI_MANAGER_ARIA2_SECRET换成你自己的密钥Windows 用户在 PowerShell 中对应写成$env:COMFYUI_MANAGER_ARIA2_SERVERhttp://127.0.0.1:6800 $env:COMFYUI_MANAGER_ARIA2_SECRET换成你自己的密钥变量只在 Manager 启动时读取一次改完必须重启 ComfyUI 才生效。想让它每次启动都带上就把两行写进~/.bashrc、~/.zshrc或在系统环境变量面板里配置。✅ 验证 aria2 下载是否生效与常见卡点重启 ComfyUI 后在 Manager 的模型管理界面下载任意一个模型两边一起看结果aria2 侧打开它的 Web 管理页能看到新出现的下载任务这是最直接的证据。Manager 侧控制台进度条由每秒轮询 aria2 任务状态驱动刷新方式和默认通道不同。如果没走 aria2通常是下面几种情况环境变量设了但没重启 ComfyUIManager 读到的仍是旧值密钥与 aria2 启动参数不一致RPC 握手失败忘记安装 aria2p启动时报 ImportError任务下了文件却没出现在 ComfyUI 里——这是目录没映射看下一节 进阶Docker 部署 aria2 并映射模型目录有个容易忽略的细节当下载目标位于 ComfyUI 安装路径内时Manager 会把目标目录换算成 aria2 侧的绝对路径比如models/checkpoints会换算成/models/checkpoints。所以 aria2 容器必须把 ComfyUI 的 models 目录挂载进来文件才会落到正确位置。下面这份 compose 文件基于官方文档 docs/en/use_aria2.md 的示例整理端口统一用 6800模型与自定义节点目录按你的实际路径修改services: aria2: container_name: aria2 image: p3terx/aria2-pro environment: - RPC_SECRET换成你自己的密钥 - RPC_PORT6800 volumes: - ./config:/config - ~/ComfyUI/models:/models - ~/ComfyUI/custom_nodes:/custom_nodes ports: - 127.0.0.1:6800:6800 restart: unless-stopped注意RPC_SECRET要和COMFYUI_MANAGER_ARIA2_SECRET保持完全一致。端口只绑定 127.0.0.1避免 RPC 接口暴露到公网。至此安装 aria2、设置变量、验证与目录映射都已覆盖。下一步建议先按最小配置跑通一次本地下载确认模型出现在 ComfyUI 的 models 目录后再迁移到 Docker 部署。相关资源官方 aria2 配置文档docs/en/use_aria2.md下载器源码glob/manager_downloader.py【免费下载链接】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），仅供参考
