빠른 시작 가이드

이 번역은 새로운 보안 활성화 및 배포 제어 이전의 내용입니다. 업데이트될 때까지 영문 가이드를 사용하세요.

더 쉬운 방법을 찾고 계신가요? 데스크톱 설치 프로그램을 사용하면 자동 구성으로 원클릭 배포가 가능합니다. 명령줄이 필요 없습니다!

사전 요구 사항

시작하기 전에 시스템에 다음이 설치되어 있는지 확인하세요:

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는 여러 컨테이너로 실행됩니다: 웹 앱(app), REST API 게이트웨이(api), 알림 수집 게이트웨이(ingestion, Microsoft Defender 같은 통합 웹훅을 수신함), 백그라운드 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 (통합 웹훅) ──────────────────────────────
        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;
        }

        # ─── 웹 애플리케이션 (catch-all) ──────────────────────
        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 서비스 이름이 포함되어야 합니다. 그렇지 않으면 컨테이너 간 트래픽(예: 웹 앱이 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 (...)를 로그에 남깁니다.

문제 해결

일반적인 문제

인증서 경고:
- 자체 서명 인증서를 사용하므로 브라우저에 보안 경고가 표시됩니다
- “고급”을 클릭하고 웹사이트로 진행합니다
- 개발 목적에서는 예상된 동작이며 안전합니다
포트 충돌:
- 포트 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단계: 애플리케이션 시작

기본 로그인 자격 증명

기업 프록시 뒤에서 실행하기

문제 해결

일반적인 문제

로그 확인

서비스 관리

다음 단계