메인 콘텐츠로 건너뛰기

Overleaf i18n 구성

이 문서는 자체 호스팅 Overleaf 인스턴스의 국제화(i18n)를 구성하는 방법을 설명합니다.
Overleaf는 여러 언어로 번역되어 있습니다. 적절히 구성하면 다음을 할 수 있습니다.
  • Overleaf 인스턴스를 하나의 고정된 언어로 실행하거나,
  • 여러 언어를 활성화하여 www.overleaf.com처럼 사용자가 언어를 동적으로 전환할 수 있도록 합니다.

단일 언어 구성

사이트 언어는 환경 변수 OVERLEAF_SITE_LANGUAGE로 구성합니다. 지원되는 언어 코드는 다음과 같습니다.
  • en - 영어(기본값)
  • es - 스페인어
  • pt - 포르투갈어
  • de - 독일어
  • fr - 프랑스어
  • cs - 체코어
  • nl - 네덜란드어
  • sv - 스웨덴어
  • it - 이탈리아어
  • tr - 튀르키예어
  • zh-CN - 중국어(간체)
  • no - 노르웨이어
  • da - 덴마크어
  • ru - 러시아어
  • ko - 한국어
  • ja - 일본어
  • pl - 폴란드어
  • fi - 핀란드어
기본 언어는 영어입니다. 인터페이스 언어를 변경하려면(예: 중국어 간체로) config/variables.env에 다음 줄을 추가합니다.
config/variables.env
그런 다음 구성을 적용합니다.
서비스가 다시 시작되면 웹 UI 메뉴의 인터페이스 언어에 새 설정이 반영됩니다.

다중 언어 구성

사용자가 로그아웃하지 않고 언어를 전환할 수 있도록 하려면, 도메인 이름에 따라 서로 다른 언어를 제공하도록 Overleaf 인스턴스를 구성해야 합니다. 이 섹션에서는 다음을 가정합니다.
  • 기본 도메인이 overleaftest.com입니다.
  • 와일드카드 TLS 인증서(예: *.overleaftest.com)가 있습니다.
  • localhost를 사용하지 않습니다(하위 도메인 기반 언어 라우팅을 지원할 수 없기 때문입니다).
로컬 테스트에는 dev-overleaf.com과 같은 도메인을 사용할 수 있습니다.
1

TLS 프록시 구성(Nginx)

Overleaf가 사용자가 접속한 언어 도메인을 판단할 수 있도록 TLS 리버스 프록시가 원래의 Host 헤더를 전달해야 합니다.다음 지시문이 있는지 확인하세요.
다음은 Nginx 구성 예시입니다.
2

쿠키 도메인 구성

언어를 전환할 때 사용자가 로그아웃되지 않도록 하려면 쿠키가 언어별 하위 도메인 간에 공유되어야 합니다.config/variables.env에 다음 줄을 추가합니다.
config/variables.env
이렇게 하면 인증 쿠키가 overleaftest.com 아래의 모든 하위 도메인에서 유효합니다.
3

언어–도메인 매핑

다음으로 OVERLEAF_LANG_DOMAIN_MAPPING을 사용하여
언어 코드를 하위 도메인에 매핑하는 방법을 정의합니다.

구성 예시

config/variables.env
이 구성을 사용하면 다음과 같습니다.
  • https://www.overleaftest.com → 영어 인터페이스
  • https://cn.overleaftest.com → 중국어 간체 인터페이스
필요에 따라 추가 언어와 하위 도메인으로 이 매핑을 확장할 수 있습니다.
메인 사이트는 www에서 제공하고 항상 www 키를 포함할 것을 권장합니다. OVERLEAF_SITE_URL을 www 주소(예: https://www.overleaftest.com)로 설정하고, www 키가 이 주소를 가리키도록 한 다음, 아래와 같이 apex 도메인을 이 주소로 리디렉션하세요. www 키는 메인 사이트이며 어떤 언어든 사용할 수 있습니다. 이 키가 없으면 기본 www 항목이 그대로 남아, 언어 선택기에 http://127.0.0.1:3000으로 연결되는 영어 항목이 추가로 표시됩니다.
4

apex 도메인 리디렉션

마지막으로 apex 도메인(overleaftest.com)을 기본 언어 도메인(www.overleaftest.com)으로 리디렉션합니다.

Q&A

답변: 언어 버튼(번역 아이콘)은 페이지 푸터에 있습니다. 예를 들어 프로젝트 목록 하단에 있습니다. 편집기에는 표시되지 않습니다.이 버튼은 다중 언어 구성에 설명된 대로 OVERLEAF_LANG_DOMAIN_MAPPING이 두 개 이상의 언어를 매핑할 때만 나타납니다. OVERLEAF_SITE_LANGUAGE만 설정된 경우 사이트 전체가 해당 언어 하나를 사용하며 버튼은 없습니다.언어를 선택하면 해당 언어의 도메인(예: cn.overleaftest.com)에서 같은 페이지가 열립니다. 사용자 설정으로 저장되지는 않습니다.
답변: OVERLEAF_LANG_DOMAIN_MAPPING에 www 키가 없기 때문입니다. 매핑은 기본 매핑과 병합되는데, 기본 매핑에는 내부 주소 http://127.0.0.1:3000을 사용하는 영어용 www 항목이 있습니다. 매핑에 cn과 en처럼 다른 키만 사용하면 이 기본 항목이 유지되어 선택기에 표시됩니다.OVERLEAF_SITE_URL의 주소로 www 키를 추가하고 같은 언어에 대한 두 번째 항목은 삭제한 후 bin/up -d를 실행하세요.
마지막 수정일 2026년 11월 2일