ComfyUI Manager 配置配置

配置路径

从 V3.38 开始，Manager 使用受保护的系统路径以增强安全性。

配置文件

Config.ini 选项

修改 config.ini 文件以应用设置。路径显示在启动日志消息中。

[default]
git_exe = <git 可执行文件路径>
use_uv = <True/False - 使用 uv 代替 pip>
default_cache_as_channel_url = <True/False - 启动时获取指定为 channel_url 的数据库>
bypass_ssl = <True/False - 如果出现错误则禁用 SSL>
file_logging = <True/False - 创建日志文件>
windows_selector_event_loop_policy = <True/False - 修复 Windows 上的事件循环错误>
model_download_by_agent = <True/False - 使用代理下载模型>
downgrade_blacklist = <逗号分隔的阻止降级的包列表>
security_level = <strong|normal|normal-|weak>
always_lazy_install = <True/False - 在重启时执行依赖安装>
network_mode = <public|private|offline>

网络模式

安全级别

功能风险级别

环境变量

示例

通过代理重定向 GitHub 请求：

GITHUB_ENDPOINT=https://mirror.ghproxy.com/https://github.com

更改 Hugging Face 端点：

HF_ENDPOINT=https://some-hf-mirror.com

高级配置

阻止特定包降级

在 config.ini 的 downgrade_blacklist 部分列出包名，用逗号分隔：

downgrade_blacklist = diffusers, kornia

自定义 pip 映射

创建 pip_overrides.json 文件，将特定 pip 包的安装更改为用户定义的安装。格式请参考 pip_overrides.json.template。

阻止安装特定 pip 包

在 pip_blacklist.list 文件中每行列出一个包名。

自动恢复 pip 安装

在 pip_auto_fix.list 中列出 pip 规范要求（类似于 requirements.txt）。当启动 ComfyUI 或在自定义节点安装期间版本不匹配时，它将自动恢复指定版本。可以使用 --index-url。

使用 aria2 作为下载器

为了更快的下载速度，您可以配置 ComfyUI-Manager 使用 aria2。请参阅 aria2 设置指南。

extra_model_paths.yaml 配置

以下设置基于标记为 is_default 的部分应用：

• custom_nodes：安装自定义节点的路径
• download_model_base：下载模型的路径

CLI 工具

ComfyUI-Manager 提供 cm-cli，这是一个命令行工具，允许您在不运行 ComfyUI 的情况下使用 Manager 功能。这对于自动化自定义节点安装和在无头环境中管理安装很有用。

有关详细的 cm-cli 文档，请参阅官方 cm-cli 指南。

如需更全面的 CLI 体验，请考虑使用 comfy-cli。