クイックスタートガイド

この翻訳は、新しい安全なアクティベーションおよびデプロイ管理より前の内容です。更新されるまでは英語版ガイドを使用してください。

もっと簡単な方法をお探しですか? デスクトップインストーラーを使えば、ワンクリックで自動構成のデプロイが可能です。コマンドラインは不要です！

前提条件

始める前に、システムに以下がインストールされていることを確認してください:

Docker Engine (20.10.0 以上)
Docker Compose (v2.0.0 以上)
OpenSSL (SSL 証明書の生成用)

Docker のインストール

macOS の場合:

Docker Hub から Docker Desktop をダウンロードしてインストールします
インストールウィザードに従います
インストールを確認します:

docker --version
docker compose --version

Linux (Ubuntu/Debian) の場合:

# パッケージインデックスを更新
sudo apt-get update

# 前提パッケージをインストール
sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

# Docker の公式 GPG キーを追加
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# 安定版リポジトリを設定
echo \
  "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Docker Engine をインストール
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

# ユーザーを docker グループに追加
sudo usermod -aG docker $USER

Windows の場合:

Docker Hub から Docker Desktop をダウンロードしてインストールします
Docker のドキュメントに従って WSL 2 を有効にします
インストールウィザードに従います
PowerShell でインストールを確認します:

docker --version
docker compose --version

ステップ 1: プロジェクトディレクトリの作成

CaseBender のデプロイ用に新しいディレクトリを作成し、そこに移動します:

mkdir casebender-deployment
cd casebender-deployment

ステップ 2: 環境変数の設定

以下の内容で .env ファイルを作成します:

# 認証
AUTH_SECRET="B7OawnWf6+LwB/9yXbxbk4ppZ1khydqj4qc9k9g3nnE="
AUTH_SALT="B7OawnW"
AUTH_TRUST_HOST=true
NEXTAUTH_URL=https://local.casebender.com
NEXTAPP_URL=https://local.casebender.com

# ライセンス（任意）
# CaseBender は初回起動時にライセンス秘密鍵を自動生成して永続化し（"casebender_secret"
# ボリュームに保存）、再起動やアップデート後も自動的に再利用します。操作は不要です。
# 鍵を自分で管理したい場合（バックアップ、ローテーション、レプリカ間での共有）にのみ
# LICENSE_SECRET_KEY を設定してください。次のコマンドで生成できます: openssl rand -hex 32
# LICENSE_SECRET_KEY=

# Liveblocks の設定 (リアルタイムコラボレーション)
LIVEBLOCKS_SECRET_KEY=sk_dev_HaIczPV4gPit5_gx7YRsNXLGJNzBE5wQ8z8I1H8ft3ZPZHVrfH2ryJJ586ezHYla

# データベースの設定 (ホストは内部サービス "db")
POSTGRES_PASSWORD=88AlwaysTimeToWin88
POSTGRES_PRISMA_URL="postgresql://superadmin:88AlwaysTimeToWin88@db:5432/casebender?schema=public"
POSTGRES_URL="postgresql://superadmin:88AlwaysTimeToWin88@db:5432/casebender?schema=public"
POSTGRES_URL_NON_POOLING="postgresql://superadmin:88AlwaysTimeToWin88@db:5432/casebender?schema=public"

# Redis の設定
REDIS_URL="redis://redis:6379"
# ホスト/ポートのフォールバック — すべてのサービスが参照します（ジョブキュー用に
# REDIS_URL を解析しない古いイメージにも対応）。
REDIS_HOST=redis
REDIS_PORT=6379

CaseBender は複数のコンテナとして実行されます: Web アプリ (app)、REST API ゲートウェイ (api)、アラート取り込みゲートウェイ (ingestion、Microsoft Defender などの統合 Webhook を受信します)、バックグラウンドの worker、そして workflow と MISP プロセッサーです。 Nginx が前面に立ち、適切なサービスへトラフィックをルーティングします。これらはすべて以下の Compose ファイルに含まれています。

ステップ 3: SSL 証明書の生成

ローカル開発用に、自己署名 SSL 証明書を生成します:

# SSL 証明書とキーを生成
openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout local-casebender.key \
  -out local-casebender.crt \
  -subj "/CN=local.casebender.com/O=CaseBender/C=US"

# 証明書を確認
openssl x509 -in local-casebender.crt -text -noout

ステップ 4: Nginx の設定

以下の内容で nginx.conf を作成します:

events {
    worker_connections 1024;
}

