配置路径
从 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_ENDPOINT=https://mirror.ghproxy.com/https://github.com
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 设置指南。
以下设置基于标记为 is_default 的部分应用：
custom_nodes：安装自定义节点的路径download_model_base：下载模型的路径
CLI 工具
ComfyUI-Manager 提供 cm-cli，这是一个命令行工具，允许您在不运行 ComfyUI 的情况下使用 Manager 功能。这对于自动化自定义节点安装和在无头环境中管理安装很有用。
有关详细的 cm-cli 文档，请参阅官方 cm-cli 指南。
如需更全面的 CLI 体验，请考虑使用 comfy-cli。
