LANGFUSEのDockerコンテナによるデプロイメントガイド

概要

LANGFUSEは、大規模言語モデル（LLM）アプリケーション向けのオープンソースなエンジニアリングプラットフォームであり、観測性、評価ツール、プロンプト管理、プレイグラウンドUI、パフォーマンス指標分析などの主要機能を提供します。LLMとビジネスアプリケーション間の橋渡しとして、さまざまなモデルやフレームワークとの統合をサポートし、複雑なネスト構造にも対応しています。また、オープンAPIによりカスタム業務システムの構築も可能です。

企業でのLLM技術普及に伴い、迅速かつ信頼性の高いデプロイ手法が重要となっています。Dockerコンテナによるデプロイは、環境の一貫性、分離性、ポータビリティから、LANGFUSEの導入において最適な選択肢です。本記事では、Dockerを使用したLANGFUSEのデプロイ方法について、環境準備から本番環境の最適化まで詳しく解説します。

環境設定

Dockerのインストール

LANGFUSEコンテナを実行する前に、Docker環境が正しくインストールされていることを確認してください。推奨は、軒辕クラウドが提供するワンクリックインストールスクリプトで、Ubuntu、Debian、CentOS、Fedoraなどの主要Linuxディストリビューションに対応し、Dockerエンジン、Docker Composeおよび関連依存関係を自動的にインストール・設定します。

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

インストールに関する注意点:

スクリプトはOSタイプを自動検出し、それに合わせたインストールフローを実行します

sudo権限が必要なので、現在のユーザーがsudo実行可能であることを確認してください

インストール完了後、Dockerサービスが自動起動され、起動時に自動再開されるように設定されます

インストールが完了したら、以下のコマンドでDockerが正常に動作しているか確認します:

# Dockerバージョンの確認
docker --version

# Docker Composeバージョンの確認
docker compose version

# Dockerサービス状態の確認
systemctl status docker

`Docker version 26.0.0, build 2ae903e`のようなバージョン情報が出力され、サービス状態が`active (running)`であれば、インストールは成功しています。

加速設定が有効になっているか確認するには、Dockerデーモンの設定を確認します:

cat /etc/docker/daemon.json

正しく設定されていれば、`xxx.xuanyuan.run`イメージリポジトリを含む設定内容が表示されます。

イメージの準備

イメージの取得

LANGFUSEでは、最新の安定版（`latest`タグ）の使用を推奨しています。特定のバージョンを使用する場合は、LANGFUSEイメージタグリストから適切なタグを選択してください。

以下のコマンドでLANGFUSEイメージを取得します:

# 最新版の取得
docker pull xxx.xuanyuan.run/langfuse/langfuse:latest

# バージョン指定の場合（例：2.0バージョンの取得）
# docker pull xxx.xuanyuan.run/langfuse/langfuse:2.0

バージョン選定の推奨事項:

本番環境では、`latest`ではなく特定のメジャーバージョンタグ（例：`2`）を使用することを推奨します。これにより、自動アップグレードによる互換性問題を回避できます

すべての利用可能なバージョンと更新ログについては、LANGFUSEイメージタグリストを参照してください

イメージの検証

取得が完了したら、以下のコマンドでイメージが正常にダウンロードされたか確認します:

# ローカルイメージ一覧の確認
docker images | grep langfuse

# 出力例：
# xxx.xuanyuan.run/langfuse/langfuse   latest    abc12345   2 weeks ago   1.2GB

`xxx.xuanyuan.run/langfuse/langfuse`と対応するタグ情報が含まれていれば、イメージの取得は成功しています。さらに`docker inspect`コマンドで詳細情報を確認できます:

docker inspect xxx.xuanyuan.run/langfuse/langfuse:latest

このコマンドは、環境変数、公開ポート、エントリポイントコマンドなど、イメージの完全なメタデータを返すため、後のデプロイ設定に役立ちます。

コンテナのデプロイ

基本デプロイ（シングルコンテナモード）