http {
    # ─── アップストリーム ──────────────────────────────────────
    upstream web_app {
        server app:3000;
    }

    upstream api_service {
        server api:3005;
    }

    upstream ingestion_service {
        server ingestion:3003;
    }

    # ─── レート制限 ────────────────────────────────────────────
    limit_req_zone $binary_remote_addr zone=api_limit:10m rate=100r/s;
    limit_req_zone $binary_remote_addr zone=ingest_limit:10m rate=1000r/s;

    # ─── HTTP -> HTTPS リダイレクト ────────────────────────────
    server {
        listen 80;
        server_name local.casebender.com;
        return 301 https://$server_name$request_uri;
    }

    # ─── メイン HTTPS サーバー ─────────────────────────────────
    server {
        listen 443 ssl;
        http2 on;
        server_name local.casebender.com;

        ssl_certificate /etc/nginx/certs/local-casebender.crt;
        ssl_certificate_key /etc/nginx/certs/local-casebender.key;

        ssl_protocols TLSv1.2 TLSv1.3;
        client_max_body_size 100M;

        # ─── セキュリティヘッダー ─────────────────────────────
        add_header X-Frame-Options "SAMEORIGIN" always;
        add_header X-Content-Type-Options "nosniff" always;
        add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

        # ─── 取り込み API (統合 Webhook) ──────────────────────
        location /api/v1/ingest/ {
            limit_req zone=ingest_limit burst=500 nodelay;
            proxy_pass http://ingestion_service;
            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;
        }

        # レガシー取り込みルート
        location /api/ingest/ {
            limit_req zone=ingest_limit burst=500 nodelay;
            proxy_pass http://ingestion_service;
            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;
        }

        # ─── REST API ゲートウェイ ────────────────────────────
        location /api/v1/ {
            limit_req zone=api_limit burst=50 nodelay;
            proxy_pass http://api_service;
            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;
        }

        location /api/openapi.json {
            proxy_pass http://api_service;
            proxy_set_header Host $host;
        }

        # ─── ヘルスチェック ───────────────────────────────────
        location /health {
            access_log off;
            return 200 "healthy";
            add_header Content-Type text/plain;
        }

        # ─── Web アプリケーション (キャッチオール) ────────────
        location / {
            proxy_pass http://web_app;
            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;
            proxy_set_header X-Forwarded-Host $host;
            proxy_set_header X-Forwarded-Port $server_port;

            # WebSocket サポート
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";

            proxy_connect_timeout 60s;
            proxy_send_timeout 60s;
            proxy_read_timeout 60s;
        }
    }
}

ステップ 5: Docker Compose 設定の作成

以下の内容で docker-compose.yml を作成します:

