comfyui-runner

核心用法

comfyui-runner 是一个面向 ComfyUI 服务器的轻量级运维工具，提供 run、stop、status 三个核心动作。用户通过 JSON 指令即可控制本地或局域网内的 ComfyUI 实例，无需手动进入终端操作。

配置项支持环境变量或 .env 文件，包括主机地址（默认 192.168.179.111）、端口（默认 28188）以及可选的基础认证凭据。技能依赖 node 和 curl，通过调用 /health 端点实现健康检查。

显著优点

• 操作极简：单条 JSON 指令完成启停，降低 ComfyUI 使用门槛
• 配置灵活：支持环境变量与 .env 双模式，便于多环境部署
• 认证支持：内置基础 HTTP 认证适配，满足简单安全需求

潜在局限

• 网络强依赖：默认绑定固定内网 IP，公网或动态 IP 场景需手动调整
• 无进程守护：run 动作仅为启动触发，异常崩溃后无自动恢复机制
• 认证强度有限：仅支持 Basic Auth，无 Token、OAuth 等企业级方案
• 日志缺失：未暴露日志查看接口，排障仍需手动登录服务器

适合人群

个人开发者、本地 AI 绘画爱好者、小型工作室的 ComfyUI 自动化运维场景，尤其适合需要将 ComfyUI 集成到更大工作流（如通过 MCP/Claude 调用）的用户。

常规风险

• 未经验证的来源：clawdbot 元数据标识，非官方 ComfyUI 团队出品，需审计 bin/cli.js 实际行为
• 凭据泄露：.env 文件若权限配置不当，可能导致密码明文暴露
• 网络暴露风险：默认内网 IP 虽相对安全，但若用户手动改为 0.0.0.0 且无认证，ComfyUI 可能暴露于公网

核心用法

comfyui-runner 是一款极简的本地 ComfyUI 管理工具，专为 AI 绘画工作流自动化设计。通过三个核心指令——run（启动）、stop（停止）、status（状态检测）——用户可无缝控制本地 ComfyUI 实例的生命周期。

配置高度灵活，支持环境变量或 .env 文件设置目标地址（COMFYUI_HOST/COMFYUI_PORT），并可选配基础认证（COMFYUI_USER/COMFYUI_PASS）。技能通过 curl 检测 /health 端点确认服务可用性，无需复杂集成即可嵌入自动化脚本。

显著优点

• 极致轻量：仅 48 行 JavaScript 代码，零第三方依赖，启动速度极快
• 本地安全：网络请求严格限制于用户配置的本地 ComfyUI 实例，无外泄风险
• 配置灵活：支持 .env 文件与环境变量双模式，适配开发与生产环境
• 隐私合规：仅读取功能必需的环境变量，不采集任何敏感信息
• 代码透明：开源结构清晰，便于安全审计与二次开发

潜在缺点与局限性

• 协议单一：当前仅支持 HTTP，HTTPS 环境需额外配置
• 输入验证缺失：未对 host 格式和 port 范围进行校验，配置错误可能导致连接失败
• T3 来源：个人开发者维护，长期更新与社区支持存在不确定性
• 功能聚焦：仅覆盖基础生命周期管理，不支持队列监控、工作流导入等高级功能

适合人群

• 本地部署 ComfyUI 的 AI 绘画爱好者与研究者
• 需要自动化管理 ComfyUI 实例的开发者与运维人员
• 追求极简工具、重视代码可审计性的技术用户

常规风险

• 配置错误可能导致连接本地错误端口或服务不可达
• 若启用了基础认证，密码需自行保障安全存储
• 来源为个人项目，建议生产环境使用前自行审查代码