LANGFUSEの基本デプロイでは、少なくともWebサービスポートをマッピングし、必要な環境変数を設定する必要があります。以下はテスト環境に適したクイックスタートコマンドです:

docker run -d \
  --name langfuse \
  --restart unless-stopped \
  -p 3000:3000 \  # Webサービスポートのマッピング（ホストポート:コンテナポート）
  -e NEXTAUTH_URL=http://localhost:3000 \  # アプリケーションアクセスアドレス
  -e DATABASE_URL=postgresql://postgres:postgres@host.docker.internal:5432/langfuse \  # データベース接続アドレス
  -e NEXTAUTH_SECRET=your-secure-secret-key \  # 認証キー（ランダム文字列を推奨）
  xxx.xuanyuan.run/langfuse/langfuse:latest

パラメータ説明:

`-d`: コンテナをバックグラウンドで実行

`--name langfuse`: コンテナ名を`langfuse`に指定

`--restart unless-stopped`: 手動で停止しない限り、コンテナ終了時に自動再起動

`-p 3000:3000`: コンテナの3000ポートをホストの3000ポートにマッピング（デフォルトのWebサービスポート）

`-e`: 環境変数の設定（詳細な環境変数は後述）

重要な環境変数の設定

LANGFUSEの実行には複数の重要な環境変数が必要です。以下は一般的な設定項目の説明です（完全なリストはLANGFUSEイメージドキュメント（軒辕）を参照）:

環境変数	説明	サンプル値
`NEXTAUTH_URL`	アプリケーションアクセスの基本URL（プロトコルとポートを含む）	`https://langfuse.example.com`
`NEXTAUTH_SECRET`	認証セッションを暗号化するためのキー。32文字以上を推奨	`$(openssl rand -hex 32)`
`DATABASE_URL`	データベース接続文字列（PostgreSQL必須）	`postgresql://user:pass@db:5432/langfuse`
`NEXT_PUBLIC_SITE_URL`	フロントエンドアクセスURL（通常`NEXTAUTH_URL`と一致）	`https://langfuse.example.com`
`LANGFUSE_ENABLE_SIGNUP`	ユーザー登録を許可するかどうか（本番環境では無効を推奨）	`false`
`LANGFUSE_CLOUD_MODE`	クラウドモードを有効にするかどうか（セルフホスティング環境では`false`）	`false`
`PORT`	コンテナ内のWebサービスポート（デフォルト3000）	`3000`

データベース設定（外部PostgreSQL）

LANGFUSEはPostgreSQLデータベースに依存して、追跡記録、評価結果、ユーザー設定などのコアデータを保存します。本番環境では、コンテナ内蔵データベースではなく、独立してデプロイされたPostgreSQLインスタンスの使用を推奨します。これにより、データの信頼性と拡張性が向上します。

1. PostgreSQLコンテナのデプロイ（例）

テスト用のPostgreSQLを素早くセットアップするには、以下のコマンドを使用します:

# PostgreSQLデータボリュームの作成（永続ストレージ）
docker volume create pgdata

# PostgreSQLコンテナの起動
docker run -d \
  --name langfuse-postgres \
  --restart unless-stopped \
  -p 5432:5432 \
  -v pgdata:/var/lib/postgresql/data \
  -e POSTGRES_USER=langfuse \
  -e POSTGRES_PASSWORD=secure-password \
  -e POSTGRES_DB=langfuse \
  xxx.xuanyuan.run/library/postgres:15  # PostgreSQL公式イメージ（単一段階イメージ名、libraryプレフィックスを使用）

2. LANGFUSEデータベース接続の設定

外部PostgreSQLを使用する場合、`DATABASE_URL`環境変数をデータベースインスタンスに合わせて調整する必要があります:

# 同一ホスト上のPostgreSQL接続（コンテナ名をホスト名として使用）
-e DATABASE_URL=postgresql://langfuse:secure-password@langfuse-postgres:5432/langfuse

