Open WebUIで自分のPCにAIチャット画面を作る

Open WebUIは、ブラウザーでローカル言語モデルと会話し、添付ファイルについて質問するためのWebインターフェースです。OllamaまたはOpenAI互換API²サーバーに入力を送り、応答を表示します。モデル自体は提供しないため、先にモデルサーバーを起動しておきます。

ここではMacアプリのOllamaとDocker Desktop上のOpen WebUIを接続します。コンテナを起動して最初の管理者アカウントを作り、Ollamaの接続先を登録します。モデルが選択欄に表示されたらテキストで応答を確認し、最後に短いPDFを添付して質問します。

Docker Desktopをインストールして起動し、ターミナルからOpen WebUIコンテナを開始します。127.0.0.1:3000:8080は、このPCの3000番ポートをコンテナ内の8080番ポートに接続します。open-webuiボリュームにはアカウント、設定、会話、アップロードデータを保存します。

docker run -d --name open-webui --restart unless-stopped -p 127.0.0.1:3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data ghcr.io/open-webui/open-webui:main

コンテナが起動したら、ブラウザーでhttp://127.0.0.1:3000を開きます。最初の画面にCreate Admin Accountが表示されたら、ユーザー名とパスワードを決めます。この最初のアカウントが管理者となり、その後は一般ユーザー登録が既定で無効になります。設定や会話に再びアクセスできるよう、パスワードとDockerボリュームを保管してください。ログイン後、次の節でOllamaを接続して、モデル一覧を読み込みます。

Ollama を Mac アプリ、Open WebUI を Docker Desktop で実行する場合は、この設定を使います。コンテナ内の localhost は Ollama ではなく Open WebUI コンテナを指します。Docker Desktop からホスト Mac の Ollama API に接続するには http://host.docker.internal:11434 を使います。

Ollama は既定では Mac の 127.0.0.1 からのみ接続を受け付けます。Docker からのリクエストを受けるには、macOS アプリを起動する前に OLLAMA_HOST を 0.0.0.0:11434 に設定し、アプリを再起動します。この設定ではすべてのネットワークインターフェースで接続を受け付け、既定の API 認証もありません。

信頼できないネットワークではこの設定を使わないでください。ファイアウォールで 11434 番ポートへの着信を制限し、ルーター経由でポートを公開しないでください。

launchctl setenv OLLAMA_HOST 0.0.0.0:11434

アバターメニューからSettings → Admin → Connectionsへ移動し、Ollama API接続にhttp://host.docker.internal:11434を入力して保存します。モデル選択欄にOllamaで取得したモデルが表示されたら、短いテキスト質問を送り、回答を確認します。モデル一覧が空、または接続エラーになる場合は、Ollamaが起動していることと、ターミナルのollama listにモデルが表示されることを先に確認します。

ollama list

接続したモデルに、公開してもよい短い文章を送り、応答を確認します。新しい会話を作って同じ文を送ると別の会話として記録されます。サイドバーから最初の会話を開き、保存されたことを確認してください。データボリュームを削除すると会話も失われることがあるため、ボリュームを削除する前に必要なデータをバックアップします。

次に短いPDFを添付し、特定の見出しや日付を探すよう質問します。応答内容を実際のページと照合し、ファイルが処理されて結果が使えるか確認します。スキャン画像のページでは文字抽出が必要な場合があります。個人情報や業務上の機密をアップロードする前に、ファイルの保存場所とバックアップ対象を確認してください。

ブラウザーで画面が開かない場合は、docker psでコンテナが動作しているか確認し、停止していたらdocker logs open-webuiで最初のエラーを読みます。コンテナが一覧にない、またはポート競合が表示される場合は、別のプログラムが3000番ポートを使用していないか調べ、別のローカルポートに割り当てます。

画面が開いてもモデルが表示されない場合は、Settings → Admin → Connections で Ollama の URL が http://host.docker.internal:11434 か確認します。このアドレスは Mac の Docker Desktop で使います。ollama list にモデルがあり Ollama も実行中なのに接続できない場合は、Mac 上の Ollama が Docker からのリクエストを受け付ける設定か確認します。

Linux ホストに Ollama をインストールした場合、host.docker.internal は自動では利用できないことがあります。Docker の host-gateway マッピングまたはホストネットワーク接続を設定し、その構成に合った Ollama アドレスを指定します。