MTranServer: CPU 지원 오프라인 번역 서비스

일반 소개

MTranServer는 오프라인 번역에 중점을 둔 오픈 소스 서버 프로젝트로, GitHub에서 호스팅되며 개발자 xxnuo가 만들었습니다. 가장 큰 특징은 리소스 요구 사항이 매우 낮다는 점으로, GPU 지원 없이 CPU와 1GB RAM만 있으면 실행할 수 있으며 단일 요청에 대해 평균 50ms의 응답 속도를 달성할 수 있습니다. 전 세계 주요 언어의 번역을 지원하며 번역 품질이 구글 번역에 근접해 현지에 번역 서비스를 구축해야 하는 사용자에게 적합합니다. MTranServer는 도커를 통해 빠르게 배포할 수 있어 개발자나 기업에서 네트워크가 없는 환경에서도 편리하게 사용할 수 있으며, 가볍고 효율적인 번역 솔루션입니다.

기능 목록

• 오프라인 번역 지원인터넷 연결 없이도 다국어 번역 작업을 완료할 수 있어 데이터 프라이버시와 안정성을 보장합니다.
• 초저 리소스 사용량CPU 및 1GB RAM에서만 실행되며 저사양 디바이스에 배포하는 데 적합합니다.
• 신속한 대응단일 번역 요청에 대한 평균 응답 시간은 50ms로 매우 효율적입니다.
• 다국어 번역전 세계 주요 언어를 지원하며, 구글 번역과 비슷한 수준의 번역 결과를 제공합니다.
• 도커 배포빠른 설치와 운영을 위해 도커 컨테이너화가 지원됩니다.
• 오픈 소스 및 무료이 코드는 완전히 오픈 소스이며 사용자가 자유롭게 다운로드하여 사용하고 수정할 수 있습니다.

도움말 사용

설치 프로세스

MTranServer는 도커를 통해 설치되므로 기본적인 명령줄 조작 능력이 있는 사용자에게 적합합니다. 자세한 설치 단계는 다음과 같습니다:

1. 환경 준비하기

• 시스템 요구 사항장치에서 Docker 지원 운영 체제(예: Linux, Windows 10/11 또는 macOS)가 실행 중인지 확인합니다.
• 하드웨어 요구 사항최소 1GB의 사용 가능한 메모리와 기본 CPU, GPU는 필요하지 않습니다.
• 도구 설치::
  • Docker가 설치되어 있는지 확인하고, 설치되어 있지 않은 경우 Docker 웹사이트에서 다운로드하여 설치하세요.
  • 설치 확인: 터미널을 열고 다음을 입력합니다. docker --version버전 번호가 표시되면 설치에 성공했다는 뜻입니다.

2. MTranServer 다운로드

• 브라우저를 열고 https://github.com/xxnuo/MTranServer 을 방문하세요.
• 페이지 오른쪽 상단의 녹색을 클릭합니다. 코드 버튼을 클릭하고 ZIP 다운로드 소스 코드를 다운로드하거나 Git을 사용하여 복제합니다:

  git clone https://github.com/xxnuo/MTranServer.git

• 다운로드가 완료되면 파일을 로컬 디렉터리(예 ~/MTranServer)를 클릭하거나 복제된 폴더로 바로 이동합니다.

3. Docker 이미지 빌드

• 터미널을 열고 MTranServer 프로젝트 디렉토리로 이동합니다:

  cd ~/MTranServer
  

• Docker 빌드 명령을 실행하여 이미지를 생성합니다:

  docker build -t mtranserver .
  

  • -t mtranserver 미러 이름을 지정합니다.. 현재 디렉터리의 도커파일이 사용됨을 나타냅니다.
  • 빌드 프로세스는 네트워크 및 디바이스 성능에 따라 몇 분 정도 소요될 수 있습니다. 완료되면 다음을 입력합니다. docker images 이미지가 성공적으로 생성되었는지 확인합니다.

4. MTranServer 실행

• 다음 명령을 사용하여 컨테이너를 시작합니다:

  docker run -d -p 5000:5000 mtranserver
  

  • -d 는 백그라운드에서 실행 중임을 나타냅니다.-p 5000:5000 컨테이너의 포트 5000을 호스트의 포트 5000에 매핑합니다.
