「明日」をつくるしごととくらし

テクノロジーを取り入れた教育の普及に取り組んでいます。

Mac mini 上の Gemma 4 環境構築メモ

環境:Mac mini M2 / メモリ16GB / macOS macOS 26.4.1
目的:ブラウザのみでローカルLLMにアクセスできるエッジサーバーの構築


構成の概要

  • LM Studio:推論エンジン。Gemma 4 E4B を読み込み、OpenAI 互換 API サーバーとして公開する
  • Open WebUI:チャットUI。Docker 上で動作し、LM Studio の API を呼び出す
  • クライアント:ブラウザのみでアクセス可能。アプリインストール不要

STEP 1:LM Studio のインストール

  1. https://lmstudio.ai/ にアクセス
  2. Apple Silicon (M1/M2/M3) 用のインストーラ(.dmg)をダウンロード
  3. .dmg を開き、LM Studio アイコンを Applications フォルダへドラッグ
  4. 初回起動時は「インターネットからのダウンロード」警告が出るので「開く」を選択

STEP 2:モデルのダウンロード(Gemma 4 E4B)

  1. LM Studio を起動し、上部の検索バーに gemma-4-E4B-it-GGUF と入力
  2. 検索結果から gemma-4-E4B-it-GGUF をクリック
  3. 「Download Options」から Q4_K_M または Q5_K_M と記載されているファイルを選択してダウンロード
    • ファイルサイズの目安:約6.3GB
    • Full GPU Offload Possible(緑表示)が出れば Mac M2 の 16GB で全量 GPU に載ることを意味する

量子化レベルについて
Q4_K_M:精度とメモリのバランスが良い(推奨)
Q5_K_M:やや高精度、メモリ消費もやや増


STEP 3:LM Studio のローカル API サーバーを起動

  1. 左端の縦メニューから 上から2番目のアイコン(「Developer」画面) をクリック
  2. 左側のメニューから 「Local Server」 を選択
  3. 画面上部「+ Load Model」ボタンから gemma-4-E4B-it-GGUF を選択して読み込む
  4. 「Server Settings」ボタン をクリックし、CORS を ON にする(ブラウザからの接続に必須)
  5. 画面上部の Status: Running トグルスイッチをオンにする(緑色になれば起動完了)
  6. 「Loaded Models」に gemma-4-e4b-it が READY と表示されることを確認
  7. Developer Logs に Server listening on http://127.0.0.1:1234 と出ていれば成功

補足:右側パネルの「Model Information」で以下を確認できる
- Format: GGUF / Quantization: Q4_K_M
- Capabilities: Vision(画像認識)・Tool use(ツール利用)対応
- Parallel: 4(同時4リクエストまで処理可能)


STEP 4:Docker Desktop のインストール

Homebrew でインストールする:

brew install --cask docker

インストール後の初期設定:

  1. アプリケーションフォルダから Docker を起動(または open /Applications/Docker.app)
  2. 利用規約(Docker Subscription Service Agreement)に「Accept」
  3. システム権限付与のため管理者パスワードを入力
  4. メニューバーの Docker アイコンが止まり「Docker Desktop is running」になれば完了

STEP 5:Open WebUI コンテナの起動

ターミナルで以下のコマンドを実行:

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

確認方法:

  • Docker Desktop の Containers タブで open-webui が緑色の Running 状態になっていれば成功
  • Mac mini のブラウザで http://localhost:3000 にアクセスしてログイン画面が表示されれば起動完了

STEP 6:管理者アカウントの作成

  1. http://localhost:3000 にアクセス
  2. 「サインアップ(Sign Up)」から名前・メールアドレス・パスワードを登録
  3. 最初に作成したアカウントが自動的に管理者権限を持つ

STEP 7:Open WebUI と LM Studio を接続

  1. Open WebUI にログイン後、左下のアカウントアイコン →「管理者パネル」を開く
  2. 「設定(Settings)」→「接続(Connections)」タブを選択
  3. OpenAI API のセクションの歯車アイコンをクリック
  4. URLを以下に変更(localhost ではなく host.docker.internal と入力するのが重要): http://host.docker.internal:1234/v1
  5. APIキー欄に lm-studio と入力(ローカルなので何でもよいが空欄はエラーになる)
  6. ダイアログ内の「保存」をクリック → 画面右下の大きな「保存」ボタンも押す
  7. チャット画面に戻り、モデル選択プルダウンに gemma-4-e4b-it が表示されれば接続成功

STEP 8:動作確認(ローカル)

チャット画面でモデルを選択してメッセージを送り、応答が返れば環境構築完了。


STEP 9:LAN 内の他端末からアクセス

同じネットワーク(同じルーター)に接続されている端末のブラウザから:

http://< Macのローカル IP アドレス>:3000

例:http://192.168.1.2:3000

Mac のローカル IP アドレスの確認方法:
「システム設定」→「ネットワーク」→ 接続中のWi-FiのIPアドレスを確認

学校ネットワークの注意点
プライバシーセパレーター(端末間通信遮断)や VLAN が設定されている場合、同一 Wi-Fi でも接続できないことがある。ネットワーク管理者への確認が必要。


付録:Cloudflare Tunnel で外部公開

負荷テストや外部の知り合いに試用させる場合に使う一時的な手段。

# インストール(未インストールの場合)
brew install cloudflared

# トンネルの起動
cloudflared tunnel --url http://localhost:3000

起動後、ログに表示される以下の形式の URL を共有する:

https://xxxxxxxx-xxxxxxxx.trycloudflare.com

終了するには Ctrl + C を押す。URL はその時点で無効化される。


ユーザー管理(Open WebUI)

  • 新規サインアップ時に入力するメールアドレスはダミーで可
  • 新規サインアップしたユーザーは初期状態で「保留中(Pending)」になる
  • 「管理者パネル」→「ユーザー」タブで対象ユーザーのロールを user に変更する
  • モデルが「プライベート」に設定されている場合、一般ユーザーには表示されない
    → 「ワークスペース」→「モデル」→ 対象モデルのアクセス権を「公開(すべてのユーザーにアクセス可能)」に変更する

関連情報

  • Gemma 4 E4B:「Effective 4B」の略。約40億の有効パラメータ。PLE 技術により効率的な推論を実現。エッジデバイス向け。
  • LM Link:LM Studio の有料機能。異なるネットワーク間での端末接続(Tailscale ベース)。教室内 LAN 利用であれば不要。
  • GGUF形式:LM Studio が対応するモデルファイル形式。Hugging Face からダウンロード可能。
  • host.docker.internal:Dockerコンテナ内からホスト OS (Mac本体)のサービスにアクセスするための特殊なホスト名。localhost では届かない。

参照