🐈

VPSで「認証つきDify環境」を作る④:ChatbotUIをVPSで動かす

に公開
2025/11/19

💡 この記事はシリーズ④です。
前回ではSupabaseの設定とテーブル作成を行いました。
今回は、ChatbotUIをXserver VPS上に配置し、Dify/Supabaseと連携させていきます。


④ChatbotUIをVPSで動かす

ここからは ChatbotUI を Xserver VPS 上で動かし、 Dify と Supabase へ接続していきます。


1.ChatbotUIを配置する(Node.js/Git → クローン → 依存 → 環境変数)

ChatbotUIは Next.js 製のWebアプリです。
まずは必要なパッケージを入れて、環境を整えます。

# 1) Node.js & Git のインストール
sudo apt-get update
sudo apt-get install -y curl git
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v && npm -v   # ← バージョン表示で確認

# 2) ChatbotUI の取得
cd /opt
sudo git clone https://github.com/mckaywrigley/chatbot-ui.git
cd chatbot-ui

# 3) 依存ライブラリのインストール
sudo npm i

続いて、ChatbotUIの設定情報を .env に書き込みます。

sudo nano /opt/chatbot-ui/.env

下を貼り、先ほどコピーしておいた値に置き換えて保存(Ctrl+O → Enter、Ctrl+X):

# Supabase
NEXT_PUBLIC_SUPABASE_URL=https://xxxxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=あなたのanon key
SUPABASE_SERVICE_ROLE_KEY=あなたのservice_role key  # サーバ専用(絶対に公開しない)

# Dify(自己ホストのURL)
DIFY_BASE_URL=https://www.example.com

# Next.js
NODE_ENV=production

※SUPABASE_SERVICE_ROLE_KEY は「何でもできる鍵」です。Gitに上げない&ブラウザに出さない、が絶対のルール。サーバ側のコードだけで使います。


2.Supabaseの“初期SQL”を適用(マイグレーション)

ChatbotUI リポジトリには、Supabase向けのSQLファイルが用意されています。
これは 認証テーブルや会話履歴テーブルなどを自動生成するための設計書 です。
ここで一気に適用していきます。

💡 マイグレーション(migration)とは
データベース構造(テーブル・列など)をプログラムで管理する仕組みです。
ChatbotUIには /supabase/migrations/ フォルダがあり、その中の .sql ファイルがすべて「DB設計書」になっています。

では早速作業にとりかかりましょう。セットアップのSQLを開いて接続先を書き換えます。
まずは以下のファイルをひらきます。

sudo nano /opt/chatbot-ui/supabase/migrations/20240108234540_setup.sql

その中の53–54行目 を自分の値に変更します。

project_url TEXT := 'https://xxxxx.supabase.co';   -- Data API の Project URL
service_role_key TEXT := 'あなたの service_role key';

project_url TEXTとservice_role_key TEXTには、SupaBaseのダッシュボードでコピーしたproject_urlとservice_role keyを入れてください。

続いて、用意されているSQL を Supabase に流し込む作業です。
ターミナルで以下を実行。

