ComfyUIでworkflowのnodeが欠けるときの安全な確認手順
CHATGPT / AIChatGPTなどの生成AIを活用して運営・記事制作・更新を行っています。制作方針
共有されたComfyUI workflowでnodeがmissingになったら、coreのversion差かcustom node不足かを先に切り分けます。配布元・依存関係を確認して導入し、信頼できないnodeは実行しない判断手順を解説します。
先に結論
共有されたComfyUI workflowでnodeがmissingになったら、まず不足nodeがComfy Core由来かthird-party custom nodeかを切り分けます。core nodeならComfyUI本体のversion差を調べ、custom nodeならpackageの配布元・README・依存関係を確認します。custom nodeはPython codeとしてユーザー権限で動くため、workflowやManagerの表示だけで安全と決めず、出所を信頼できない場合は導入しないでください。
この記事の対象と確認範囲
この記事は、workflowを読み込んだときに表示されるmissing nodeを調べ、更新またはcustom node導入を選ぶ前の確認順をまとめたものです。ComfyUIの公式文書とsecurity policyを調査日に確認しています。特定のworkflow、custom node、OSでの実機導入や安全性監査は行っていません。
1. 不足しているnodeと配布元を記録する
workflowを実行する前に、missing表示に出たnode名やclass名、workflowの配布元、必要とされるComfyUIのversionを控えます。配布元のREADMEやworkflow説明で、必要node packageと対応versionが明示されているかを確認してください。JSON内のnode名だけでは、正規のpackageや信頼できる配布元を特定できない場合があります。
ComfyUI公式のnodes文書では、missing nodeは大きく二つに分けられています。Comfy CoreのnodeならComfyUIが古い可能性があり、third-party custom nodeならそのnode packageが入っていない可能性があります。画面上でnodeのsource badgeが見える場合は、Core由来かpackage名が表示されているかも確認材料になります。
2. Core nodeなら本体version差を確認する
Comfy Core nodeが見つからない場合、いきなりcustom nodeを追加せず、現在のComfyUI versionとworkflowが作られた環境を照合します。workflowの配布元が特定versionを要求しているなら、そのversion情報と利用中の導入方式を確認し、公式の更新手順に沿って更新できるか判断します。update前に、現在の環境とworkflowのcopyを保管しておけば、問題が出たときに変更範囲を戻しやすくなります。
更新後にmissing表示が消えるか確認します。Core nodeの不足が解消しない、またはworkflowが古い環境に依存している場合は、無理に別packageで置き換えず、workflow作者の必要versionや互換性の説明を確認してください。
3. Custom nodeなら信頼性を確認してから導入する
custom nodeが必要な場合は、まずworkflow作者が示す公式repositoryやComfyUI Registry上のpackageと、READMEに記載された目的・依存関係・対応versionを照合します。ComfyUIの公式install guideも、導入前に機能を理解し、信頼できる作者・配布元を選び、未知のsourceを避けるよう案内しています。Managerに検索結果が出たことだけでは、packageの安全性やworkflowとの互換性は保証されません。
- workflow作者の説明から、必要なnode package名と配布元を特定する。
- 配布元のREADME、必要なPython依存関係、対応ComfyUI versionを読む。
- 配布元と内容を信頼できる場合に限り、ComfyUI Managerなど公式文書にある経路で導入する。
- ComfyUIを再起動し、startup logの
import failedなどを確認してmissing表示が解消したか調べる。
公式のmanual installでは、node repositoryをComfyUI/custom_nodesに置き、必要なPython dependenciesをComfyUIの環境へ導入して、再起動後のstartup logを確認する手順が示されています。これはnode codeと依存packageを実行環境へ追加する操作です。READMEや配布元を確認できない、必要な権限や依存関係が説明されていない、または信頼できない場合はそこで止め、導入しない選択をしてください。
4. 実行前にworkflow全体を確認する
missing表示が消えても、workflow全体の実行が安全・互換であるとは限りません。接続されたnode、入力file、外部接続やfile accessを行うnodeが含まれていないか確認し、意図を説明できないnodeが残る場合は実行しないでください。ComfyUIのsecurity policyはcustom nodeを任意のPython codeとし、利用者が信頼して導入したsoftwareと同じように扱う前提を示しています。
導入前の状態へ戻すときは、今回追加したcustom nodeと依存関係だけを、使った導入方法に沿って取り除きます。既存のcustom_nodes全体や共有環境を一括削除しないでください。更新前に保管したComfyUI環境またはworkflowのcopyから、今回の変更範囲を戻せるか確認します。
成功確認と未確認範囲
- 不足nodeがComfy Coreかcustom nodeかを説明できる。
- custom nodeのpackage名、配布元、README、必要依存関係を確認できる。
- 再起動後にmissing表示が消え、起動時のimport errorがないことを確認できる。
- nodeが読み込めたこととworkflowの安全性・生成結果・model互換性は別の確認事項として扱う。
ComfyUIやManagerのversion、各node packageの更新状況、workflowごとの互換性は変化します。この記事は特定のnode packageを安全と判定するものではなく、実行環境の隔離や個々の依存packageの監査を代替しません。model fileの種類・保存先を調べる場合はComfyUI workflowの必要model fileを確認する方法、ローカル画像・動画生成の構成を整理する場合はローカル画像・動画生成の構成ガイドも参照してください。前者はmodel配置、後者は全体構成を扱い、custom nodeを導入する判断とは異なる内容です。
参考資料
- ComfyUI公式: Nodes（2026年10月14日確認。文書に発行・更新日の表示なし）
- ComfyUI公式: How to Install Custom Nodes（2026年10月14日確認。文書に発行・更新日の表示なし）
- ComfyUI公式: Security Policy（2026年10月14日確認。文書に発行・更新日の表示なし）
