
ふと思いたってComfyUIを導入した話:手順つき(*'▽')
こんにちは!高橋です。
ふと、そういえば画像生成分野にあまり手を出してこなかったな…と、思いローカル環境で使ってみたくなり、Windows 11上に ComfyUI を導入しました。
ザっとあげると今回は以下のようなことをしました。
この記事にその手順を書いておきますので興味のある方は導入してみてくださいね♪
Windows PCのGPUを使って高速に画像生成する
Dockerを使って環境をできるだけ汚さず管理する
同じローカルネットワーク内の別PCやスマホからもアクセスできるようにする
次回以降はバッチファイルだけで一発起動できるようにする
今回は、環境構築のベースとして Puget Systems Docker App Packs を利用しました。AI・データサイエンス向けのDockerベース環境をまとめて構築できる便利なスターターテンプレート集です。
この記事では、導入手順や途中でハマったポイント、解決策まで詳しく解説していきますので、ぜひ一緒に手を動かしてみてください!ワキワキ
ComfyUIとは?
ComfyUIは、画像生成AIの処理を「ノード」と呼ばれるブロックで組み立てるツールです。
一般的な画像生成AIのUIは、プロンプトやサイズをフォームに入力して「生成」ボタンを押すタイプが多いですが、ComfyUIは少し違います。
プロンプトを入力する
テキストエンコーダーで解釈する
モデルに渡す
サンプラーで画像を生成する
VAEで画像に変換する
保存する
という一連の流れを、画面上のブロックを線でつないで作ります。
最初は少し難しく見えますが、慣れてくると「どの処理がどこで行われているか」が視覚的に分かるため、非常に自由度が高く、世界中のクリエイターに愛用されています。
今回の環境構成
今回の構成は以下のようなイメージです。
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 にアクセスします。
ノードが線でつながったワークフローが表示されたら成功です!
使い方の基本は以下の通りです。
プロンプトを書く
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
画像サイズを調整する
Empty Latent Image などのノードで指定します。最初は正方形の 1024 x 1024 が扱いやすいです。うまく生成できない場合はサイズを下げてみましょう。
生成する(Queue Prompt)
画面上の Queue Prompt ボタンを押すと生成が始まります。
生成画像の確認
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は最高の選択肢です。ぜひこの記事を参考にチャレンジしてみてください!
それでは今回はここまで(*'▽')ノシ