awk 'FNR==1{print "\n-- -----------------------\n"}{print}' \
  /opt/chatbot-ui/supabase/migrations/*.sql > /tmp/all_migrations.sql
cat /tmp/all_migrations.sql  

中身をコピーして SQL Editor へペーストすれば完了です。

「Success. No rows returned」と表示されればOKです。


3.“つなぎ”APIを作る(安全な一覧API/Dify中継API)

次に、サーバ側の“つなぎ”APIを追加します。これは、鍵を守るためのもの。ブラウザに service_role key を出さず、サーバで代理アクセスします。ここからはChatbotUIをゴリゴリ編集します。

まずはライブラリを追加します。

cd /opt/chatbot-ui
sudo npm i @supabase/supabase-js @supabase/auth-helpers-nextjs

続いて、①~⑤のファイルを作ります。
次に、サーバ側の“つなぎ”APIを追加します。これは、鍵を守るためのもの。ブラウザに service_role key を出さず、サーバで代理アクセスします。ここからはChatbotUIをゴリゴリ編集します。

まずはライブラリを追加します。

cd /opt/chatbot-ui
sudo npm i @supabase/supabase-js @supabase/auth-helpers-nextjs

続いて、①~⑤のファイルを作ります。

①サーバ(管理)用クライアントを用意。

●ディレクトリ作成&ファイル作成

sudo mkdir -p /opt/chatbot-ui/lib
sudo nano /opt/chatbot-ui/lib/supabaseAdmin.ts

●中身は以下のコピペしてください。

import { createClient } from '@supabase/supabase-js';

export const supabaseAdmin = createClient(
  process.env.NEXT_PUBLIC_SUPABASE_URL!,
  process.env.SUPABASE_SERVICE_ROLE_KEY!, // server only(公開厳禁)
  { auth: { persistSession: false, autoRefreshToken: false } }
);

②ブラウザ用クライアントを作る

●ディレクトリ作成&ファイル作成

sudo nano /opt/chatbot-ui/lib/supabaseBrowser.ts

●中身は以下のコピペしてください。

'use client';
import { createClient } from '@supabase/supabase-js';

export const supabaseBrowser = createClient(
  process.env.NEXT_PUBLIC_SUPABASE_URL!,
  process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!
);

③公開して良い列だけの一覧APIを作る

●ディレクトリ作成&ファイル作成

sudo mkdir -p /opt/chatbot-ui/app/api/chats
sudo nano /opt/chatbot-ui/app/api/chats/route.ts

●中身は以下のコピペしてください。

import { NextResponse } from 'next/server';
import { supabaseAdmin } from '../../../lib/supabaseAdmin';

export async function GET() {
  const { data, error } = await supabaseAdmin
    .from('dify_apps')
    .select('slug, display_name, default_inputs, is_active')
    .eq('is_active', true)
    .order('display_name');

  if (error) return NextResponse.json({ error: error.message }, { status: 500 });
  return NextResponse.json(data ?? []);
}

④「Difyへストリーミング中継」APIを作る

Supabaseのログイン済みを確認し、DBからapi_keyをサーバ側で取得→DifyへSSE中継します。
●ディレクトリ作成&ファイル作成

sudo mkdir -p /opt/chatbot-ui/app/api/dify/stream
sudo nano /opt/chatbot-ui/app/api/dify/stream/route.ts

●中身は以下のコピペしてください。

'use client';
import { createClient } from '@supabase/supabase-js';

export const supabaseBrowser = createClient(
  process.env.NEXT_PUBLIC_SUPABASE_URL!,
  process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!
);

⑤“テスト用ページ”を作る

●ディレクトリ作成&ファイル作成

sudo mkdir -p /opt/chatbot-ui/app/'[locale]'/dify-test
sudo nano /opt/chatbot-ui/app/'[locale]'/dify-test/page.tsx

●中身は以下のコピペしてください。

'use client';
import { useEffect, useRef, useState } from 'react';
import { supabaseBrowser } from '@/lib/supabaseBrowser';

type Chat = { slug: string; display_name: string; default_inputs?: any };

export default function DifyTest() {
  const [chats, setChats] = useState<Chat[]>([]);
  const [slug, setSlug] = useState('');
  const [text, setText] = useState('');
  const [inputs, setInputs] = useState('{"lang":"ja"}');
  const [output, setOutput] = useState('');
  const lock = useRef(false);

  useEffect(() => {
    fetch('/api/chats').then(r => r.json()).then(setChats);
  }, []);

  async function send() {
    if (lock.current) return;
    setOutput('');
    lock.current = true;

    const { data: sessionData } = await supabaseBrowser.auth.getSession();
    const accessToken = sessionData?.session?.access_token;

    const messages = [{ role: 'user', content: text }];
    const body = { chatSlug: slug, messages, inputs: safeParseJSON(inputs) ?? {} };

    const res = await fetch('/api/dify/stream', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        ...(accessToken ? { Authorization: `Bearer ${accessToken}` } : {})
      },
      body: JSON.stringify(body)
    });


    if (!res.ok || !res.body) {
      setOutput('送信に失敗(ログインしてない可能性も)');
      lock.current = false; return;
    }

    const reader = res.body.getReader();
    const decoder = new TextDecoder();
    while (true) {
      const { value, done } = await reader.read();
      if (done) break;
      setOutput(prev => prev + decoder.decode(value));
    }
    lock.current = false;
  }

  function safeParseJSON(s: string) {
    try { return JSON.parse(s); } catch { return null; }
  }

  return (
    <div className="max-w-2xl mx-auto p-4 space-y-4">
      <h1 className="text-xl font-bold">Dify テスト</h1>

      <label className="block">
        <div className="mb-1">① チャットを選択</div>
        <select className="border rounded p-2 w-full" value={slug} onChange={e => setSlug(e.target.value)}>
          <option value="">-- 選択してください --</option>
          {chats.map(c => <option key={c.slug} value={c.slug}>{c.display_name}</option>)}
        </select>
      </label>

      <label className="block">
        <div className="mb-1">② 初期値 inputs(JSON)※空でもOK</div>
        <textarea className="border rounded p-2 w-full font-mono" rows={4}
          value={inputs} onChange={e => setInputs(e.target.value)} />
      </label>

      <label className="block">
        <div className="mb-1">③ メッセージ</div>
        <input className="border rounded p-2 w-full" value={text} onChange={e => setText(e.target.value)}
          placeholder="こんにちは" />
      </label>

      <button onClick={send} disabled={!slug || !text}
        className="bg-black text-white rounded px-4 py-2 disabled:opacity-50">送信</button>

      <div>
        <div className="mb-1">④ 応答(ストリーミング)</div>
        <pre className="border rounded p-2 whitespace-pre-wrap">{output}</pre>
      </div>
    </div>
  );
}

ここまで、①~⑤のファイルを作ったら、ビルドして型エラーをチェックします。
●ビルドして型エラーをチェック

cd /opt/chatbot-ui
npm run build

4.Nginxの設定と疎通テスト

ここでは、ChatbotUI(chat.example.com)を外部公開する設定を行います。今回の構成では、Dify は example.com で既に稼働中。そのため、新しくNginxを立てるのではなく、Xサーバー(VPS)上にある既存の Nginx(Dify用)に設定を追加していきます。

つまり、以下の2つのドメインを、同じ VPS の中で共存させる形です。
・example.com → Dify(既存)
・chat.example.com → ChatbotUI(今回追加)

また、今回はローカル開発環境ではなく、XサーバーのVPS本番環境を直接操作しています。そのため、Nginx の設定ファイルやSSL証明書の発行も、VPS上で直接行います。

ここでは、次の6つを順に進めます。
①ChatbotUI(Next.js)をサーバー上で起動できるようにする
②既存の Nginx に chat.example.com の設定を追加してプロキシする
③Let’s Encrypt(Certbot)を使って HTTPS を有効化する
④コンテナ内で証明書を発行
⑤e_chat.conf に サーバブロック を追加
⑥疎通テスト→ブラウザ確認

①ChatbotUI(Next.js)をサーバー上で起動できるようにする

cd /opt/chatbot-ui
npm run start -- -H 0.0.0.0 -p 3000

②既存の Nginx に chat.example.com の設定を追加してプロキシする

●ディレクトリ作成&ファイル作成

sudo nano /root/dify/docker/nginx/conf.d/e_chat.conf

※Xサーバーが用意しているのは「default.conf」です。Nenginxはファイル名順に読むので、dよりも後ろになるように、「e_chat.conf」としています。

●中身は以下のコピペしてください。まずは、HTTPだけ。

server {
  listen 80;
  server_name chat.example.com;

  location / {
    proxy_pass http://172.17.0.1:3000;   # コンテナ→ホスト:3000
    include proxy.conf;                  # 既存の共通ヘッダー
    add_header X-Accel-Buffering no;     # SSEのバッファ無効化
  }
}

●構文テスト

docker exec docker-nginx-1 nginx -t

問題なければ以下のように表示がでます。
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

●リロードと疎通テスト

docker exec docker-nginx-1 nginx -s reload
docker exec -it docker-nginx-1 curl -I http://172.17.0.1:3000/ja/dify-test

Nginxコンテナ→Next.jsにつながるかテストします。まずはHTTPでのみ確認。
200OKが返ってくれば大丈夫。

ここまで進んだら、Next.jsはいったん止めてしまってよいので、Ctrl+Cでストップします。

③Let’s Encrypt(Certbot)を使って HTTPS を有効化する

e_chat.conf に ACME 用の location を追加
先ほど作ったe_chat.confに、一行追記します。

●ファイル編集

sudo nano /root/dify/docker/nginx/conf.d/e_chat.conf

●「+」部分を追記して保存。

server {
  listen 80;
  server_name chat.example.com;

+  location /.well-known/acme-challenge/ { root /var/www/html; }

  location / {
    proxy_pass http://172.17.0.1:3000;
    include proxy.conf;
    add_header X-Accel-Buffering no;
  }
}

●テスト&リロード

docker exec docker-nginx-1 nginx -t
docker exec docker-nginx-1 nginx -s reload

エラーがでなければ次へ。

④コンテナ内で証明書を発行

●コンテナに入ってフォルダを作る。

docker exec -it docker-nginx-1 bash
mkdir -p /etc/ssl/certs

●certbot を入れる

apt-get update
apt-get install -y certbot

●webroot でSSL証明書を発行

certbot certonly --webroot -w /var/www/html -d chat.example.com --email you@example.com --agree-tos --no-eff-email

※chat.example.comのところはあなたの使うサブドメインを入れてください。
※you@example.comはあなたのメールアドレスを入れてください。
 これはLet's Encrypt(Certbotの裏で動いている無料のSSL証明書サービス)に登録するメールアドレスです。Let's Encryptの証明書は通常90日間有効です。期限が近づくと、指定したメールアドレスに「更新してください」という通知が届きます。また、セキュリティの通知なども届く可能性がありますので、常にチェックできるメールアドレスを設定しましょう。

●成功したら存在確認

ls -l /etc/letsencrypt/live/chat.example.com/

※chat.example.comのところはあなたの使うサブドメインを入れてください。
4つのファイルがみえていて、fullchain.pem / privkey.pemがあればOKです。

●ドッカーの外に出ます

exit

⑤e_chat.conf に サーバブロック を追加

先ほど作ったe_chat.confに、さらに「+」が付いた行を追記します。

●ファイル編集

sudo nano /root/dify/docker/nginx/conf.d/e_chat.conf

●「+」部分を追記して保存。(Ctrl+O → Enter、Ctrl+X で閉じる)。

server {
  listen 80;
  server_name chat.example.com;

  location /.well-known/acme-challenge/ { root /var/www/html; } 

  location / {
    proxy_pass http://172.17.0.1:3000;
    include proxy.conf;
    add_header X-Accel-Buffering no;
  }
}

+ server {
+   listen 443 ssl;
+   http2 on;
+   server_name chat.example.com;
+
+   ssl_certificate     /etc/letsencrypt/live/chat.example.com/fullchain.pem;
+   ssl_certificate_key /etc/letsencrypt/live/chat.example.com/privkey.pem;
+ 
+   location / {
+     proxy_pass http://172.17.0.1:3000;
+     include proxy.conf;
+     add_header X-Accel-Buffering no;
+   }
+
+   location /.well-known/acme-challenge/ { root /var/www/html; }
+ }

※chat.example.comのところはあなたの使うサブドメインを入れてください。

●テスト&リロード

docker exec docker-nginx-1 nginx -t
docker exec docker-nginx-1 nginx -s reload

⑥疎通テスト→ブラウザ確認

先ほど、Next.js をストップしている場合には、ここで起動しておきます。
※別画面でコマンドプロンプトを立ち上げて。

cd /opt/chatbot-ui
npm run start -- -H 0.0.0.0 -p 3000

●疎通テスト

curl -I https://chat.example.com/ja/dify-test

200OKが返ってくれば大丈夫。

●ブラウザ確認
ブラウザで https://chat.example.com にアクセスします。
ここでログイン画面がでてくるのでメールアドレスとパスワードを入れてサインアップ。
前章で作ったユーザーのメールアドレスとパスワードでログインします。

ログイン後にいろいろと聞かれますが、スルーして大丈夫。
右下の「User Settings」からAPIキーを登録。ここではGeminiのAPIキーを設定しました。

で、ひとこと会話してみます。

会話が成立していればOKです。

次に、さきほど作った下層ページにアクセス→https://chat.example.com/ja/dify-test
そうすると、以下のような、Difyテスト画面が表示されます。

ここで、チャットを選択して、メッセージに「こんにちは」と入力→「送信」をクリック。

そうすると、④応答(ストリーミング)に、長々とコードがでてきます。
とりあえずのテストなので、現状はこのままでOK。

ここまでで、下準備とテストはいったん終了。
いよいよ、本番用の設定に入っていきます。


🚀 まとめ

ここまでで、ChatbotUIをVPSに導入し、DifyとSupabaseを連携できました。
次章では、DifyアプリをChatbotUIのモデル選択画面に表示し、本格的な設定に入っていきます。


🪄 次の記事:
VPSで「認証つきDify環境」を作る⑤:Difyアプリを「Customモデル」としてUIに出す

Discussion