services:
  # ─── コアサービス ────────────────────────────────────────────
  app:
    image: casebender/casebender:latest
    platform: linux/amd64
    ports:
      - "3000:3000"
    environment:
      - AUTH_SECRET=${AUTH_SECRET}
      - AUTH_SALT=${AUTH_SALT}
      - AUTH_TRUST_HOST=true
      - NEXTAUTH_URL=${NEXTAUTH_URL:-https://local.casebender.com}
      - NEXTAPP_URL=${NEXTAPP_URL:-https://local.casebender.com}
      - LICENSE_SECRET_KEY=${LICENSE_SECRET_KEY}
      - LIVEBLOCKS_SECRET_KEY=${LIVEBLOCKS_SECRET_KEY}
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
    volumes:
      # 自動生成されたライセンスの秘密鍵とブロブをイメージ更新後も保持し、
      # `docker compose pull` でライセンスが再生成されないようにします。
      - casebender_secret:/app/apps/web/app/secret
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "node -e \"require('http').get('http://localhost:3000/api/health', (r) => process.exit(r.statusCode === 200 ? 0 : 1)).on('error', () => process.exit(1))\""]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 60s

  api:
    image: casebender/api:latest
    platform: linux/amd64
    ports:
      - "3005:3005"
    environment:
      - PORT=3005
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
      - AUTH_SECRET=${AUTH_SECRET}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
    restart: unless-stopped

  ingestion:
    image: casebender/ingestion:latest
    platform: linux/amd64
    ports:
      - "3003:3003"
    environment:
      - PORT=3003
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
    restart: unless-stopped

  # ─── 処理サービス ────────────────────────────────────────────
  worker:
    image: casebender/worker:latest
    platform: linux/amd64
    ports:
      - "3002:3002"
    environment:
      - PORT=3002
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
    restart: unless-stopped

  workflow-processor:
    image: casebender/workflow-processor:latest
    platform: linux/amd64
    ports:
      - "3001:3001"
    environment:
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
      app:
        condition: service_healthy
    restart: unless-stopped

  misp-processor:
    image: casebender/misp-processor:latest
    platform: linux/amd64
    ports:
      - "3004:3004"
    environment:
      - PORT=3004
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
      app:
        condition: service_healthy
    restart: unless-stopped

  # ─── インフラストラクチャ ────────────────────────────────────
  db:
    image: postgres:17
    environment:
      POSTGRES_USER: superadmin
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-88AlwaysTimeToWin88}
      POSTGRES_DB: casebender
    ports:
      - "5433:5432"
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U superadmin -d casebender"]
      interval: 5s
      timeout: 5s
      retries: 10
      start_period: 30s
    restart: unless-stopped

  redis:
    image: redis:7.2-alpine
    command: redis-server --protected-mode no
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      timeout: 3s
      retries: 5
    restart: unless-stopped

  minio:
    image: quay.io/minio/minio
    mem_limit: 512m
    command: ["minio", "server", "/data", "--console-address", ":9090"]
    environment:
      - MINIO_ROOT_USER=minioadmin
      - MINIO_ROOT_PASSWORD=minioadmin
    ports:
      - "9090:9090"
      - "9000:9000"
    volumes:
      - "miniodata:/data"
    restart: unless-stopped

  # ─── リバースプロキシ ────────────────────────────────────────
  nginx:
    image: nginx:alpine
    ports:
      - "443:443"
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - ./local-casebender.crt:/etc/nginx/certs/local-casebender.crt:ro
      - ./local-casebender.key:/etc/nginx/certs/local-casebender.key:ro
    depends_on:
      app:
        condition: service_healthy
    restart: unless-stopped

volumes:
  miniodata:
  pgdata:
  redis_data:
  casebender_secret:

エンタープライズ検索 (OpenSearch) が必要ですか? デスクトップインストーラーは search-sync、 opensearch、opensearch-dashboards の各サービスを追加できます。ほとんどのローカル評価では、上記の PostgreSQL ベースの検索で十分です。

ステップ 6: ローカル DNS の設定

hosts ファイルに次のエントリを追加します:

macOS と Linux の場合:

sudo echo "127.0.0.1 local.casebender.com" >> /etc/hosts

Windows の場合:

C:\Windows\System32\drivers\etc\hosts に次の行を追加します:

127.0.0.1 local.casebender.com

ステップ 7: アプリケーションの起動

必要なイメージをプルします:

docker compose pull

すべてのサービスを起動します:

docker compose up -d

ログを監視します:

docker compose logs -f

https://local.casebender.com でアプリケーションにアクセスします

デフォルトのログイン認証情報

CaseBender をデプロイした後、以下のデフォルト認証情報でログインできます:

ユーザー名: admin@casebender.app
パスワード: secret1234

セキュリティ上の理由から、初回ログイン後はこれらのデフォルト認証情報を直ちに変更することを強く推奨します。

企業プロキシ経由での実行

ホストが企業の HTTP プロキシ経由でのみインターネットに到達できる場合（「プロキシ専用」ネットワーク）、CaseBender の送信呼び出し — ライセンスのアクティベーションや Microsoft Defender・Splunk などの連携 — はそのプロキシ経由でルーティングする必要があります。プロキシ変数を .env に追加します。

HTTP_PROXY=http://proxy.example.com:8080
HTTPS_PROXY=http://proxy.example.com:8080
# 内部 Docker サービス（およびオンプレミスの宛先）はプロキシをバイパスする必要があります:
NO_PROXY=127.0.0.1,localhost,db,redis,minio,api,ingestion,worker,workflow-processor,misp-processor,search-sync,opensearch

次に、docker-compose.yml の各サービスの environment: ブロックに以下の行を追加して、すべての CaseBender サービスに渡します。

      - HTTP_PROXY=${HTTP_PROXY:-}
      - HTTPS_PROXY=${HTTPS_PROXY:-}
      - NO_PROXY=${NO_PROXY:-}

NO_PROXY には上記の内部 Docker サービス名を含める必要があります。含めないと、コンテナ間トラフィック（例: web アプリが ingestion サービスを呼び出す）が企業プロキシに送られて失敗し、インターネットとは無関係にもかかわらずアプリが壊れます。

