DeepLX로 DeepL API 무료로 사용하는 방법

점점 더 상호 연결되는 세상에서 빠르고 정확하며 접근 가능한 번역 서비스의 필요성은 무엇보다 중요합니다. DeepL은 고급 신경망 기계 번역으로 구동되는 미묘하고 자연스러운 번역으로 명성을 얻으며 이 분야의 선두 주자로 부상했습니다. 그러나 공식 API에 액세스하는 데는 모든 사용자, 개발자 또는 소규모 프로젝트에는 적합하지 않은 비용이 수반되는 경우가 많습니다. 여기에 OwO-Network의 오픈 소스 프로젝트인 DeepLX가 DeepL의 강력한 번역 기능을 활용할 수 있는 무료 대안 경로를 제공하며 등장했습니다.

이 종합 가이드에서는 DeepLX가 무엇인지, 그 이점, 설치 및 사용 방법, 비공식적인 특성에 대한 중요한 고려 사항, 그리고 공식 서비스와의 비교를 자세히 살펴봅니다. 애플리케이션에 번역 기능을 통합하려는 개발자든, 언어 도구를 실험하는 취미 사용자든, 단순히 비용 효율적인 번역 솔루션을 찾는 사용자든, DeepLX를 이해하면 새로운 가능성을 열 수 있습니다.

💡

아름다운 API 문서를 생성하는 훌륭한 API 테스트 도구를 원하십니까?

최대 생산성으로 개발팀이 함께 작업할 수 있는 통합 올인원 플랫폼을 원하십니까?

Apidog는 귀하의 모든 요구 사항을 충족하며, 훨씬 저렴한 가격으로 Postman을 대체합니다!

button

DeepLX란 무엇인가? 무료 고품질 번역의 약속

본질적으로 DeepL은 탁월한 정확성과 문맥 및 언어적 뉘앙스를 포착하는 능력으로 알려진 기계 번역 서비스를 제공하는 독일 AI 회사이며, 많은 언어 쌍에서 경쟁사보다 뛰어난 성능을 보이는 경우가 많습니다. DeepL은 번역 엔진에 대한 프로그래밍 방식의 액세스를 허용하기 위해 다양한 사용량에 맞는 여러 등급의 유료 서비스인 공식 API를 제공합니다.

OwO-Network의 GitHub에서 찾을 수 있는 DeepLX는 다음과 같은 "강력한 DeepL 번역 API"를 표방합니다:

무료: 구독료가 필요 없습니다.
빠름: 빠른 번역 속도를 제공하는 것을 목표로 합니다.
안전함: 오픈 소스이므로 코드를 검사할 수 있으며 자체 인프라에 비공개로 배포할 수 있습니다.
통합 용이: 다양한 애플리케이션에 쉽게 통합할 수 있도록 설계되었습니다.

기본적으로 DeepLX는 중개자 또는 프록시 역할을 하여 사용자가 공식 유료 API를 직접 사용하지 않고도 DeepL의 백엔드에 번역 요청을 보낼 수 있도록 합니다. 이는 일반적으로 DeepLX 서버가 무료 사용자가 서비스에 액세스하는 방식(예: 웹 인터페이스 또는 데스크톱 앱을 통해, 정확한 메커니즘은 다를 수 있으며 변경될 수 있음)을 모방하여 DeepL에 요청을 보내는 방식으로 이루어집니다.

처음부터 DeepLX가 비공식 도구라는 점을 이해하는 것이 중요합니다. DeepL SE에서 개발하거나 승인한 것이 아닙니다. 이러한 구분은 신뢰성, 안정성, 서비스 약관과 관련하여 중요한 의미를 가지며, 이는 나중에 자세히 논의될 것입니다. DeepLX의 대상 고객은 일반적으로 소규모 프로젝트에 API 액세스가 필요한 개발자, 연구원 또는 공식 DeepL API 비용이 부담스러운 사용자를 포함합니다.

DeepLX를 선택하는 이유: 이점 및 장점

비공식적인 상태에도 불구하고 DeepLX는 사용자에게 매력적인 몇 가지 장점을 제공합니다:

비용 효율성: 이는 의심할 여지 없이 가장 큰 매력입니다. DeepLX를 사용하면 공식 DeepL API와 관련된 문자당 비용 또는 구독료 없이 DeepL의 번역 엔진(품질이 널리 인정됨)을 활용할 수 있습니다. 예산이 제한된 프로젝트나 개인 사용자의 경우 이는 판도를 바꿀 수 있습니다.
고품질 번역: DeepL의 백엔드와 인터페이스함으로써 DeepLX는 DeepL이 알려진 것과 동일한 고품질 번역을 제공하는 것을 목표로 합니다. 이는 다른 일부 무료 대안에 비해 더 자연스럽고 문맥적으로 정확한 번역을 의미합니다.
속도: 사용자와 프로젝트 자체는 종종 빠른 번역 속도를 보고합니다. 이는 네트워크 조건 및 DeepLX 서버 부하에 따라 달라질 수 있지만, 일반적으로 성능이 뛰어나도록 설계되었습니다.
오픈 소스 및 보안: DeepLX의 오픈 소스 특성(일반적으로 MIT 라이선스 하에)은 투명성을 제공합니다. 사용자는 코드를 검토하여 작동 방식을 이해하고 보안을 확인할 수 있습니다. 또한 개인 서버에 DeepLX를 자체 호스팅할 수 있다는 것은 번역되는 텍스트가 (물론 DeepL 자체 외에) 제3자 서버를 통과할 필요가 없음을 의미하며, 더 높은 수준의 개인 정보 보호 및 제어를 제공합니다.
통합 용이성: DeepLX는 개발자를 염두에 두고 설계되었습니다. 일반적으로 애플리케이션이 쉽게 요청을 보낼 수 있는 간단한 API 엔드포인트(일반적으로 http://localhost:1188/translate)를 노출합니다. 이로 인해 다양한 타사 도구 및 스크립트에 통합되었습니다.
Docker 지원: 많은 DeepLX 구현은 Docker 이미지를 제공하여 배포를 크게 단순화합니다. 사용자는 종속성이나 복잡한 설정 절차에 대해 걱정할 필요 없이 단일 Docker 명령으로 DeepLX 인스턴스를 실행할 수 있습니다.
특정 제한 극복: "DeeplxFile"과 같은 DeepLX를 중심으로 구축된 일부 커뮤니티 도구는 DeepL의 무료 웹 번역기(예: 대용량 문서 또는 특정 파일 형식 번역 제한)의 특정 제한을 극복하는 것을 목표로 합니다. DeepLX를 백엔드로 사용함으로써 이러한 도구는 더 많은 유연성을 제공할 수 있습니다.

이러한 이점은 관련 비용 없이 DeepL의 번역 능력이 필요한 사람들에게 DeepLX를 매력적인 제안으로 만듭니다. 그러나 이러한 장점은 비공식적인 접근 방식에서 비롯된 고려 사항과 비교하여 평가해야 합니다.

"비공식" 상태: 중요한 고려 사항 및 잠재적 단점

"무료"와 "고품질"은 매력적이지만, DeepLX의 맥락에서 "비공식"이 무엇을 의미하는지 명확히 이해하는 것이 중요합니다:

작동 방식 추정: DeepLX는 DeepL의 승인된 API 키를 사용하지 않습니다. 대신 일반적인 비 API 사용자를 에뮬레이션하는 방식이나 DeepL이 자체 무료 서비스에 사용하는 엔드포인트를 활용하여 DeepL 서비스에 요청을 보내는 방식으로 작동할 가능성이 높습니다. 일부 출처에서는 "DeepL의 API를 훔치기 위해 위장"하거나 브라우저 헤더 및 TLS 설정을 모방하는 기술을 사용하여 이를 달성한다고 제안합니다.
공식 DeepL 제품 아님: DeepL SE는 DeepLX를 개발, 지원 또는 승인하지 않습니다. 사용자는 DeepLX를 사용할 때 DeepL로부터 공식적인 지원을 기대할 수 없습니다.
불안정성 및 신뢰성 부족 가능성: DeepLX는 DeepL 서비스에 액세스하기 위해 비공식적인 방법에 의존하므로 DeepL이 변경하는 사항에 취약합니다. DeepL이 내부 API, 웹 인터페이스 또는 속도 제한 메커니즘을 수정하면 DeepLX 인스턴스가 경고 없이 작동을 멈추거나 불안정해질 수 있습니다. 일부 사용자와 관련 문서는 DeepLX가 "불안정"할 수 있다고 명시적으로 언급합니다.
속도 제한 (HTTP 429 오류): 이는 흔하고 중요한 문제입니다. DeepL은 무료 서비스의 남용을 방지하기 위한 조치를 취합니다. DeepLX 인스턴스(또는 실행 중인 IP 주소)가 짧은 시간 내에 너무 많은 요청을 보내면 DeepL은 이를 제한하거나 차단하여 "429 Too Many Requests" 오류가 발생할 가능성이 높습니다. 요청 빈도를 줄이는 것(예: 호출 사이에 지연 추가) 외에는 DeepLX 측에서 직접적인 해결책이 없는 경우가 많습니다.
공식 API에 비해 제한된 기능 집합: 공식 DeepL API는 용어집 지원, 격식 설정, XML 처리 등 다양한 기능을 제공합니다. DeepLX 구현은 이러한 모든 기능을 지원하지 않을 수 있으며 종종 핵심 /translate 기능에 주로 초점을 맞춥니다.
윤리적 및 법적 고려 사항: 의도된 액세스 방법을 우회하는 방식으로 서비스를 사용하는 것은 윤리적인 문제를 야기할 수 있습니다. 사용자는 DeepL의 서비스 약관도 염두에 두어야 합니다. DeepLX 자체는 오픈 소스 소프트웨어이지만, DeepL의 독점 번역 서비스에 액세스하는 방식은 회색 영역에서 작동합니다. 이 글은 사용자와 개발자가 설명하는 대로 도구의 존재와 기능에 대해 알리는 것을 목표로 합니다. 모든 관련 약관 및 규정을 준수하는 것은 사용자의 책임입니다.

사용자는 DeepLX에 대해 어느 정도 주의를 기울여야 하며, 보장된 가동 시간과 공식 지원이 필요한 미션 크리티컬 애플리케이션에는 적합하지 않을 수 있음을 이해해야 합니다. 가끔 발생하는 다운타임이나 문제 해결의 필요성이 무료 액세스에 대한 허용 가능한 절충안인 시나리오에 가장 적합합니다.

시작하기: DeepLX 설치 및 설정

DeepLX 설정은 일반적으로 Docker 또는 미리 컴파일된 바이너리에 익숙하다면 간단합니다. 다음은 일반적인 방법입니다:

사전 요구 사항

명령줄 인터페이스(CLI)에 대한 기본적인 이해.
Docker 방법을 선택하는 경우 Docker 설치.
파일 다운로드를 위한 인터넷 액세스.

방법 1: Docker 사용 (간단함을 위해 권장)

Docker는 모든 종속성 및 구성을 패키징하므로 DeepLX를 실행하는 가장 쉬운 방법인 경우가 많습니다.

Docker 이미지 찾기: OwO-Network 또는 DeepLX에 기여하는 개발자는 일반적으로 Docker Hub에 Docker 이미지를 제공합니다. Docker Hub에서 deeplx를 검색하거나 공식 DeepLX GitHub 저장소에서 지침을 찾을 수 있습니다. 일반적인 이미지 이름은 owonetwork/deeplx 또는 이와 유사할 수 있습니다.
이미지 가져오기 (Pull): 터미널을 열고 다음을 실행합니다:

docker pull <image_name>:<tag>

(<image_name>:<tag>를 실제 이미지 이름으로 바꿉니다).

Docker 컨테이너 실행:

docker run -d -p 1188:1188 --name my-deeplx <image_name>:<tag>

-d: 컨테이너를 분리 모드(백그라운드)로 실행합니다.
-p 1188:1188: 호스트 머신의 포트 1188을 컨테이너의 포트 1188에 매핑합니다. DeepLX는 일반적으로 기본적으로 포트 1188에서 수신 대기합니다. 필요한 경우 호스트 포트를 변경할 수 있습니다(예: -p 8080:1188).
--name my-deeplx: 컨테이너에 기억하기 쉬운 이름을 할당합니다.

확인: docker ps 명령으로 컨테이너가 실행 중인지 확인할 수 있습니다. 이제 DeepLX 서비스는 http://localhost:1188에서 액세스할 수 있어야 합니다.

방법 2: 미리 컴파일된 바이너리 다운로드

많은 오픈 소스 프로젝트는 다양한 운영 체제용 미리 컴파일된 실행 파일을 제공합니다.

GitHub 릴리스로 이동: 공식 DeepLX GitHub 저장소(OwO-Network/DeepLX)로 이동하여 "Releases" 섹션을 찾습니다.
올바른 바이너리 다운로드: 다양한 운영 체제 및 아키텍처용 바이너리(예: deeplx_windows_amd64.exe, deeplx_linux_amd64, deeplx_darwin_amd64)를 찾을 수 있습니다. 시스템에 맞는 것을 다운로드합니다.
실행 가능하게 만들기 (Linux/macOS):

chmod +x /path/to/your/deeplx_binary

바이너리 실행:

./path/to/your/deeplx_binary [options]

바이너리는 구성에 대한 명령줄 플래그를 지원할 수 있습니다(예: -p <port_number>로 포트 지정 또는 DeepL API 키와는 다른 DeepLX 인스턴스 자체를 보호하기 위한 토큰). 사용 가능한 옵션은 프로젝트 문서를 참조하십시오.

방화벽: 네트워크의 다른 장치에서 액세스하려는 경우 DeepLX가 수신 대기하는 포트(기본값 1188)에서 시스템 방화벽이 들어오는 연결을 허용하는지 확인하십시오.

방법 3: 소스에서 빌드 (고급 사용자용)

직접 컴파일하거나 최신 미출시 변경 사항을 원하는 경우:

빌드 종속성 설치: DeepLX는 종종 Go 또는 Rust와 같은 언어로 작성됩니다. 해당 컴파일러 및 도구 체인(예: Go 프로그래밍 언어 환경)이 설치되어 있어야 합니다. 빌드 지침은 GitHub 저장소를 확인하십시오.
저장소 복제 (Clone):

git clone [https://github.com/OwO-Network/DeepLX.git](https://github.com/OwO-Network/DeepLX.git)
cd DeepLX

프로젝트 빌드: 저장소의 README.md 또는 빌드 스크립트에 지정된 빌드 명령을 따릅니다(예: go build . 또는 cargo build --release).
컴파일된 바이너리 실행: 결과 실행 파일은 방법 2에 설명된 대로 실행할 수 있습니다.

초기 구성 (서버 측)

DeepLX 자체는 최소한의 구성으로 실행되도록 설계되었습니다. 주목할 주요 사항은 수신 대기하는 포트(기본값 1188)입니다. 일부 버전 또는 포크는 명령줄 인수 또는 환경 변수(예: -token YOUR_SECRET_TOKEN)를 통해 액세스 토큰을 설정할 수 있도록 허용할 수 있습니다. 이 토큰은 DeepLX 엔드포인트가 노출된 경우 보안 계층을 추가하기 위해 클라이언트가 DeepLX 인스턴스를 사용하기 위해 제공해야 합니다.

실행되면 DeepLX 인스턴스는 번역 요청을 받을 준비가 됩니다.

DeepLX 사용 방법: 번역 요청 보내기

DeepLX 인스턴스가 실행되면(예: http://localhost:1188), 일반적으로 /translate인 API 엔드포인트에 번역 요청을 보낼 수 있습니다.

API 엔드포인트

http://<your_deeplx_host_or_ip>:<port>/translate
(예: 기본 포트에서 로컬로 실행하는 경우 http://localhost:1188/translate)

기본 API 호출 구조

메서드: POST
헤더:
Content-Type: application/json
본문: 번역할 텍스트 및 언어 매개변수를 포함하는 JSON 페이로드.

JSON 본문의 주요 매개변수

text (문자열 또는 문자열 배열): 번역하려는 텍스트.
source_lang (문자열, 선택 사항): 원본 텍스트의 언어 코드(예: "EN", "DE", "FR"). 생략하거나 "auto"로 설정하면 DeepLX(DeepL을 통해)가 원본 언어를 감지하려고 시도합니다.
target_lang (문자열, 필수): 텍스트를 번역하려는 언어 코드(예: "EN-US", "EN-GB", "DE", "FR", "ZH", "JA").
split_sentences, preserve_formatting, formality와 같은 다른 매개변수는 DeepLX 버전에 따라 지원될 수 있습니다. 사용 가능한 경우 특정 DeepLX 프로젝트의 문서를 확인하십시오.

`curl`을 사용한 예시

"Hello, world!"를 영어에서 독일어로 번역하려면:

curl -X POST http://localhost:1188/translate \
     -H "Content-Type: application/json" \
     -d '{
           "text": "Hello, world!",
           "source_lang": "EN",
           "target_lang": "DE"
         }'

응답 해석

성공적인 응답 (예: HTTP 200 OK): 응답은 일반적으로 다음을 포함하는 JSON 객체입니다:

code: 상태 코드 (예: 성공 시 200).
id: 요청 ID.
data: 번역된 텍스트. 여러 텍스트가 전송된 경우 번역 배열일 수 있습니다.
source_lang: 감지된 원본 언어 ("auto"를 사용했거나 제공된 경우).
target_lang: 대상 언어.
alternatives (선택 사항): 일부 DeepL 인터페이스는 대체 번역을 제공하며, DeepLX도 이를 포함할 수 있습니다.

성공적인 응답 구조 예시:JSON

{
    "code": 200,
    "id": 1678886400000,
    "data": "Hallo, Welt!",
    "source_lang": "EN",
    "target_lang": "DE",
    "alternatives": [
        "Hallo Welt!"
    ]
}

오류 응답:

HTTP 400 Bad Request: 잘못된 JSON 페이로드, 필수 매개변수 누락 또는 잘못된 언어 코드.
HTTP 429 Too Many Requests: 속도 제한에 걸렸습니다. 요청 속도를 늦추십시오.
HTTP 500 Internal Server Error (또는 유사한 5xx): DeepLX 서버 측 문제 또는 DeepL 측의 예상치 못한 오류. DeepLX 서버 로그를 확인하십시오.

프로그래밍 언어와 DeepLX 사용 (개념적 예시)

Python (requests 라이브러리 사용):Python

import requests
import json

deeplx_url = "http://localhost:1188/translate"
text_to_translate = "The quick brown fox jumps over the lazy dog."

payload = {
    "text": text_to_translate,
    "source_lang": "EN",
    "target_lang": "ES"  # Translate to Spanish
}

headers = {
    "Content-Type": "application/json"
}

try:
    response = requests.post(deeplx_url, data=json.dumps(payload), headers=headers)
    response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)
    
    translation_data = response.json()
    
    if translation_data.get("code") == 200:
        print(f"Original: {text_to_translate}")
        print(f"Translated: {translation_data.get('data')}")
    else:
        print(f"Error from DeepLX: {translation_data.get('message', 'Unknown error')}")

except requests.exceptions.RequestException as e:
    print(f"Request failed: {e}")
except json.JSONDecodeError:
    print("Failed to decode JSON response.")

JavaScript (브라우저 또는 Node.js 환경에서 Workspace API 사용):JavaScript

async function translateText(text, targetLang, sourceLang = "auto") {
    const deeplxUrl = "http://localhost:1188/translate"; // Adjust if your DeepLX is elsewhere
    const payload = {
        text: text,
        source_lang: sourceLang,
        target_lang: targetLang
    };

    try {
        const response = await fetch(deeplxUrl, {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json'
            },
            body: JSON.stringify(payload)
        });

        if (!response.ok) {
            // Try to get error message from DeepLX if possible
            let errorMsg = `HTTP error! status: ${response.status}`;
            try {
                const errorData = await response.json();
                errorMsg = errorData.message || JSON.stringify(errorData);
            } catch (e) { /* ignore if response is not json */ }
            throw new Error(errorMsg);
        }

        const translationData = await response.json();

        if (translationData.code === 200) {
            return translationData.data;
        } else {
            throw new Error(translationData.message || `DeepLX API error code: ${translationData.code}`);
        }
    } catch (error) {
        console.error("Translation failed:", error);
        return null;
    }
}

// Example usage:
(async () => {
    const translatedText = await translateText("Welcome to the world of AI.", "JA"); // To Japanese
    if (translatedText) {
        console.log(`Translated: ${translatedText}`);
    }
})();

DeepLX 인스턴스가 localhost:1188에서 실행되지 않는 경우 deeplx_url을 조정해야 합니다.

애플리케이션과 DeepLX 통합

DeepLX의 주요 사용 사례 중 하나는 공식 API 비용을 발생시키지 않고 다른 애플리케이션 내에서 번역 기능을 강화하는 것입니다. 여러 도구 및 프로젝트가 이미 통합을 시연했습니다:

텔레그램 봇: DeepLX-Bot은 DeepLX 백엔드를 사용하여 텔레그램 채팅에서 메시지를 자동으로 번역하도록 설계된 대표적인 예입니다.
비디오 번역 도구: pyVideoTrans는 비디오 자막 번역을 위해 로컬에 배포된 DeepLX 인스턴스를 활용할 수 있는 도구로 언급됩니다.
자막 편집기: SubtitleEdit은 DeepLX 사용에 대한 논의 또는 통합이 있었으며, 사용자가 자막 파일을 번역할 수 있도록 합니다.
파일 번역 유틸리티: DeeplxFile은 특히 대용량 파일이나 복잡한 Excel 문서를 DeepLX를 활용하여 번역하고 DeepL의 무료 웹 인터페이스 또는 공식 무료 API 계층의 제한을 극복하기 위해 구축된 도구입니다.

통합을 위한 일반적인 접근 방식

DeepLX 인스턴스 설정: DeepLX 서버가 실행 중이며 이를 사용할 애플리케이션에서 액세스할 수 있는지 확인합니다.
구성 설정 식별: 통합하려는 애플리케이션에서 번역 서비스 또는 DeepL API와 관련된 설정을 찾습니다.
DeepLX 엔드포인트 지정: 공식 DeepL API URL(예: https://api-free.deepl.com/v2/translate 또는 https://api.deepl.com/v2/translate) 대신 DeepLX 서버 주소(예: http://localhost:1188/translate 또는 http://your-server-ip:1188/translate)를 입력합니다.
API 키 처리:

공식 DeepL API용으로 설계된 대부분의 애플리케이션에는 "API 키" 또는 "인증 키" 필드가 있습니다.
DeepLX 자체는 일반적으로 DeepL API 키를 요구하지 않습니다. 애플리케이션이 API 키 필드를 필수로 채워야 하는 경우 더미 값(예: "deeplx", "none" 또는 임의의 문자열)을 입력할 수 있습니다.
그러나 DeepLX 인스턴스가 보안을 위해 자체 액세스 토큰으로 구성된 경우(설정 섹션에서 논의됨), 애플리케이션은 앱과 DeepLX가 지원하는 경우 사용자 지정 헤더 또는 URL의 일부로 이 토큰을 보내는 방법이 필요합니다. 이는 표준 DeepL 통합에서는 덜 일반적입니다.

철저히 테스트: 구성 후 애플리케이션 내에서 번역 기능을 테스트하여 DeepLX 백엔드와 올바르게 작동하는지 확인합니다.

통합 용이성은 대상 애플리케이션의 번역 서비스 구성 유연성에 크게 좌우됩니다.

고급 고려 사항 및 모범 사례

DeepLX를 최대한 활용하고 잠재적인 문제 중 일부를 완화하려면 다음 사항을 고려하십시오:

속도 제한 관리 (429 오류):
DeepLX를 사용하는 애플리케이션을 구축하는 경우 429 오류에 대해 지수 백오프를 사용한 재시도 로직을 구현하십시오. 즉, 속도 제한으로 인해 요청이 실패하면 애플리케이션이 짧은 시간 동안 기다린 다음 다시 시도하고, 이후 각 실패 후 대기 시간을 늘립니다.
DeepLX 인스턴스를 통해 DeepL의 속도 제한에 도달하지 않도록 연속 요청 사이에 지연을 도입하십시오.
가능한 경우 여러 DeepLX 인스턴스 또는 IP 주소에 걸쳐 요청을 분산하십시오. 단, 이는 복잡성을 증가시킵니다.
강력한 오류 처리: DeepLX의 잠재적 오류를 정상적으로 처리하도록 클라이언트 애플리케이션을 설계하십시오. 여기에는 429 오류뿐만 아니라 5xx 서버 오류, 네트워크 문제 또는 예상치 못한 응답 형식도 포함됩니다. 번역에 실패한 경우 사용자에게 유용한 피드백을 제공하십시오.
DeepLX 인스턴스 보안:
DeepLX 인스턴스가 네트워크(특히 인터넷)에 노출된 경우 보안을 강화하십시오.
SSL/TLS 암호화, 인증(예: HTTP 기본 인증) 및 자체 속도 제한을 제공할 수 있는 리버스 프록시(예: Nginx 또는 Caddy) 뒤에서 실행하십시오.
방화벽 규칙을 활용하여 신뢰할 수 있는 IP 주소로의 액세스를 제한하십시오.
DeepLX 빌드가 지원하는 경우 DeepLX 서비스 자체에 대한 액세스 토큰을 구성하십시오.
인스턴스 모니터링: DeepLX 서버 성능을 주시하십시오:
CPU 및 메모리 사용량을 모니터링하십시오.
빈번한 속도 제한 또는 기타 문제와 같은 문제에 대한 통찰력을 제공할 수 있는 오류 또는 경고에 대해 로그를 정기적으로 확인하십시오.
최신 상태 유지: DeepLX GitHub 저장소(및 사용 중인 포크)를 주기적으로 확인하여 다음을 확인하십시오:
새 릴리스: 버그 수정, 성능 개선 또는 DeepL 서비스 변경에 대한 적응이 포함될 수 있습니다.
보고된 문제: 다른 사용자가 유사한 문제를 겪고 있는지, 해결책 또는 해결 방법이 게시되었는지 확인하십시오.
대체 계획 마련: DeepLX의 "비공식" 및 잠재적으로 불안정한 특성을 고려할 때 안정적인 번역이 중요한 경우 대체 전략을 고려하십시오. 이는 DeepLX를 사용할 수 없게 될 경우 다른 (아마도 유료) 번역 서비스로 전환하는 것을 포함할 수 있습니다. pyVideoTrans 문서는 다음과 같이 조언합니다: "오류가 발생하는 경우... 배포가 올바른지 확인한 후 다른 번역 채널로 전환하십시오."

사전 예방적으로 접근함으로써 DeepLX 설정의 안정성과 유용성을 향상시킬 수 있습니다.

일반적인 DeepLX 문제 해결

DeepLX의 특성을 고려할 때 문제가 발생할 수 있습니다. 다음은 몇 가지 일반적인 문제와 해결 방법입니다:

문제: `429 Too Many Requests` 오류

원인: DeepLX 인스턴스(또는 해당 IP)가 DeepL에 너무 빠르게 너무 많은 요청을 보내고 있습니다.
해결책:
클라이언트 애플리케이션에서 번역 요청 빈도를 줄이십시오. 지연을 구현하십시오.
DeepLX 서버를 제어하고 많은 클라이언트로부터 공격을 받고 있는 경우 클라이언트 측 속도 제한 또는 부하 분산을 고려하십시오.
속도 제한은 종종 일시적이므로 잠시 기다리십시오.
DeepLX 인스턴스를 다시 시작하면 새 세션을 얻거나 DeepL의 차단이 짧은 경우 일시적인 문제를 해결하는 데 도움이 될 수 있지만, 이는 보장된 해결책이 아닙니다.
발신 IP 주소를 변경하기 위해 VPN 또는 프록시 뒤에서 DeepLX를 실행하는 것을 고려하십시오. 단, 이는 VPN/프록시 또는 DeepL의 서비스 약관을 위반할 수 있습니다.

문제: DeepLX 인스턴스가 시작되지 않거나 충돌 발생

원인: 포트 충돌, OS에 대한 잘못된 바이너리, 누락된 종속성(소스에서 빌드한 경우), 손상된 다운로드 또는 내부 버그.
해결책:
로그 확인: 이것이 첫 번째 단계입니다. DeepLX 로그는 종종 실패 원인을 나타냅니다. Docker를 사용하는 경우 docker logs <container_name_or_id>를 사용하십시오.
포트 충돌: 포트 1188(또는 구성된 포트)이 다른 애플리케이션에서 사용 중이 아닌지 확인하십시오(Linux에서 netstat -tulnp | grep 1188).
바이너리 호환성: 미리 컴파일된 바이너리를 사용하는 경우 운영 체제 및 CPU 아키텍처에 맞는 올바른 버전을 다운로드했는지 다시 확인하십시오.
권한: 바이너리에 실행 권한이 있는지 확인하십시오(Linux/macOS).
다시 다운로드/다시 빌드: 바이너리를 다시 다운로드하거나 소스에서 다시 빌드해 보십시오.

문제: 번역이 부정확하거나 실패하거나 예상치 못한 결과 반환

원인:
DeepL 서비스 자체의 일시적인 문제.
DeepL이 내부 API 또는 차단 메커니즘을 변경하여 DeepLX가 상호 작용하는 방식에 영향을 미쳤을 수 있습니다.
잘못된 source_lang 또는 target_lang 매개변수.
DeepLX 버전의 버그.
해결책:
매개변수 확인: 언어 코드와 전송되는 텍스트를 다시 확인하십시오.
DeepL 웹사이트에서 테스트: DeepL 웹사이트에서 직접 동일한 번역을 시도해 보십시오. 거기서도 실패하거나 부정확한 경우 문제는 DeepLX가 아닌 DeepL에 있을 가능성이 높습니다.
DeepLX 다시 시작: 이는 때때로 일시적인 문제를 해결할 수 있습니다.
GitHub 문제 확인: DeepLX 프로젝트의 GitHub 문제 페이지를 살펴보십시오. 다른 사용자가 유사한 문제를 보고하고 있을 수 있으며, 진행 중인 논의 또는 해결 방법이 있을 수 있습니다.
DeepLX 업데이트: 새 버전이 있는 경우 업데이트를 고려하십시오. 이러한 문제에 대한 수정 사항이 포함될 수 있습니다.
마지막 수단으로 pyVideoTrans 문서에서 제안한 것처럼 DeepLX에 문제가 계속 발생하는 경우 대체 번역 서비스로 전환해야 할 수 있습니다.

문제: 네트워크 연결 오류 (예: "Connection refused," "Timeout")

원인: DeepLX 서버가 실행되지 않거나, 방화벽이 액세스를 차단하거나, 클라이언트 애플리케이션의 호스트/포트가 잘못되었거나, 일반적인 네트워크 연결 문제입니다.
해결책:
DeepLX 서버 프로세스 또는 Docker 컨테이너가 실행 중인지 확인하십시오.
클라이언트 애플리케이션이 DeepLX가 수신 대기하는 올바른 IP 주소와 포트를 가리키고 있는지 확인하십시오.
DeepLX를 호스팅하는 서버와 클라이언트 머신 모두에서 방화벽을 확인하십시오.
기본 네트워크 연결을 테스트하십시오(예: 서버 ping, telnet <host> <port>).

DeepLX 문제 해결에는 종종 로그 확인, 구성 확인, 프로젝트 주변의 커뮤니티 논의 주시가 포함됩니다.

DeepLX 대 공식 DeepL API: 간략한 비교

기능	DeepLX (OwO-Network 경유)	공식 DeepL API (무료 등급)	공식 DeepL API (프로/유료)
비용	무료	무료	유료 (구독/문자당)
출처	비공식, 오픈 소스	공식	유료 (구독/문자당)
안정성	잠재적으로 불안정, 중단될 수 있음	일반적으로 안정적	높은 안정성, SLA 제공 가능
속도 제한	429 오류 발생 가능성 높음, 예측 불가능	월 500,000자 제한	더 높은/맞춤형 제한, 사용량 기반 요금