번역 서비스 (Translation Service)

🌐 서비스 접속

🏗️ 서비스 구조

번역 서비스
├── 프론트엔드: React + Vite → nginx (포트 80/443)
├── 백엔드: Node.js Express → systemd (포트 3501)
└── AI 모델: Ollama Docker Container → GPU 가속 (포트 11434)

🚀 빠른 시작

1. 저장소 클론

git clone https://github.com/purestory/translation-service.git
cd translation-service

2. 환경 변수 설정

# backend/.env 파일 생성
cp backend/.env.example backend/.env
# 필요한 API 키 설정 (선택사항)
DEEPL_API_KEY=your_deepl_key
OPENAI_API_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
GEMINI_API_KEY=your_gemini_key
GROQ_API_KEY=your_groq_key
OLLAMA_URL=http://localhost:11434

3. 의존성 설치

# 백엔드 의존성 설치
cd backend
npm install
# 프론트엔드 의존성 설치
cd ../vite-frontend
npm install

4. Ollama 설치 및 실행

# Docker로 Ollama 실행
sudo docker run -d --name ollama \
 -p 11434:11434 \
 --gpus all \
 -v ollama_data:/root/.ollama \
 ollama/ollama
# 한국어 특화 모델 다운로드
sudo docker exec ollama ollama pull gemma2:9b

5. 서비스 실행

# 백엔드 실행
cd backend
npm start
# 프론트엔드 빌드 및 실행 (개발시)
cd ../vite-frontend
npm run dev

🤖 지원 번역 엔진

GPU 가속 Ollama 모델 (우선순위)

클라우드 API 모델 (대체 엔진)

🔧 하드웨어 사양

GPU 정보

AI 모델 현황

# 설치된 모델 확인
curl -s http://localhost:11434/api/tags | jq '.models[].name'
# GPU 사용량 확인
nvidia-smi

🔧 서비스 관리

상태 확인

# 번역 서비스 상태
sudo systemctl status translation-service
# Ollama 컨테이너 상태
sudo docker ps | grep ollama
# GPU 사용량
nvidia-smi
# 서비스 로그
sudo journalctl -u translation-service -f --no-pager

서비스 제어

# 번역 서비스 재시작
sudo systemctl restart translation-service
# Ollama 컨테이너 재시작
sudo docker restart ollama
# 전체 시스템 재시작
sudo systemctl restart translation-service
sudo docker restart ollama
sudo nginx -s reload

📁 프로젝트 구조

translation-service/
├── README.md # 프로젝트 문서
├── package.json # 루트 패키지 설정
├── .gitignore # Git 무시 파일
├── backend/ # Node.js 백엔드
│ ├── server.js # 메인 서버
│ ├── package.json # 백엔드 의존성
│ ├── .env.example # 환경변수 예제
│ ├── routes/ # API 라우트
│ │ └── translation.js # 번역 API 엔드포인트
│ ├── services/ # 비즈니스 로직
│ │ └── translationService.js # 메인 번역 서비스
│ ├── utils/ # 유틸리티 함수
│ ├── uploads/ # 업로드 파일 임시 저장
│ └── debug.log # 서버 로그
├── vite-frontend/ # React 프론트엔드
│ ├── src/ # 소스 코드
│ │ ├── App.tsx # 메인 React 컴포넌트
│ │ ├── components/ # React 컴포넌트들
│ │ └── types/ # TypeScript 타입 정의
│ ├── public/ # 정적 파일
│ ├── dist/ # 빌드 결과 (nginx 서빙)
│ ├── package.json # 프론트엔드 의존성
│ └── vite.config.ts # Vite 설정
└── tmp/ # 임시 파일 (nginx 설정 등)

🛠️ 개발 및 배포

1. 프론트엔드 수정시

cd vite-frontend
# 코드 수정 후
npm run build
# 배포 서버에서는 nginx 재로드
sudo nginx -s reload

2. 백엔드 수정시

cd backend
# 코드 수정 후
npm start # 개발시
# 또는
sudo systemctl restart translation-service # 운영시

3. AI 모델 추가시

# 새 모델 다운로드
sudo docker exec ollama ollama pull <model_name>
# 커스텀 모델 등록
sudo docker exec ollama ollama create <custom_name> -f /path/to/Modelfile
# 백엔드에서 엔진 추가 후 재시작 필요

📊 API 문서

주요 엔드포인트

텍스트 번역

POST /translation-api/translation/text
Content-Type: application/json
{
 "text": "번역할 텍스트",
 "targetLang": "ko",
 "sourceLang": "en", // 선택사항 (auto 감지)
 "engine": "ollama-gemma2-sapie" // 선택사항
}

파일 번역 (자막)

POST /translation-api/subtitle/translate
Content-Type: multipart/form-data
- file: SRT/VTT 파일
- targetLang: ko
- engine: ollama-gemma2-sapie
- chunkSize: 10

사용 가능한 엔진 목록

GET /translation-api/translation/engines

지원 언어 목록

GET /translation-api/translation/languages

🚨 문제 해결

번역이 안될 때

일반적인 문제들

Ollama 컨테이너가 정지됨

# 원인: GPU 메모리 부족, CUDA 오류 등
# 해결: 컨테이너 재시작
sudo docker start ollama
# 로그 확인
sudo docker logs ollama --tail 50

500 Internal Server Error

# 원인: 백엔드 오류, Ollama 연결 실패
# 해결: 서비스 상태 확인 후 재시작
sudo systemctl status translation-service
sudo docker ps | grep ollama

GPU 메모리 부족시

# GPU 메모리 사용량 확인
nvidia-smi
# Ollama 컨테이너 재시작 (모델 언로드)
sudo docker restart ollama
# 무거운 모델 제거
sudo docker exec ollama ollama rm <heavy_model>

웹사이트가 안 열릴 때

📊 현재 운영 상황

🎯 활성 설정

🚀 성능 최적화

📈 모델 성능 순위 (한국어)

🔑 지원 기능

번역 기능

자막 지원

API 기능

⚠️ 중요 운영 규칙

✅ 해야 할 것

❌ 하지 말 것

🔄 업데이트 히스토리

2025年06月12日 (최신)

2025年06月07日

2025年06月06日

🤝 기여하기

📄 라이선스

📞 연락처