# リモートPostgreSQL接続
# -e DATABASE_URL=postgresql://user:pass@remote-postgres.example.com:5432/langfuse

データ永続化の設定

コンテナの再起動によるデータ損失を防ぐために、LANGFUSEの重要なデータディレクトリをホストディレクトリまたはDockerデータボリュームにマウントする必要があります。LANGFUSEで永続化が必要な主なディレクトリには、ログ、アップロードファイルなどがあります（具体的なパスは`docker inspect`でイメージメタデータを確認できます）:

# ローカルデータディレクトリの作成
mkdir -p /opt/langfuse/logs /opt/langfuse/uploads

# コンテナ起動時のディレクトリマウント
docker run -d \
  --name langfuse \
  --restart unless-stopped \
  -p 3000:3000 \
  -v /opt/langfuse/logs:/app/logs \  # ログディレクトリ
  -v /opt/langfuse/uploads:/app/public/uploads \  # アップロードファイルディレクトリ
  -e NEXTAUTH_URL=http://localhost:3000 \
  -e NEXTAUTH_SECRET=$(openssl rand -hex 32) \
  -e DATABASE_URL=postgresql://langfuse:secure-password@langfuse-postgres:5432/langfuse \
  xxx.xuanyuan.run/langfuse/langfuse:latest

Docker Composeによる編成（本番環境推奨）

複数コンポーネントのデプロイ（例：LANGFUSE + PostgreSQL）には、Docker Composeを使用してコンテナを統一管理することを推奨します。以下のように`docker-compose.yml`ファイルを作成します:

version: '3.8'

