From 874cf11a7a98b556c5efca70edad69a2b876d881 Mon Sep 17 00:00:00 2001 From: csbae Date: Tue, 8 Sep 2026 14:31:45 +0900 Subject: [PATCH] =?UTF-8?q?fix:=20Docker=20=EC=8B=A4=ED=96=89=20=EA=B2=BD?= =?UTF-8?q?=EB=A1=9C=EC=97=90=EC=84=9C=20=ED=99=94=EC=9E=90=20=EB=B6=84?= =?UTF-8?q?=EB=A6=AC=EA=B0=80=20=EB=8F=99=EC=9E=91=ED=95=98=EB=8F=84?= =?UTF-8?q?=EB=A1=9D=20=EC=88=98=EC=A0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Docker로 띄우면 화자 분리가 전혀 되지 않았다. 세 가지 문제가 겹쳐 있었다. 1. 베이스 이미지가 Alpine(musl)인데 sherpa-onnx 사전 빌드 바이너리는 glibc에 링크되어 있어 ld-linux-aarch64.so.1 을 찾지 못했다. node:22-slim 으로 교체. 2. Next 파일 트레이싱이 sherpa-onnx.node 만 복사하고 동반 공유 라이브러리 (libonnxruntime, libsherpa-onnx-c-api 등 약 33MB)를 놓쳤다. outputFileTracingIncludes 로 플랫폼 패키지를 통째로 포함시킨다. 3. models/ 가 이미지에도 볼륨에도 없어 컨테이너 안에서는 항상 미설치 상태였다. 호스트의 models/ 를 읽기 전용으로 마운트한다. 추가로 app 컨테이너에 LLM_* 환경변수를 전달한다. GEMINI_API_KEY만 넘기고 있어서 OpenAI 호환 프로바이더를 환경변수로 설정할 수 없었다. 컨테이너 안에서 실제 오디오로 화자 분리가 도는 것을 확인했다. Co-Authored-By: Claude Opus 5 --- Dockerfile | 11 ++++++++--- README.md | 4 ++++ docker-compose.yml | 9 +++++++++ next.config.ts | 5 +++++ 4 files changed, 26 insertions(+), 3 deletions(-) diff --git a/Dockerfile b/Dockerfile index 7d837c5..80e6479 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,4 +1,6 @@ -FROM node:22-alpine AS base +# sherpa-onnx 사전 빌드 바이너리가 glibc에 링크되어 있어 Alpine(musl)에서는 +# ld-linux-aarch64.so.1 을 찾지 못한다. glibc 계열인 slim 을 쓴다. +FROM node:22-slim AS base FROM base AS deps WORKDIR /app @@ -15,8 +17,8 @@ RUN npm run build FROM base AS runner WORKDIR /app ENV NODE_ENV=production -RUN addgroup --system --gid 1001 nodejs -RUN adduser --system --uid 1001 nextjs +RUN groupadd --system --gid 1001 nodejs \ + && useradd --system --uid 1001 --gid nodejs nextjs COPY --from=builder /app/public ./public COPY --from=builder /app/.next/standalone ./ COPY --from=builder /app/.next/static ./.next/static @@ -24,6 +26,9 @@ COPY --from=builder /app/prisma ./prisma RUN mkdir -p uploads && chown nextjs:nodejs uploads +# sherpa-onnx의 .so는 표준 검색 경로에 없으므로 명시해준다. +ENV LD_LIBRARY_PATH=/app/node_modules/sherpa-onnx-linux-arm64:/app/node_modules/sherpa-onnx-linux-x64 + USER nextjs EXPOSE 3000 ENV PORT=3000 diff --git a/README.md b/README.md index d6e8f2b..ea51b2e 100644 --- a/README.md +++ b/README.md @@ -124,6 +124,10 @@ Next.js 프로세스에서 실행합니다. **오디오가 외부로 나가지 npm run setup:diarization ``` +> Docker로 실행하실 때도 **호스트에서** 위 명령을 먼저 실행하세요. `models/` 디렉터리가 +> 컨테이너에 읽기 전용으로 마운트됩니다. 받지 않으면 대면 모드만 비활성화되고 나머지는 +> 정상 동작합니다. + > 💡 **참석자 수를 정확히 입력하세요.** 자동 추정은 화자 수를 잘못 세는 것이 주 실패 > 모드입니다. 실측에서 4인 오디오가 자동 모드로는 5명, 참석자 수를 알려주면 4명으로 > 정확히 나왔습니다. diff --git a/docker-compose.yml b/docker-compose.yml index d744dfd..03252fb 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -43,8 +43,17 @@ services: environment: DATABASE_URL: postgresql://${POSTGRES_USER:?required}:${POSTGRES_PASSWORD:?required}@db:5432/${POSTGRES_DB:?required} GEMINI_API_KEY: ${GEMINI_API_KEY:-} + # OpenAI 호환 프로바이더 (선택) — 없으면 브라우저에 저장된 설정을 쓴다 + LLM_PROVIDER: ${LLM_PROVIDER:-} + LLM_BASE_URL: ${LLM_BASE_URL:-} + LLM_MODEL: ${LLM_MODEL:-} + LLM_API_KEY: ${LLM_API_KEY:-} + DIARIZATION_MODEL_DIR: /app/models/diarization volumes: - uploads:/app/uploads + # 화자 분리 모델 — 호스트에서 npm run setup:diarization 으로 받은 것을 읽기 전용으로 마운트. + # 없으면 빈 디렉터리가 되고 대면 화자 분리만 비활성화된다 (앱은 정상 동작). + - ./models:/app/models:ro depends_on: db: condition: service_healthy diff --git a/next.config.ts b/next.config.ts index ef9a988..fbd3ef9 100644 --- a/next.config.ts +++ b/next.config.ts @@ -14,6 +14,11 @@ const nextConfig: NextConfig = { output: "standalone", // sherpa-onnx-node는 네이티브 애드온이라 번들링하면 안 된다. serverExternalPackages: ["sherpa-onnx-node"], + // 트레이싱은 .node 파일만 잡고 동반 공유 라이브러리(.so/.dylib)를 놓친다. + // 플랫폼 패키지를 통째로 포함시켜야 standalone 빌드에서 로드된다. + outputFileTracingIncludes: { + "/api/diarize": ["./node_modules/sherpa-onnx-*/**"], + }, async headers() { return [ {