• 작동 상태 확인: 입력 docker psmtranserver 컨테이너가 실행 중이면 시작에 성공한 것입니다.

5. 테스트 서비스

• 브라우저를 열거나 도구(예: Postman, curl)를 사용하여 번역 요청을 보냅니다:
  • 요청 예시:

    curl -X POST http://localhost:5000/translate -H "Content-Type: application/json" -d '{"text": "Hello, world!", "source_lang": "en", "target_lang": "zh"}'
    

  • 샘플 결과를 반환합니다:{"translated_text": "你好，世界！"}
• 올바른 번역 결과가 반환되면 서비스가 정상적으로 실행되고 있는 것입니다.

기능 작동 흐름

1. 오프라인 번역 기능

• 절차::
  1. MTranServer가 로컬에서 실행 중인지 확인합니다(예를 들어 http://localhost:5000).
  2. 번역할 텍스트를 다음 필드를 포함하는 JSON 형식의 HTTP POST 요청을 통해 전송합니다:
     • text: 번역할 텍스트의 내용(예: "안녕하세요, 세상!").
     • source_lang소스 언어 코드(예: 영어의 경우 "en").
     • target_lang대상 언어 코드(예: 중국어는 "zh").
  3. 요청을 전송하면 서버는 일반적으로 50ms 이내에 번역 결과를 반환합니다.
• 주의언어 코드는 국제 표준(예: ISO 639-1)을 준수해야 하며, 지원되는 언어 목록은 프로젝트 문서 또는 기본 구성에서 확인할 수 있습니다.

2. 다국어 지원

• 사용 방법::
  • 요청 조정 source_lang 노래로 응답 target_lang 매개 변수를 사용하면 서로 다른 언어 간 번역을 수행할 수 있습니다. 예시:
    • 영어를 프랑스어로:{"text": "Good morning", "source_lang": "en", "target_lang": "fr"}
    • 반환:{"translated_text": "Bon matin"}
  • 지원되는 언어는 영어, 중국어, 스페인어, 러시아어 등 전 세계 주요 언어를 포괄합니다.
• 주요 설명인터넷 연결이 필요하지 않으며 모든 번역 모델이 서버에 내장되어 있어 개인 정보 보호와 속도를 보장합니다.

3. 도커 컨테이너 관리

• 시작 및 중지::
  • 서비스 중지: 컨테이너 ID 찾기( docker ps 보기)를 클릭한 다음 실행합니다:

    docker stop <容器ID>
    

  • 서비스를 다시 시작합니다:

    docker restart <容器ID>
    

• 로그 보기문제가 발생하면 컨테이너 로그를 확인하여 문제를 해결할 수 있습니다:

  docker logs <容器ID>
  

• 포트 조정포트 5000이 사용 중인 경우 다음과 같이 매핑된 포트를 변경할 수 있습니다. -p 8080:5000를 클릭한 다음 http://localhost:8080.

4. 사용자 지정 수정

• 작동 방법::
  1. 프로젝트 폴더를 열고 구성 파일 또는 번역 모델 디렉터리를 찾습니다(정확한 경로는 README 참조).
  2. 필요에 따라 코드를 수정하거나 언어 모델을 추가하세요.
  3. 변경이 완료되면 이미지를 다시 빌드하고 실행합니다:

     docker build -t mtranserver .  
     docker run -d -p 5000:5000 mtranserver
     

• 적용 가능한 시나리오개발자는 작은 언어에 대한 지원을 추가하거나 번역 알고리즘을 최적화하는 등 실제 필요에 따라 기능을 확장할 수 있습니다.

주의

• 네트워크 환경첫 번째 빌드 이미지는 종속성을 다운로드하기 위해 인터넷 액세스가 필요할 수 있으며, 이후 실행은 완전히 오프라인 상태입니다.
• 성능 최적화장치의 성능이 낮은 경우 동시 요청 수를 제한하여 안정성을 향상시킬 수 있습니다(구성 파일 수정 필요).
• 문서 참조프로젝트 README는 가장 권위 있는 사용자 가이드이므로 최신 정보를 확인하려면 주의 깊게 읽어보는 것이 좋습니다.

위의 단계를 통해 사용자는 MTranServer를 쉽게 배포하고 사용하여 효율적인 오프라인 번역 서비스를 즐길 수 있습니다.