Docker

LibreTranslate Docker 설치 가이드

TechLogbook 2025. 2. 19. 14:28

LibreTranslate는 오픈 소스 기계 번역 API로, Docker를 사용하여 쉽게 설치하고 실행할 수 있습니다. 이 가이드에서는 LibreTranslate를 Docker 환경에서 설치하는 방법을 단계별로 설명합니다.

환경

사전 요구사항

  • Docker가 설치된 시스템
  • 터미널 또는 명령 프롬프트 접근 권한
  • 최소 4GB의 RAM (모든 언어 모델을 로드할 경우 더 많은 RAM 필요)

도커설치

Docker를 사용한 LibreTranslate 설치 및 실행

  1. Docker 이미지 가져오기:

    docker pull libretranslate/libretranslate
  2. Docker 컨테이너 실행:

    docker run -d -p 5000:5000 libretranslate/libretranslate
  3. 특정 환경 변수 설정 (선택사항):

    docker run -d -p 5000:5000 -e LT_API_KEYS=true -e LT_LOAD_ONLY=en,es,fr libretranslate/libretranslate
  4. 설치 확인:
    웹 브라우저에서 http://localhost:5000에 접속하여 LibreTranslate 웹 인터페이스가 정상적으로 로드되는지 확인합니다.

Docker Compose 사용 (권장)

  1. docker-compose.yml 파일 생성:

    version: '3'
    services:
    libretranslate:
    image: libretranslate/libretranslate
    ports:
      - "5000:5000"
    environment:
      - LT_API_KEYS=true
      - LT_LOAD_ONLY=en,es,fr
  2. 환경 변수 설정

LibreTranslate의 동작을 제어하기 위해 다음과 같은 환경 변수를 설정할 수 있습니다:

  • LT_DEBUG: 디버그 모드 활성화 (true/false)
  • LT_UPDATE_MODELS: 시작 시 언어 모델 업데이트 (true/false)
  • LT_API_KEYS: API 키 인증 사용 (true/false)
  • LT_LOAD_ONLY: 특정 언어 모델만 로드 (예: en,es,fr)
  1. Docker Compose로 실행:

    docker-compose up -d