services:
  langfuse:
    image: xxx.xuanyuan.run/langfuse/langfuse:latest
    container_name: langfuse
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - NEXTAUTH_URL=http://localhost:3000
      - NEXTAUTH_SECRET=${NEXTAUTH_SECRET}  # 環境変数から読み取り、ハードコードを避ける
      - DATABASE_URL=postgresql://langfuse:${DB_PASSWORD}@postgres:5432/langfuse
      - LANGFUSE_ENABLE_SIGNUP=false
      - LANGFUSE_CLOUD_MODE=false
    volumes:
      - langfuse-logs:/app/logs
      - langfuse-uploads:/app/public/uploads
    depends_on:
      - postgres  # データベースが先に起動することを保証
    networks:
      - langfuse-network

  postgres:
    image: xxx.xuanyuan.run/library/postgres:15  # PostgreSQL公式イメージ
    container_name: langfuse-postgres
    restart: unless-stopped
    environment:
      - POSTGRES_USER=langfuse
      - POSTGRES_PASSWORD=${DB_PASSWORD}
      - POSTGRES_DB=langfuse
    volumes:
      - pgdata:/var/lib/postgresql/data
    networks:
      - langfuse-network
    healthcheck:  # データベースヘルスチェック
      test: ["CMD-SHELL", "pg_isready -U langfuse -d langfuse"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  langfuse-logs:
  langfuse-uploads:
  pgdata:

networks:
  langfuse-network:
    driver: bridge

機密情報を格納する`.env`ファイルを作成します（バージョン管理にコミットしないでください）:

# .env ファイル
NEXTAUTH_SECRET=your-32-character-secure-secret-here
DB_PASSWORD=your-secure-postgres-password

以下のコマンドでサービスを起動します:

# すべてのサービスを起動（バックグラウンド実行）
docker compose up -d

# サービス状態の確認
docker compose ps

# ログの確認
docker compose logs -f

機能テスト

サービス可用性の検証

デプロイが完了したら、以下の手順でLANGFUSEサービスが正常に動作しているか検証します:

1. コンテナ状態の確認

# コンテナ実行状態の確認
docker ps | grep langfuse

# 出力例（状態はUpであるべき）：
# abc123456789   xxx.xuanyuan.run/langfuse/langfuse:latest   "docker-entrypoint.s…"   5 minutes ago   Up 5 minutes   0.0.0.0:3000->3000/tcp   langfuse

状態が`Exited`の場合、ログでエラーを調査します:

docker logs langfuse

2. Webインターフェースへのアクセス

ブラウザで`http://サーバーIP:3000`（または設定された`NEXTAUTH_URL`）にアクセスすると、LANGFUSEのログインページが表示されるはずです。初回ログインではデフォルトの管理者アカウントを使用します（詳細な認証情報はLANGFUSEイメージドキュメント（軒辕）を参照）。

3. APIインターフェースのテスト

`curl`またはPostmanを使用してLANGFUSE APIの可用性をテストします（APIキーはまずWebインターフェースの「設定 > APIキー」で作成してください）:

# APIヘルスチェックインターフェースのテスト
curl -X GET http://サーバーIP:3000/api/health \
  -H "Content-Type: application/json"

# 期待されるレスポンス：{"status":"ok","version":"x.y.z"}

コア機能の検証

1. プロジェクトの作成

ログイン後、Webインターフェースで「New Project」をクリックしてテストプロジェクトを作成し、プロジェクト名と説明を入力して、プロジェクト作成機能が正常に動作するか検証します。

2. 追跡イベントの送信

以下のコード例（Python）を使用してLANGFUSEにテスト追跡イベントを送信し、データ受信機能を検証します:

from langfuse import Langfuse

# クライアントの初期化（APIキーはWebインターフェースから取得）
langfuse = Langfuse(
    public_key="pk-xxx",
    secret_key="sk-xxx",
    host="http://サーバーIP:3000"  # セルフホスティングインスタンスアドレス
)

# 追跡イベントの作成
trace = langfuse.trace(
    name="test-trace",
    input="Hello LANGFUSE"
)

# 生成コンテンツの追加
generation = trace.generation(
    name="test-generation",
    input="Hello",
    output="World",  
    model="test-model"
)

# イベントの送信
trace.submit()

Webインターフェースの「Traces」ページでこのイベントが受信されているか確認し、データ保存と表示機能を検証します。

3. 評価機能のテスト

プロジェクト内で評価セット（Evaluation Set）を作成し、テストケースを追加して評価を実行し、評価プロセスが正常に動作するか検証します:

プロジェクト > Evaluations > New Evaluation Set に進む
テストケースの追加（入力、期待出力、評価基準）
評価の実行と結果レポートの確認

本番環境の推奨事項

セキュリティ強化

1. ネットワーク分離とポート制限

パブリックネットワークへの直接公開を禁止: リバースプロキシ（Nginx、Traefikなど）を介してサービスを公開し、コンテナポートをパブリックネットワークに直接マッピングしない
カスタムネットワークの使用: Dockerカスタムネットワークを通じてLANGFUSEとデータベースを分離し、必要なポートのみを公開

# docker-compose.yml ネットワーク設定例
networks:
  langfuse-network:
    driver: bridge
    internal: false  # 外部ネットワークへのアクセスを許可（更新、外部APIなど）

2. 機密情報の管理

環境変数の暗号化: Docker Secrets（Swarmモード）または外部シークレット管理サービス（HashiCorp Vaultなど）を使用して機密情報を保存し、平文の環境変数を避ける
APIキーのローテーション: 定期的にAPIキーをローテーションし、Webインターフェースの「設定 > APIキー」で操作
データベースアクセス制御: データベースへのアクセスをLANGFUSEコンテナのみに制限し、ネットワークポリシーやファイアウォールで実現

3. HTTPS設定

本番環境ではHTTPSによる暗号化通信を必ず有効化し、リバースプロキシを通じて実装することを推奨します:

Nginx設定例:

server {
    listen 80;
    server_name langfuse.example.com;
    return 301 https://$host$request_uri;  # HTTPをHTTPSにリダイレクト
}

server {
    listen 443 ssl;
    server_name langfuse.example.com;

    ssl_certificate /etc/nginx/certs/fullchain.pem;  # SSL証明書パス
    ssl_certificate_key /etc/nginx/certs/privkey.pem;

    # プロキシ設定
    location / {
        proxy_pass http://langfuse:3000;  # LANGFUSEコンテナを指す
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

パフォーマンス最適化

1. リソース制限と調整

コンテナに適切なリソース制限を設定し、リソース枯渇や過剰消費を防ぎます:

# docker-compose.yml リソース制限設定
services:
  langfuse:
    # ... その他の設定
    deploy:
      resources:
        limits:
          cpus: '2'  # CPU制限
          memory: 4G  # メモリ制限
        reservations:
          cpus: '1'  # CPU予約
          memory: 2G  # メモリ予約

2. データベースの最適化

接続プールの使用: PostgreSQL接続プール（PgBouncerなど）を設定し、接続の再利用率を向上
定期バックアップ: データベースの定期バックアップ戦略を設定し、`pg_dump`やツール（pgBackRestなど）を使用
インデックスの最適化: クエリパターンに応じてデータベースインデックスを最適化、特に`traces`、`generations`などの大規模テーブル

3. キャッシュ戦略

Redisキャッシュを有効にしてLANGFUSEのパフォーマンスを向上させ、データベースへのアクセス負荷を軽減します:

# Redisコンテナの起動
docker run -d \
  --name langfuse-redis \
  --restart unless-stopped \
  -v redisdata:/data \
  xxx.xuanyuan.run/library/redis:7  # Redis公式イメージ（単一段階イメージ名）

# LANGFUSEでRedisを使用する設定（環境変数の追加）
-e REDIS_URL=redis://langfuse-redis:6379

監視と運用

1. ログ管理

集中ログ: ELK Stack（Elasticsearch, Logstash, Kibana）またはLokiを使用してコンテナログを集約
ログローテーション: Dockerログドライバのローテーション戦略を設定し、ログファイルが大きくなりすぎるのを防止

// /etc/docker/daemon.json ログ設定
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

2. パフォーマンス監視

コンテナ監視: Prometheus + Grafanaを使用してコンテナのCPU、メモリ、ネットワークなどの指標を監視
アプリケーション監視: LANGFUSEの組み込みmetricsインターフェース（`/api/metrics`）を有効化し、Prometheusでの取得を設定

# prometheus.yml 設定例
scrape_configs:
  - job_name: 'langfuse'
    static_configs:
      - targets: ['langfuse:3000']  # LANGFUSEコンテナアドレス

3. 自動更新とロールバック

バージョン管理: 本番環境では`latest`ではなく固定バージョンタグ（例：`2.0`）を使用し、ロールバックを容易にする
自動デプロイ: CI/CDパイプライン（GitHub Actions、GitLab CIなど）を通じてイメージの取得、テスト、デプロイを自動化

トラブルシューティング

よくある問題と解決策

1. コンテナ起動失敗

症状: `docker ps`でコンテナ状態が`Exited`となり、ログにエラーが表示される。

調査手順:

コンテナログの確認: `docker logs langfuse`
環境変数の確認: `DATABASE_URL`、`NEXTAUTH_SECRET`などの重要な変数が正しく設定されているか確認
ポート占有の確認: `netstat -tulpn | grep 3000`でポートが占有されていないか確認

一般的な原因と解決策:

データベース接続失敗: データベースアドレス、ユーザー名、パスワードが正しいか、データベースにアクセス可能か検証
キー長不足: `NEXTAUTH_SECRET`は32文字以上必要で、`openssl rand -hex 32`で生成
権限問題: マウントディレクトリの権限が不十分で、`chmod -R 775 /opt/langfuse`で権限を付与

2. Webインターフェースにアクセスできない

症状: `http://サーバーIP:3000`にアクセスしても応答がない、または502エラーが表示される。

調査手順:

コンテナ状態とログの確認
ポートマッピングの検証: `docker port langfuse`でポートマッピングが正しいか確認
ファイアウォールルールの確認: `ufw status`または`firewalld-cmd --list-ports`でポートが開放されているか確認

一般的な原因と解決策:

リバースプロキシ設定エラー: プロキシのターゲットアドレスとポートがLANGFUSEコンテナを指しているか確認
SSL証明書問題: HTTPS設定エラーによりページが読み込めず、ブラウザの開発者ツールのネットワーク/コンソールタブで確認
NEXTAUTH_URL不一致: `NEXTAUTH_URL`がアクセスURLと一致しているか、プロトコル（http/https）を含めて確認

3. データ永続化失敗

症状: コンテナ再起動後にデータが消失、またはログファイルがマウントディレクトリに書き込まれない。

調査手順:

データボリュームマウントの確認: `docker inspect langfuse | grep Mounts`でマウント設定が正しいか確認
ディレクトリ権限の確認: `ls -ld /opt/langfuse`でホストディレクトリの権限がDocker書き込みを許可しているか確認

解決策:

マウントパスの修正: `-v`パラメータのホストパスが存在し、スペルが正しいことを確認
ディレクトリ権限の調整: `chown -R 1000:1000 /opt/langfuse`を実行（コンテナ内のユーザーUID/GIDが1000と仮定）

4. API呼び出し失敗

症状: クライアントがAPIを呼び出す際に401/403エラーまたは応答なしを返す。

調査手順:

APIキーの確認: 公開鍵/秘密鍵が正しく、期限切れや失効していないか確認
リクエストヘッダーの検証: 正しい`Content-Type`と認証ヘッダーが含まれているか確認
アプリケーションログの確認: `docker logs langfuse | grep API`で関連エラー情報を検索

一般的な原因と解決策:

キー権限不足: APIキー作成時に十分な権限（例：`trace:write`、`evaluation:read`）を付与
クロスオリジン設定問題: フロントエンドからの呼び出しでクロスオリジンエラーが発生し、リバースプロキシでCORSヘッダーを設定

# Nginx CORS設定例
location /api/ {
    proxy_pass http://langfuse:3000/api/;
    add_header Access-Control-Allow-Origin "https://frontend.example.com";
    add_header Access-Control-Allow-Methods "GET, POST, OPTIONS";
    add_header Access-Control-Allow-Headers "Content-Type, Authorization";
}

高度なトラブルシューティングツール

1. Docker組み込みツール

コンテナ内部検査: コンテナに入り実行環境を確認

docker exec -it langfuse /bin/bash

コンテナリソース使用量監視: コンテナリソース使用量をリアルタイムで確認

docker stats langfuse

2. データベーストラブルシューティング

データベース接続: PostgreSQLに直接接続してデータを確認

docker exec -it langfuse-postgres psql -U langfuse -d langfuse

# テーブル構造の確認
\dt

# 追跡データの確認
SELECT * FROM traces LIMIT 10;

3. ネットワークパケットキャプチャ

`tcpdump`を使用してコンテナ内でパケットをキャプチャし、ネットワークリクエストの問題を分析します:

# コンテナ内でtcpdumpをインストール（一時的）
docker exec -it langfuse apt-get update && apt-get install -y tcpdump

# ポート3000のパケットキャプチャ
docker exec -it langfuse tcpdump -i any port 3000 -w /tmp/traffic.pcap

# ホストにコピーして分析
docker cp langfuse:/tmp/traffic.pcap /local/path/

参考リソース

公式ドキュメントとイメージ情報

LANGFUSEイメージドキュメント（軒辕）：軒辕イメージステーションが提供するLANGFUSEイメージの説明と設定ガイド
LANGFUSEイメージタグリスト：すべての利用可能なイメージバージョンとタグ情報
Docker公式ドキュメント：Dockerの基本概念、コマンド、およびベストプラクティス

コミュニティリソース

LANGFUSE GitHubリポジトリ：ソースコード、Issueトラッキング、および貢献ガイド
LANGFUSE Discord：コミュニティサポートとディスカッション
Docker Hub公式イメージ：公式イメージリポジトリ

まとめ

本記事では、LANGFUSEのDockerコンテナによるデプロイメント方法を詳しく紹介しました。環境準備、イメージ取得、コンテナデプロイから機能テストまでをカバーし、シングルコンテナのクイックデプロイとマルチコンテナの本番環境設定、さらにセキュリティ強化、パフォーマンス最適化、監視運用、トラブルシューティングの実践ガイドを提供しています。Dockerコンテナによるデプロイにより、LANGFUSEの環境依存の複雑さを大幅に低減し、デプロイの一貫性と保守性を向上させることができます。

重要なポイント

イメージ取得ルール: LANGFUSEイメージは軒辕加速アドレス形式`docker pull xxx.xuanyuan.run/langfuse/langfuse:{TAG}`を使用
環境変数設定: `NEXTAUTH_SECRET`、`DATABASE_URL`は必須設定で、本番環境ではランダムキーと外部データベースを使用
データ永続化: Dockerデータボリュームまたはホストディレクトリのマウントにより、ログ、設定などのデータ永続化を確保
セキュリティのベストプラクティス: コンテナポートをパブリックネットワークに直接公開せず、リバースプロキシとHTTPSを使用し、APIキーを定期的にローテーション
監視とメンテナンス: ログローテーション、パフォーマンス監視、データベースバックアップを設定し、サービスの安定稼働を確保

今後の推奨事項

高度な機能の学習: LANGFUSEのカスタム評価指標、バッチインポート/エクスポート、高度なフィルタリングなどの機能を深く学び、業務シーンに合わせてカスタマイズ
パフォーマンスチューニング: 実際の業務負荷に応じてコンテナリソース、データベース設定、キャッシュ戦略を調整し、システム応答速度を最適化
災害対策: ノード間/リージョン間の高可用性デプロイアーキテクチャを設計し、データバックアップ戦略と組み合わせて業務継続性を確保
コミュニティ参加: GitHubでコード貢献や問題フィードバックを行い、LANGFUSEコミュニティ建設に参加し、最新機能とベストプラクティスを取得

参考リンク

LANGFUSEイメージドキュメント（軒辕）
LANGFUSEイメージタグリスト
Docker公式ドキュメント
PostgreSQL公式ドキュメント

タグ: LANGFUSE Docker PostgreSQL コンテナ化 LLM

8月29日 23:11 投稿

異端開発室

LANGFUSEのDockerコンテナによるデプロイメントガイド

概要

環境設定

Dockerのインストール

イメージの準備

イメージの取得

イメージの検証

コンテナのデプロイ

基本デプロイ（シングルコンテナモード）

重要な環境変数の設定

データベース設定（外部PostgreSQL）

1. PostgreSQLコンテナのデプロイ（例）

2. LANGFUSEデータベース接続の設定

データ永続化の設定

Docker Composeによる編成（本番環境推奨）

機能テスト

サービス可用性の検証

1. コンテナ状態の確認

2. Webインターフェースへのアクセス

3. APIインターフェースのテスト

コア機能の検証

1. プロジェクトの作成

2. 追跡イベントの送信

3. 評価機能のテスト

本番環境の推奨事項

セキュリティ強化

1. ネットワーク分離とポート制限

2. 機密情報の管理

3. HTTPS設定

パフォーマンス最適化

1. リソース制限と調整

2. データベースの最適化

3. キャッシュ戦略

監視と運用

1. ログ管理

2. パフォーマンス監視

3. 自動更新とロールバック

トラブルシューティング

よくある問題と解決策

1. コンテナ起動失敗

2. Webインターフェースにアクセスできない

3. データ永続化失敗

4. API呼び出し失敗

高度なトラブルシューティングツール

1. Docker組み込みツール

2. データベーストラブルシューティング

3. ネットワークパケットキャプチャ

参考リソース

公式ドキュメントとイメージ情報

関連ツールと統合

コミュニティリソース

まとめ

重要なポイント

今後の推奨事項

参考リンク

ホットタグ