접속
- 열기
http://<SERVER_IP>을(를) 브라우저에서 엽니다. - API 문서는 다음 위치에서 확인할 수 있습니다:
/docs. - API 요청에는 생성된 API 키를 사용합니다. 키는 다음 위치에 저장되어 있습니다:
/root/libretranslate/.credentials.
API 사용법
번역 요청 예시:
curl -X POST http://<SERVER_IP>/translate \
-d q='Hello' \
-d source=en \
-d target=es \
-d api_key='<API_KEY>'
바꾸기 <API_KEY> 을(를) 생성된 API 키로 바꿉니다.
설정
주요 환경 변수는 다음 위치에 저장되어 있습니다: /root/libretranslate/.env.
LT_VERSION: LibreTranslate 이미지 버전REQ_LIMIT: 클라이언트당 분당 최대 요청 수CHAR_LIMIT: 요청당 허용되는 최대 문자 수
필요에 따라 설정을 수정하세요.
설정을 변경한 뒤 다음 명령으로 적용합니다:
cd /root/libretranslate
docker compose up -d
중요한 파일 및 디렉토리
- 설치 경로:
/root/libretranslate - Compose 파일:
/root/libretranslate/docker-compose.yml - 환경:
/root/libretranslate/.env - 자격 증명:
/root/libretranslate/.credentials - 모델:
/var/lib/docker/volumes/libretranslate_models - 키 DB:
/var/lib/docker/volumes/libretranslate_db - Caddy 설정:
/etc/caddy/Caddyfile
도메인 및 HTTPS(Caddy)
0. HTTPS 인증서는 IP 주소에 대해 발급할 수 없습니다.
1. 도메인(예: example.com) 을 서버의 IP 주소로 설정하세요.
2. 업데이트 /etc/caddy/Caddyfile:
example.com {
reverse_proxy localhost:5000
}
3. Caddy를 다시 로드하세요:
systemctl reload caddy
4. 다음 주소에서 LibreTranslate에 접속합니다: example.com.
참고
- 원하는 대로 다음 파일에서 설정을 수정하세요:
/root/libretranslate/.env. - Under Attack 모드가 기본적으로 활성화되어 있어 공개 API를 악의적이거나 자동화된 요청으로부터 보호합니다.
- 요청 제한이 활성화되어 있으며 기본 제한은 클라이언트당 분당
60요청입니다. - 요청은 기본적으로
5000자로 제한됩니다. - LibreTranslate 컨테이너는 다음 주소에서만 수신 대기합니다:
127.0.0.1:5000; 공개 접근은 Caddy가 제공합니다.
