ComfyUI Desktopの起動引数は、対象InstanceのManageからStartup Argsを開いて設定します。欄へ文字を入れただけでは実行中のサーバーに反映されません。変更前の設定を控え、再起動後のログまで確かめるところを一つの作業にします。
アプリ全体ではなく、変更するInstanceを選ぶ
DesktopではInstanceごとに起動設定を持てます。制作と検証を分けている場合、最初にカードの名前を確認してからManageを開きます。別のInstanceへ設定を入れ、いつもの環境を再起動しても、目的の変更は試せません。
起動引数を調整する前に、今の文字列をテキストへ保存します。「元に戻す」ときに全欄を空にするのではなく、元の値へ戻せるようにするためです。以前から必要だったポートや保存先の設定まで消すと、元の問題とは別の不具合が発生します。
一つの目的に対して、一つの変更を試す
- 対象Instance名と現在の起動引数を記録する。
- 解決したい症状を一文で書く。
- 歯車のピッカーか引数欄で、必要な項目だけ変更する。
- 生成中の仕事を終え、未保存のworkflowを保存する。
- 再起動し、ログと小さなworkflowで反映を確認する。
メモリ不足なら、省メモリに関係する設定だけを試します。ネットワーク、ポート、メモリ設定を同時に変えると、起動できなくなった理由を見分けにくくなります。OOMの切り分けで対象ノードを確認してから調整してください。
引数欄に残っていても、適用されたとは限らない
2026年11月8日の公式ガイドでは、未知の引数が欄に残っていても、起動時のスキーマ判定によって渡されない場合があります。逆に、スキーマ取得に失敗した場合は引数がそのまま渡される説明もあります。欄に文字が見えることを、対応済みの証拠にしないでください。
古い記事からコピーした引数で起動に失敗したら、使用中のComfyUI版が対応しているかを確認します。同じ設定名でも、別の導入方式や別の版の例かもしれません。まず直前に追加した部分を戻し、起動できる状態へ戻してから調べます。
| 観察 | 次に確認するもの |
|---|---|
| 設定を変えても動作が同じ | 再起動したInstanceと起動ログ |
| unknown argumentで停止する | 使用版の対応引数とコピー元の時点 |
| 別のポートで起動した | ポート競合の表示と実際の接続先 |
通信設定を変えるときは公開範囲も確認する
手元だけで使う環境と、別の端末から接続する環境では必要な設定が異なります。接続できない原因を調べるために、理由を確かめず--listenを追加するのは避けます。接続先の誤りなのか、サーバーが起動していないのかを先に分けてください。
Managerの導入制限もネットワークの公開範囲と関係します。ノードが入らないからといって、複数の制限を一度に緩める必要はありません。使用中のManager設定と登録元を照合します。
環境変数欄を秘密情報の保管庫にしない
Desktopの環境変数欄は、認証情報らしい値を画面上で隠す場合がありますが、公式ガイドは値が暗号化されず保存されると説明しています。伏せ字表示と安全な秘密管理を同じものとして扱わず、実際のキーを安易に入れないでください。
反映条件と設定項目は公式のManageガイドが確認先です。変更が終わったら、採用した設定と戻す値を一緒に残します。