ComfyUI Manager 配置配置

配置 ComfyUI-Manager 设置

​

配置路径

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

ComfyUI 版本	Manager 路径
v0.3.76+	<USER_DIRECTORY>/__manager/
旧版本	<USER_DIRECTORY>/default/ComfyUI-Manager/

如果不带任何选项执行，<USER_DIRECTORY> 路径默认为 ComfyUI/user。可以使用 --user-directory <USER_DIRECTORY> 设置。

​

配置文件

文件	描述
config.ini	基本配置
channels.list	可配置的频道列表
pip_overrides.json	自定义 pip 包映射
pip_blacklist.list	阻止安装的包
pip_auto_fix.list	自动恢复的包
snapshots/	保存的快照文件
startup-scripts/	启动脚本文件
components/	组件文件

​

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>

​

网络模式

模式	描述
public	标准公共网络环境
private	通过 channel_url 配置私有节点数据库的封闭网络（如果可用则使用缓存）
offline	无外部连接（如果可用则使用缓存）

​

安全级别

级别	描述
strong	不允许高风险和中风险功能
normal	不允许高风险功能；中风险功能可用
normal-	如果指定了 --listen 且不以 127. 开头，则不允许高风险功能；中风险功能可用
weak	所有功能可用

​

功能风险级别

风险级别	功能
高	通过 git url 安装、pip install、安装不在默认频道中的自定义节点、修复自定义节点
中	卸载/更新、安装默认频道中的自定义节点、恢复/删除快照、重启
低	更新 ComfyUI

​

环境变量

变量	描述
COMFYUI_PATH	ComfyUI 的安装路径
GITHUB_ENDPOINT	GitHub 访问的反向代理
HF_ENDPOINT	Hugging Face 访问的反向代理

​

示例

通过代理重定向 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。