どの宛先がプロキシを経由しますか？ パブリックなエンドポイントはプロキシを経由する必要があり、NO_PROXY に含めてはいけません — 例: Microsoft Defender （login.microsoftonline.com、graph.microsoft.com）。オンプレミスの宛先は直接到達できるように NO_PROXY に列挙します — 例: 内部の Splunk HEC。Splunk Cloud を使用している場合は、プロキシ経由になるよう除外してください。

コンテナ内から接続を確認します（curl は不要で node を使用）。

docker compose exec app node -e "fetch('https://login.microsoftonline.com/',{signal:AbortSignal.timeout(5000)}).then(r=>console.log('OK',r.status)).catch(e=>console.log('FAIL',e.message))"

プロキシが設定されている場合、各サービスは起動時に [proxy] Outbound fetch routed through corporate proxy (...) をログ出力します。

トラブルシューティング

よくある問題

証明書の警告:
- 自己署名証明書を使用しているため、ブラウザにセキュリティ警告が表示されます
- 「詳細設定」をクリックして Web サイトに進みます
- 開発目的では、これは想定内であり安全です
ポートの競合:
- ポート 80、443、3000、3001、3002、3003、3004、3005、5433、6379、9000、9090 が使用されていないことを確認します
- 必要に応じて、docker-compose.yml のポートマッピングを変更します
データベース接続:
- PostgreSQL のログを確認します: docker compose logs db
- .env のデータベース認証情報を確認します
- データベースが実行中であることを確認します: docker compose ps db
サービスの依存関係:
- サービスが起動しない場合は、依存関係を確認します:
docker compose ps docker compose logs [サービス名]

ログの確認

特定のサービスのログを表示します:

# すべてのサービス
docker compose logs

# 特定のサービス
docker compose logs [サービス名]

# ログを追従
docker compose logs -f [サービス名]

サービスの管理

# 特定のサービスを再起動
docker compose restart [サービス名]

# すべてのサービスを停止
docker compose down

# ボリュームを削除 (すべてのデータが削除されます)
docker compose down -v

次のステップ

CaseBender がローカルで動作するようになったので、次のことを行うとよいでしょう:

本番環境へのデプロイ

CaseBender を本番環境にデプロイします

構成

高度な構成オプションについて学びます

はじめに

デプロイメント

アラート管理

ケース管理

タスク管理

分析

監査

設定

クイックスタートガイド

前提条件

Docker のインストール

macOS の場合:

Linux (Ubuntu/Debian) の場合:

Windows の場合:

ステップ 1: プロジェクトディレクトリの作成

ステップ 2: 環境変数の設定

ステップ 3: SSL 証明書の生成

ステップ 4: Nginx の設定

ステップ 5: Docker Compose 設定の作成

ステップ 6: ローカル DNS の設定

macOS と Linux の場合:

Windows の場合:

ステップ 7: アプリケーションの起動

デフォルトのログイン認証情報

企業プロキシ経由での実行

トラブルシューティング

よくある問題

ログの確認

サービスの管理

次のステップ

本番環境へのデプロイ

構成

​前提条件

​Docker のインストール

​macOS の場合:

​Linux (Ubuntu/Debian) の場合:

​Windows の場合:

​ステップ 1: プロジェクトディレクトリの作成

​ステップ 2: 環境変数の設定

​ステップ 3: SSL 証明書の生成

​ステップ 4: Nginx の設定

​ステップ 5: Docker Compose 設定の作成

​ステップ 6: ローカル DNS の設定

​macOS と Linux の場合:

​Windows の場合:

​ステップ 7: アプリケーションの起動

​デフォルトのログイン認証情報

​企業プロキシ経由での実行

​トラブルシューティング

​よくある問題

​ログの確認

​サービスの管理

​次のステップ

本番環境へのデプロイ

構成

前提条件

Docker のインストール

macOS の場合:

Linux (Ubuntu/Debian) の場合:

Windows の場合:

ステップ 1: プロジェクトディレクトリの作成

ステップ 2: 環境変数の設定

ステップ 3: SSL 証明書の生成

ステップ 4: Nginx の設定

ステップ 5: Docker Compose 設定の作成

ステップ 6: ローカル DNS の設定

macOS と Linux の場合:

Windows の場合:

ステップ 7: アプリケーションの起動

デフォルトのログイン認証情報

企業プロキシ経由での実行

トラブルシューティング

よくある問題

ログの確認

サービスの管理

次のステップ