メインコンテンツへスキップ
見出し画像

ふと思いたってComfyUIを導入した話:手順つき(*'▽')

    こんにちは!高橋です。

    ふと、そういえば画像生成分野にあまり手を出してこなかったな…と、思いローカル環境で使ってみたくなり、Windows 11上に ComfyUI を導入しました。

    ザっとあげると今回は以下のようなことをしました。
    この記事にその手順を書いておきますので興味のある方は導入してみてくださいね♪

    • Windows PCのGPUを使って高速に画像生成する

    • Dockerを使って環境をできるだけ汚さず管理する

    • 同じローカルネットワーク内の別PCやスマホからもアクセスできるようにする

    • 次回以降はバッチファイルだけで一発起動できるようにする

    今回は、環境構築のベースとして Puget Systems Docker App Packs を利用しました。AI・データサイエンス向けのDockerベース環境をまとめて構築できる便利なスターターテンプレート集です。

    この記事では、導入手順や途中でハマったポイント、解決策まで詳しく解説していきますので、ぜひ一緒に手を動かしてみてください!ワキワキ


    ComfyUIとは?

    ComfyUIは、画像生成AIの処理を「ノード」と呼ばれるブロックで組み立てるツールです。

    一般的な画像生成AIのUIは、プロンプトやサイズをフォームに入力して「生成」ボタンを押すタイプが多いですが、ComfyUIは少し違います。

    1. プロンプトを入力する

    2. テキストエンコーダーで解釈する

    3. モデルに渡す

    4. サンプラーで画像を生成する

    5. VAEで画像に変換する

    6. 保存する

    という一連の流れを、画面上のブロックを線でつないで作ります。

    最初は少し難しく見えますが、慣れてくると「どの処理がどこで行われているか」が視覚的に分かるため、非常に自由度が高く、世界中のクリエイターに愛用されています。


    今回の環境構成

    今回の構成は以下のようなイメージです。

    Plaintext

    Windows 11
    └─ WSL2 Ubuntu
       └─ Docker (NVIDIA Container Toolkit)
          └─ ComfyUI コンテナ
    

    最大のポイントは、ComfyUIやPythonの環境をWindowsに直接インストールしないことです。

    WSL2上のUbuntuにDockerを入れ、その中で動かすことで、Windows本体の環境を綺麗に保てます。うまくいかなくなったときも「コンテナを作り直すだけ」という気軽さがあります。


    導入手順:WSL2とDockerの準備

    PugetのREADMEではワンラインのインストールコマンドが紹介されていますが、WindowsのPowerShellでそのまま実行するとエラーになります。

    まずはWSL2(Ubuntu)の環境を整えましょう。

    Step 1: WSL2 (Ubuntu) の準備

    PowerShellを開き、WSLでUbuntuを起動します。(インストールされていない場合は wsl --install が必要です)

    PowerShell

    wsl -d Ubuntu
    

    💡 ハマりポイント:ユーザー名に「admin」はNG
    WSLの初回起動時にLinuxユーザーを作成しますが、admin という名前を使おうとしたところ、既存グループと衝突して失敗しました。別のユーザー名(user など)で作成しましょう。また、ここで設定したパスワードは各種設定で使うので忘れないようにしてください。(もちろん、ブログ等にパスワードは書かないよう注意!)

    Step 2: systemdの有効化

    Ubuntuに入ったら、Dockerをサービスとして動かすために systemd を有効化します。

    Bash

    sudo nano /etc/wsl.conf
    

    以下の内容を追記(または変更)して保存します。

    Ini, TOML

    [user]
    default=あなたのユーザー名
    
    [boot]
    systemd=true
    

    保存したら、一度WindowsのPowerShellに戻り、WSLを再起動して設定を反映させます。

    PowerShell

    wsl --shutdown
    wsl -d Ubuntu
    

    Step 3: Dockerの初期化エラー対策

    WSL内にDockerをインストールする際、Docker Desktop用の認証ヘルパーを探してエラー(docker-credential-desktop.exe not found)になることがあります。これを防ぐため、空の設定ファイルを作っておきます。

    再びUbuntu内で以下のコマンドを実行します。

    Bash

    mkdir -p ~/.docker
    printf '{}\n' > ~/.docker/config.json
    
    sudo mkdir -p /root/.docker
    printf '{}\n' | sudo tee /root/.docker/config.json
    

    導入手順:Puget Docker App Packsでのインストール

    環境が整ったので、いよいよインストールです。

    Ubuntu内で以下のコマンドを実行します。

    Bash

    cd ~
    curl -fsSL https://raw.githubusercontent.com/Puget-Systems/puget-docker-app-pack/main/setup.sh -o setup.sh
    bash setup.sh
    

    インタラクティブなウィザードが起動し、DockerやNVIDIA Container Toolkitの確認からビルドまで自動で進めてくれます。

    Flavor(用途)の選択

    途中でセットアップする環境の種類を聞かれます。

    Plaintext

    1) comfy_ui
    2) dockerbase
    3) personal_llm
    4) team_llm
    

    今回は画像生成を行いたいので、1番の comfy_ui を選びます。

    モデルの選択

    次に、使用するモデルを選択します。

    ここでは Flux.2 や SDXL Turbo などの選択肢が表示されます。
    初心者向けにざっくり整理すると以下のようになります。

    モデル向いている用途特徴
    Flux.2 Dev
    最高品質を狙いたい人向け重いが高品質。最大品質向け
    Flux.1 Dev旧世代の高品質モデルFlux系の安定した高品質モデル
    HiDream I1 Dev高品質・高精細な画像生成17Bパラメータのオープンソースモデル
    Flux.2 Klein高速に試行錯誤したい人向け軽量・高速。リアルタイムや低VRAM向け
    Flux.1 Schnellとにかく速く試したい人向けドラフト作成やプロンプト調整向き
    SDXL Turbo軽くて速い生成をしたい人向け高速生成向き。負荷が低め

    今回は、GPUに余裕があり、かつ高品質な画像生成を試したかったので HiDream I1 Dev (FP8) を選びました。

    💡 初心者が最初に選ぶなら?
    高品質を試したい: HiDream I1 Dev (今回のおすすめ)
    まず軽く動かしたい: Flux.2 Klein または SDXL Turbo
    重すぎるモデルを選ぶとダウンロードや起動でつまずく可能性があるので、PCスペックに合わせて選びましょう。


    ComfyUIの基本的な使い方

    インストールが完了したら、ブラウザで http://localhost:8188 にアクセスします。

    ノードが線でつながったワークフローが表示されたら成功です!

    使い方の基本は以下の通りです。

    1. プロンプトを書く

      • Positive Prompt(CLIP Text Encodeなど): 描いてほしいものを書きます。

        • 例: a cute robot sitting in a coffee shop, warm lighting, detailed, cozy atmosphere

      • Negative Prompt: 避けたいものを書きます。

        • 例: low quality, blurry, distorted hands, watermark

    2. 画像サイズを調整する

      • Empty Latent Image などのノードで指定します。最初は正方形の 1024 x 1024 が扱いやすいです。うまく生成できない場合はサイズを下げてみましょう。

    3. 生成する(Queue Prompt)

      • 画面上の Queue Prompt ボタンを押すと生成が始まります。

    4. 生成画像の確認

      • WSL内の ~/comfy_ui/output に保存されます。


    LAN内の他端末からアクセスできるようにする

    PC上では動くようになりましたが、WSL2はWindowsとは別の仮想ネットワークで動いているため、そのままではスマホなどからアクセスできません。

    Windows側のポートをWSL側のIPへ転送(ポートフォワーディング)する設定を行います。

    WindowsのPowerShellを「管理者として実行」 し、以下のコマンドをコピペして実行します。

    PowerShell

    # WSLのIPアドレスを取得
    $wslIp = (wsl -d Ubuntu hostname -I).Trim().Split()[0]
    
    # 既存の設定があれば削除
    netsh interface portproxy delete v4tov4 listenaddress=0.0.0.0 listenport=8188
    
    # 新しいIPアドレスでポート転送を設定
    netsh interface portproxy add v4tov4 `
      listenaddress=0.0.0.0 `
      listenport=8188 `
      connectaddress=$wslIp `
      connectport=8188
    
    # ファイアウォールの許可設定
    New-NetFirewallRule `
      -DisplayName "ComfyUI WSL 8188" `
      -Direction Inbound `
      -Action Allow `
      -Protocol TCP `
      -LocalPort 8188
    

    設定後、同じWi-Fiに繋がっているスマホや別PCのブラウザから、Windows PCのIPアドレスを使ってアクセスします。

    http://192.168.xxx.xxx:8188

    これで、寝転がりながらスマホで画像生成ガチャを回せるようになりました!


    おまけ:次回からバッチファイルで一発起動する

    PCを再起動するたびに、WSLのIPアドレスは変わってしまいます。毎回手動でポート転送を設定するのは面倒なので、ダブルクリックで起動と設定を全自動でやってくれるバッチファイルを作りました。

    デスクトップなどに Start-ComfyUI.bat というファイルを作成し、以下のコードを貼り付けてください。

    DOS

    @echo off
    setlocal
    
    :: 管理者権限の確認
    net session >nul 2>&1
    if %errorLevel% == 0 (
        echo Administrator privileges confirmed.
    ) else (
        echo Set UAC = CreateObject^("Shell.Application"^) > "%temp%\getadmin.vbs"
        echo UAC.ShellExecute "%~s0", "", "", "runas", 1 >> "%temp%\getadmin.vbs"
        "%temp%\getadmin.vbs"
        del "%temp%\getadmin.vbs"
        exit /B
    )
    
    echo Starting ComfyUI on WSL2...
    :: WSLでDocker起動とComfyUIのコンテナ起動
    wsl -d Ubuntu -u root service docker start
    wsl -d Ubuntu -e bash -c "cd ~/comfy_ui && docker compose up -d"
    
    :: WSLのIPアドレスを取得
    FOR /F "tokens=*" %%g IN ('wsl -d Ubuntu hostname -I') do (SET wslIp=%%g)
    :: IPアドレスの後ろのスペースをトリム
    FOR /F "tokens=1" %%g IN ("%wslIp%") do (SET wslIp=%%g)
    
    echo WSL IP is: %wslIp%
    
    :: ポートフォワーディングの更新
    netsh interface portproxy delete v4tov4 listenaddress=0.0.0.0 listenport=8188
    netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=8188 connectaddress=%wslIp% connectport=8188
    
    echo ComfyUI is ready!
    :: ブラウザで開く
    start http://localhost:8188
    
    pause
    

    次回からは、このファイルをダブルクリックするだけで環境が立ち上がります!


    まとめ

    今回、Windows 11上に WSL2 + Docker + ComfyUI の環境を作り、LAN内の他端末からもアクセスできるようにしました。

    最初はノードベースの見た目に戸惑うかもしれませんが、
    「材料を用意する → 指示を書く → モデルに渡す → 画像を作る」 という一連の流れが可視化されているだけです。
    慣れると「どこを変えればどう結果が変わるのか」が直感的に操作できるため、通常のWebUIよりも使いやすく感じるかもしれません。

    Dockerで構築しておくと、環境を再現しやすくトラブル時も安心です。

    まずは今回導入した高品質モデル HiDream I1 Dev で基本的なワークフローに慣れて、次は軽量な Flux.2 Klein や、動画生成の LTX-Video など、色々なモデルを試してみたいと思います。

    ローカル環境で本格的に画像生成AIを触ってみたい方にとって、ComfyUIは最高の選択肢です。ぜひこの記事を参考にチャレンジしてみてください!

    それでは今回はここまで(*'▽')ノシ

    この記事が参加している募集

     
     
    ダイアロゴスの仲間たちが交代でつぶやくnote。 AIやITを「むずかしい」から「わかりやすい」へ。 身近な視点で楽しくお届けします。

    あなたへのおすすめ