설정

모든 설정은 settings.py 에 저장됩니다 (Django의 일반적인 방식).

참고

이러한 설정을 변경한 후에는 WSGI와 Celery 프로세스 모두 Weblate를 다시 시작해야 합니다.

mod_wsgi 로 실행하는 경우, 설정을 다시 로드하려면 Apache를 다시 시작해야 합니다.

더 보기

Django 자체를 설정하는 매개변수에 대해서는 Django 문서 도 참조하세요.

ADMINS_CONTACT

문의 양식의 이메일 수신자를 설정합니다. 설정하지 않으면 ADMINS 의 이메일 주소가 사용됩니다.

이메일 주소 목록으로 설정함:

ADMINS_CONTACT = ["admin@example.com", "support@example.com"]

더 보기

ALLOWED_ASSET_DOMAINS

Added in version 5.14.

Weblate에서 에셋을 가져올 때 허용되는 도메인을 설정합니다.

신뢰할 수 없는 소스에서 에셋을 로드하지 못하게 하여 보안을 강화합니다. 에셋은 외부 도메인에서 사용자에게 직접 제공되지 않고, Weblate 서버가 한 번 다운로드하여 로컬에 저장합니다.

허용 목록은 초기 URL과 Weblate가 따라가는 모든 HTTP 리디렉션 대상에 적용됩니다. 이 허용 목록 외 호스트로의 리디렉션은 거부됩니다.

호스트/도메인 이름 목록을 입력합니다. 정규화된 이름 (예: www.example.com)을 사용하거나, 마침표를 접두사로 사용하여 모든 하위 도메인과 일치시킬 수 있습니다 (예: .example.com 은 cdn.example.com 또는 static.example.com 과 일치).

기본값은 ["*"] 이며, 모든 도메인을 허용합니다.

예시

ALLOWED_ASSET_DOMAINS = [
    # Allows only cdn.anotherdomain.org
    "cdn.anotherdomain.org",
    # Allows example.com and all its subdomains
    ".example.com",
]

이것은 현재 다음 곳에서 사용됨:

더 보기

ALLOWED_MACHINERY_DOMAINS

프로젝트 수준의 기계 번역 설정에서 명시적으로 허용되는 사용자 정의 기계 번역 도메인을 설정합니다.

이 설정은 기계 번역 서비스에만 적용되며 ALLOWED_ASSET_DOMAINS 에는 영향을 미치지 않습니다.

호스트/도메인 이름 목록을 입력합니다. 정규화된 이름을 사용하거나 마침표를 접두사로 사용하여 모든 하위 도메인과 일치시킬 수 있습니다.

기본값은 [] 입니다.

The allowlist affects project-managed machinery in two ways: it permits the configured endpoint during outbound validation, and it marks matching hosts as trusted when deciding whether remote provider error details or response bodies can be shown to the user. Matching hosts are also exempt from private-target restrictions. For direct connections, Weblate does not resolve, pin, or verify the peer address of matching hosts. Only add hosts or domains whose network destinations are trusted. When a configured HTTP 프록시 is used, the proxy is trusted to resolve the destination hostname.

ALLOWED_ASSET_SIZE

Added in version 5.14.

Configures size limit in bytes for fetching or uploading assets into Weblate. Defaults to 10 MB.

더 보기

ASSET_PRIVATE_ALLOWLIST

Added in version 2025.5.

비공개 대상 검사를 적용하는 원격 에셋 다운로드에 대해 ASSET_RESTRICT_PRIVATE 에서 제외할 호스트 이름 또는 도메인을 정의합니다. 항목은 Django 호스트 일치 의미를 따르므로 assets.internal.example 또는 .internal.example 같은 값을 사용할 수 있습니다.

이 설정은 ALLOWED_ASSET_DOMAINS 를 대체하지 않습니다. 원격 에셋은 여전히 에셋 도메인 허용 목록과 일치해야 합니다.

기본 구성:

ASSET_PRIVATE_ALLOWLIST = []

더 보기

ASSET_RESTRICT_PRIVATE

Added in version 2025.5.

대상 호스트가 ASSET_PRIVATE_ALLOWLIST 에 포함되지 않는 한 내부 또는 비공개 주소를 가리키는 원격 에셋 URL을 거부합니다. 기본적으로 켜져 있습니다.

활성화하면 유효성 검사 중 해석할 수 없는 호스트 이름은 ASSET_PRIVATE_ALLOWLIST 에 명시적으로 포함되지 않는 한 거부됩니다. 현재 이는 자바스크립트 현지화 CDN 애드온의 스크린샷 URL 업로드와 원격 HTML 다운로드에 적용됩니다.

더 보기

ALTCHA_COST

Added in version 2025.5.

ALTCHA 작업 증명 챌린지의 Argon2id 시간 비용입니다. 기본값은 3 입니다.

제거된 ALTCHA 위젯 v2에 적용되던 ALTCHA_MAX_NUMBER 를 대체합니다.

ALTCHA_MEMORY_COST

Added in version 2025.5.

KiB 단위의 Argon2id 메모리 비용입니다. 기본값은 65536 입니다.

ALTCHA_PARALLELISM

Added in version 2025.5.

Argon2id 병렬 처리 계수입니다. 기본값은 1 입니다.

더 보기

ALTCHA 작업 증명 메커니즘

ANONYMOUS_USER_NAME

로그인하지 않은 사용자의 사용자 이름.

더 보기

접근 제어

AUDITLOG_EXPIRY

Weblate가 계정 활동 정보가 포함된 감사 로그를 보관하는 최대 일수입니다.

기본값은 180일입니다.

AUTH_LOCK_ATTEMPTS

속도 제한이 적용되기 전의 최대 인증 실패 횟수입니다.

이것은 현재 다음 위치에 적용됨:

  • 로그인. 계정 비밀번호를 삭제하여 새 비밀번호를 요청하지 않고는 로그인할 수 없도록 합니다.

  • 비밀번호 재설정. 새 이메일이 전송되지 않도록 하여 너무 많은 비밀번호 재설정 시도로 사용자에게 스팸을 보내는 것을 방지합니다.

기본값은 10입니다.

더 보기

속도 제한

AUTO_UPDATE

모든 저장소를 매일 업데이트합니다.

힌트

알림 후크 를 사용하여 Weblate 저장소를 자동으로 업데이트하지 않는 경우 유용합니다.

참고

하위 호환성을 위해 문자열 선택 외에 켜기/끄기 옵션도 존재합니다.

옵션:

"none"

일일 업데이트 없음.

"remote" 또는 False

원격만 업데이트.

"full" 또는 True

원격을 업데이트하고 작업 복사본을 병합.

참고

Celery를 사용한 백그라운드 작업 가 작동해야 하며, 다시 시작한 후에 적용됩니다.

AVATAR_URL_PREFIX

아바타 URL을 ${AVATAR_URL_PREFIX}/avatar/${MAIL_HASH}?${PARAMS} 형식으로 구성하기 위한 접두사입니다. 다음 서비스가 작동하는 것으로 알려져 있음:

Gravatar (기본값), https://gravatar.com/ 참조

AVATAR_URL_PREFIX = 'https://www.gravatar.com/'

Libravatar, https://www.libravatar.org/ 참조

AVATAR_URL_PREFIX = 'https://www.libravatar.org/'

더 보기

AUTH_TOKEN_VALID

인증 토큰과 비밀번호 재설정 이메일의 임시 비밀번호 유효 기간입니다. 초 단위로 설정하며, 기본값은 172800(2일)입니다.

AUTH_PASSWORD_DAYS

Weblate가 사용자의 이전에 사용한 비밀번호 재사용을 거부하는 기간(일)입니다.

이 검사는 감사 로그를 기반으로 하며, AUDITLOG_EXPIRY 가 이것 이상이어야 합니다.

참고

Weblate 2.15 이전에 수행된 비밀번호 변경은 이 정책에 포함되지 않습니다.

기본값은 180일입니다.

AUTOFIX_LIST

문자열 저장 시 적용할 자동 수정 목록입니다.

참고

자동 수정기 인터페이스를 구현하는 Python 클래스의 전체 경로를 제공합니다.

사용 가능한 수정은 자동 수정 에 설명되어 있습니다.

사용할 항목을 선택할 수 있음:

AUTOFIX_LIST = (
    "weblate.trans.autofixes.whitespace.SameBookendingWhitespace",
    "weblate.trans.autofixes.chars.ReplaceTrailingDotsWithEllipsis",
)

더 보기

BACKGROUND_TASKS

Added in version 4.5.2.

구성요소에 대해 긴 유지보수 작업이 얼마나 자주 실행되어야 하는지를 정의합니다.

현재 이를 통해 제어되는 항목:

사용 가능한 선택:

  • monthly (기본값)

  • weekly

  • daily

  • never

참고

Weblate에 수천 개의 구성요소가 있는 경우 빈도를 높이는 것은 권장되지 않습니다.

BASIC_LANGUAGES

Added in version 4.4.

새 번역을 시작할 때 사용자에게 제공할 언어 목록입니다. 지정하지 않으면 내장 목록이 사용됩니다 (일반적으로 사용되는 모든 언어를 포함하지만 국가별 변형은 제외).

이는 권한이 없는 사용자가 원하지 않는 언어를 추가하는 것만 제한합니다. 프로젝트 관리자에게는 Weblate에 정의된 전체 언어 선택이 여전히 표시됩니다.

참고

이것은 Weblate에 새 언어를 정의하지 않으며, 데이터베이스의 기존 언어만 필터링합니다.

예시:

BASIC_LANGUAGES = {"cs", "it", "ja", "en"}

더 보기

언어 정의

BORG_EXTRA_ARGS

Added in version 4.9.

내장 백업이 실행될 때 borg create 에 추가 인수를 전달할 수 있습니다.

예시:

BORG_EXTRA_ARGS = ["--exclude", "vcs/"]

더 보기

CACHE_DIR

Added in version 4.16.

Weblate가 캐시 파일을 저장하는 디렉터리입니다. 기본값은 DATA_DIR 의 cache 하위 폴더입니다.

DATA_DIR 가 네트워크 파일 시스템에 있는 경우 로컬 또는 임시 파일 시스템으로 변경하세요.

Weblate는 생성된 도우미 파일을 여기에 저장하고 그중 일부를 실행하므로 CACHE_DIR 는 쓰기 가능해야 하며 실행을 허용하는 파일시스템에 마운트되어야 합니다. 이 디렉터리에 noexec 마운트 옵션을 사용하지 마세요.

Docker 컨테이너는 이를 위해 별도의 볼륨을 사용합니다 ( Docker 컨테이너 볼륨 참조).

일반적으로 다음 하위 디렉터리가 존재함:

ssh

VCS 접근에 사용되는 생성된 도우미 파일입니다.

fonts

글꼴 관리 용 font-config 캐시.

avatar

캐시된 사용자 아바타 ( 아바타 참조).

static

STATIC_ROOT 로 지정된 정적 Django 파일의 기본 위치 ( 정적 파일 제공 참조).

tesseract

스크린샷 및 시각적 컨텍스트 용 OCR 학습 데이터.

CSP_SCRIPT_SRC, CSP_IMG_SRC, CSP_CONNECT_SRC, CSP_STYLE_SRC, CSP_FONT_SRC, CSP_FORM_SRC

Weblate의 Content-Security-Policy 헤더를 사용자 지정합니다. 이 헤더는 활성화된 서드파티 서비스 (Matomo, Google Analytics, Sentry 등) 통합을 기반으로 자동 생성됩니다.

이 모든 항목의 기본값은 빈 목록입니다.

예시:

# Enable Cloudflare Javascript optimizations
CSP_SCRIPT_SRC = ["ajax.cloudflare.com"]

더 보기

CHECK_LIST

번역에 수행할 품질 검사 목록입니다.

참고

검사 인터페이스를 구현하는 Python 클래스의 전체 경로를 제공합니다.

관련 검사를 포함하도록 검사 목록을 조정하세요.

모든 내장 품질 검사 가 기본적으로 활성화되어 있으며, 여기서 이 설정을 변경할 수 있습니다. 기본적으로 샘플 설정 에서 주석 처리되어 기본값이 사용됩니다. 새 검사는 새 Weblate 버전마다 수행됩니다.

모든 검사를 끌 수 있음:

CHECK_LIST = ()

일부만 켤 수 있음:

CHECK_LIST = (
    "weblate.checks.chars.BeginNewlineCheck",
    "weblate.checks.chars.EndNewlineCheck",
    "weblate.checks.chars.MaxLengthCheck",
)

참고

이 설정을 변경하면 새로 변경된 번역에만 영향을 미칩니다. 기존 검사는 여전히 데이터베이스에 저장됩니다. 저장된 번역에도 변경 사항을 적용하려면 updatechecks 를 실행하세요.

더 보기

COMMIT_PENDING_HOURS

백그라운드 작업을 통해 보류 중인 변경 사항을 커밋하는 간격(시간)입니다.

더 보기

COMPONENT_ZIP_UPLOAD_MAX_SIZE

Added in version 5.17.1.

업로드된 구성요소 ZIP 파일의 최대 크기(바이트)를 설정합니다. 기본값은 50MB입니다.

Docker에서는 WEBLATE_COMPONENT_ZIP_UPLOAD_MAX_SIZE 환경 변수를 사용하여 설정합니다.

더 보기

CONTACT_FORM

Added in version 4.6.

문의 양식에서 이메일이 전송되는 방식을 설정합니다. 메일 서버 설정에 맞는 구성을 선택하세요.

"reply-to"

발신자가 Reply-To 로 사용됩니다. 이것이 기본 동작입니다.

"from"

발신자가 From 으로 사용됩니다. 메일 서버에서 이러한 이메일 전송을 허용해야 합니다.

"disabled"

문의 양식을 완전히 비활성화합니다.

Added in version 5.15.

더 보기

ADMINS_CONTACT

DATA_DIR

Weblate가 모든 데이터를 저장하는 폴더입니다. VCS 저장소 링크, 전문 검색 인덱스 및 외부 도구의 다양한 설정 파일이 포함됩니다.

일반적으로 다음 하위 디렉터리가 존재함:

home

스크립트를 실행하는 데 사용되는 홈 디렉터리.

ssh

SSH 키 및 설정.

media

MEDIA_ROOT 로 지정된 Django 미디어 파일의 기본 위치입니다. 업로드된 스크린샷이 포함됩니다 ( 스크린샷 및 시각적 컨텍스트 참조).

vcs

번역용 버전 관리 저장소.

backups

일일 백업 데이터. 자세한 내용은 백업용 덤프 데이터 를 참조하세요.

fonts:

사용자가 업로드한 글꼴 ( 글꼴 관리 참조).

cache

다양한 캐시. CACHE_DIR 을 사용하여 다른 곳에 배치할 수 있습니다.

Docker 컨테이너는 이를 위해 별도의 볼륨을 사용합니다 ( Docker 컨테이너 볼륨 참조).

참고

이 디렉터리는 Weblate가 쓸 수 있어야 합니다. WSGI로 실행하는 경우 www-data 사용자에게 쓰기 접근 권한이 있어야 합니다.

이를 달성하는 가장 쉬운 방법은 사용자를 디렉터리의 소유자로 만드는 것임:

sudo chown www-data:www-data -R $DATA_DIR

기본값은 /home/weblate/data 이지만 설정하는 것이 바람직합니다.

더 보기

DATABASE_BACKUP

데이터베이스 백업을 일반 텍스트, 압축 또는 건너뛰기 중 어떤 방식으로 저장할지 결정합니다. 허용되는 값:

  • "plain"

  • "compressed"

  • "none"

더 보기

Weblate 백업 및 이전

DEFAULT_ACCESS_CONTROL

새 프로젝트의 기본 접근 제어 설정:

0

공개

1

보호됨

100

비공개

200

사용자 정의

내부 Weblate 관리에 의존하지 않고 ACL을 수동으로 관리하는 경우 사용자 정의 를 사용하세요.

더 보기

DEFAULT_AUTO_WATCH

Added in version 4.5.

새 사용자에 대해 기여 시 프로젝트 자동 관심 등록 을 활성화할지 설정합니다. 기본값은 True 입니다.

더 보기

알림

DEFAULT_RESTRICTED_COMPONENT

Added in version 4.1.

구성요소 제한의 기본값.

더 보기

DEFAULT_ADD_MESSAGE, DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE, DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE

다양한 작업에 대한 기본 커밋 메시지. 자세한 내용은 구성요소 설정 를 참조하세요.

기본 설정은 Conventional Commits를 따르며, 가능한 경우 Weblate 링크를 포함합니다. 이러한 설정을 변경하면 새로 생성되는 기본값에 적용되며, 기존 메시지 템플릿은 설정 양식에서 사이트 기본값 복원 을 사용하여 재설정할 수 있습니다. 상속된 값의 경우, 사이트 기본값을 복원하면 해당 메시지에 대한 상속도 비활성화됩니다.

더 보기

DEFAULT_ADDONS

생성된 모든 구성요소에 설치할 기본 애드온.

참고

이 설정은 새로 생성된 구성요소에만 영향을 미칩니다.

예시:

DEFAULT_ADDONS = {
    # Add-on with no parameters
    "weblate.flags.target_edit": {},
    # Add-on with parameters
    "weblate.autotranslate.autotranslate": {
        "mode": "suggest",
        "filter_type": "todo",
        "auto_source": "mt",
        "component": "",
        "engines": ["weblate-translation-memory"],
        "threshold": "80",
    },
}

더 보기

DEFAULT_COMMITER_EMAIL

커미터 이메일 주소. 기본값은 noreply@weblate.org 입니다.

더 보기

DEFAULT_COMMITER_NAME

DEFAULT_COMMITER_NAME

커미터 이름. 기본값은 Weblate 입니다.

더 보기

DEFAULT_COMMITER_EMAIL

DEFAULT_LANGUAGE

Added in version 4.3.2.

새 구성요소의 원문 언어.

기본값은 en 입니다. 일치하는 언어 객체가 데이터베이스에 존재해야 합니다.

더 보기

DEFAULT_MERGE_STYLE

새 구성요소의 병합 스타일.

  • rebase - 기본값

  • merge

더 보기

DEFAULT_SHARED_TM

공유된 번역 메모리 사용하기 및 공유된 번역 메모리에 기여하기 의 기본값을 설정합니다.

DEFAULT_TRANSLATION_REVIEW

Added in version 5.16.

검토 활성화 의 기본값을 설정합니다. 기본적으로 꺼져 있습니다.

DEFAULT_SOURCE_REVIEW

Added in version 5.16.

원문 검토 활성화 의 기본값을 설정합니다. 기본적으로 꺼져 있습니다.

DEFAULT_AUTOCLEAN_TM

Added in version 5.13.

번역 메모리 자동 정리 의 기본값을 설정합니다.

DEFAULT_TRANSLATION_PROPAGATION

번역 전파의 기본 설정. 기본값은 True 입니다.

더 보기

DEFAULT_PULL_MESSAGE

풀 리퀘스트의 기본 제목과 메시지를 설정합니다.

기본 설정은 Conventional Commits 방식을 따르며, Weblate 링크와 번역 상태를 포함합니다.

ENABLE_AVATARS

사용자에 대해 Gravatar 기반 아바타를 활성화할지 여부. 기본적으로 켜져 있습니다.

아바타는 서버에서 가져와 캐시되어 개인 정보 유출 위험을 줄이고 사용자 경험을 향상시킵니다.

더 보기

ENABLE_HOOKS

익명 원격 훅을 활성화할지 여부.

더 보기

알림 후크

ENABLE_HTTPS

버전 5.7에서 변경: Weblate는 이제 WebAuthn 지원을 위해 https가 필요합니다.

Weblate 링크를 HTTPS 또는 HTTP로 보낼지 여부. 이 설정은 전송된 이메일과 생성된 절대 URL에 영향을 미칩니다.

기본 설정에서는 HTTPS 관련 여러 Django 설정에도 사용됩니다 - 보안 쿠키 활성화, HSTS 전환 또는 HTTPS URL로의 리디렉션을 활성화합니다.

HTTPS 리디렉션은 경우에 따라 문제가 될 수 있습니다. 프로토콜 헤더를 Django에 올바르게 전달하지 않는 SSL 종료를 수행하는 리버스 프록시를 사용하는 경우 무한 리디렉션 문제가 발생할 수 있습니다. 리버스 프록시 설정을 조정하여 X-Forwarded-Proto 또는 Forwarded 헤더를 보내거나, SECURE_PROXY_SSL_HEADER 를 설정하여 Django가 SSL 상태를 올바르게 감지하도록 하세요.

이것이 비활성화되면 Weblate가 otp_webauthn.E031 오류로 시작되지 않습니다. SILENCED_SYSTEM_CHECKS 에 추가하여 이 오류를 무시할 수 있지만, HTTPS가 없는 사이트에서는 WebAuthn이 작동하지 않습니다.

더 보기

ENABLE_SHARING

사용자가 소셜 네트워크에서 번역 진행 상황을 공유할 수 있도록 커뮤니티 메뉴를 켜거나 끕니다.

더 보기

번역 커뮤니티 구축

EXTRA_HTML_HEAD

Added in version 4.15.

HTML 헤더에 추가 마크업을 삽입합니다. 예를 들어 사이트 소유권 확인에 사용할 수 있음:

EXTRA_HTML_HEAD = '<link href="https://fosstodon.org/@weblate" rel="me">'

경고

문자열에 대한 정리가 수행되지 않습니다. 그대로 HTML 헤더에 삽입됩니다.

GET_HELP_URL

Added in version 4.5.2.

Weblate 인스턴스의 지원을 받을 수 있는 URL.

GITEA_CREDENTIALS

Added in version 4.12.

Gitea 서버의 자격 증명 목록.

GITEA_CREDENTIALS = {
    "try.gitea.io": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

구성 딕셔너리는 각 API 호스트에 대해 정의된 인증 정보로 구성됩니다. 거의 모든 버전 관리 통합에서 레이아웃이 동일하며 버전 관리 자격 증명 구성 에 설명되어 있습니다.

더 보기

GITLAB_CREDENTIALS

Added in version 4.3.

GitLab 서버의 자격 증명 목록.

GITLAB_CREDENTIALS = {
    "gitlab.com": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

참고

개인 액세스 토큰은 API를 사용하려면 api 범위가 필요합니다.

구성 딕셔너리는 각 API 호스트에 대해 정의된 인증 정보로 구성됩니다. 거의 모든 버전 관리 통합에서 레이아웃이 동일하며 버전 관리 자격 증명 구성 에 설명되어 있습니다.

더 보기

GITHUB_CREDENTIALS

Added in version 4.3.

GitHub 서버의 자격 증명 목록.

GITHUB_CREDENTIALS = {
    "api.github.com": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

참고

세분화된 개인 액세스 토큰과 클래식 개인 액세스 토큰을 모두 사용할 수 있습니다. 세분화된 토큰은 단일 조직으로 제한되므로, 조직 외부의 저장소를 포크하려는 경우(일반적으로 사용자 네임스페이스로) 작동하지 않습니다.

클론, 푸시 및 풀 리퀘스트를 만들려면 Contents 및 Pull requests 에 대한 읽기 및 쓰기 접근 권한이 필요합니다.

포크를 사용하려고 하며 원본 저장소가 공개되지 않은 경우 관리 도 필요할 수 있습니다.

힌트

https://github.com/의 API 호스트로 api.github.com 을 사용하세요.

구성 딕셔너리는 각 API 호스트에 대해 정의된 인증 정보로 구성됩니다. 거의 모든 버전 관리 통합에서 레이아웃이 동일하며 버전 관리 자격 증명 구성 에 설명되어 있습니다.

더 보기

GITHUB_LEGACY_APP_WEBHOOK_SECRET

Added in version 2026.8.

Webhook secret for a legacy GitHub App which delivers events to the generic GitHub webhook URL, /hooks/github/.

App webhook deliveries to the generic URL are rejected when this setting is empty or their X-Hub-Signature-256 does not match. Ordinary repository webhooks are unaffected. GitHub Apps registered through Weblate use their per-App webhook URLs and do not use this setting.

GITHUB_LEGACY_APP_WEBHOOK_SECRET = "your-webhook-secret"

더 보기

BITBUCKETSERVER_CREDENTIALS

Added in version 4.16.

Bitbucket Data Center의 자격 증명 목록.

BITBUCKETSERVER_CREDENTIALS = {
    "git.self-hosted.com": {
        "username": "weblate",
        "token": "http-access-token",
    },
}

구성 딕셔너리는 각 API 호스트에 대해 정의된 인증 정보로 구성됩니다. 거의 모든 버전 관리 통합에서 레이아웃이 동일하며 버전 관리 자격 증명 구성 에 설명되어 있습니다.

더 보기

BITBUCKETCLOUD_CREDENTIALS

Added in version 5.8.

Bitbucket Cloud 서버의 자격 증명 목록.

BITBUCKETCLOUD_CREDENTIALS = {
    "bitbucket.org": {
        "username": "your-email",
        "workspace": "your-workspace-slug",
        "token": "your-api-token",
    },
}

설정 딕셔너리는 각 API 호스트에 대해 정의된 자격 증명으로 구성됩니다. API 호스트는 웹 브라우저에서 사용하는 것과 다를 수 있습니다. 예를 들어 GitHub API는 api.github.com 로 접근합니다.

다음 호스트별 설정을 사용할 수 있음:

username

API 사용자.

workspace

사용자 작업공간 슬러그.

token

pullrequest:write 권한이 있는 API 토큰.

여기에 설명되지 않은 추가 설정은 버전 관리 자격 증명 구성 에서 확인할 수 있습니다.

더 보기

AZURE_DEVOPS_CREDENTIALS

Added in version 5.2.

Azure DevOps 서버의 자격 증명 목록.

AZURE_DEVOPS_CREDENTIALS = {
    "dev.azure.com": {
        "username": "project-name",
        "token": "your-api-token",
        "organization": "organization-name",
    },
}

설정 딕셔너리는 각 API 호스트에 대해 정의된 자격 증명으로 구성됩니다. API 호스트는 웹 브라우저에서 사용하는 것과 다를 수 있습니다. 예를 들어 GitHub API는 api.github.com 로 접근합니다.

다음 호스트별 설정을 사용할 수 있음:

username

Azure DevOps 프로젝트의 이름입니다. 저장소 이름이 아닙니다.

organization

프로젝트의 조직 이름입니다.

workItemIds

조직의 선택적 작업 항목 ID 목록입니다. 제공되면 새 풀 리퀘스트에 이 항목들이 첨부됩니다.

token

API 사용자의 API 토큰. 필수.

여기에 설명되지 않은 추가 설정은 버전 관리 자격 증명 구성 에서 확인할 수 있습니다.

더 보기

GOOGLE_ANALYTICS_ID

Google Universal Analytics를 사용하여 Weblate 모니터링을 활성화하는 Google Analytics ID입니다.

참고

Google Analytics 4 통합은 현재 Weblate에서 사용할 수 없습니다. https://github.com/WeblateOrg/weblate/issues/14015를 참조하세요.

HIDE_REPO_CREDENTIALS

웹 인터페이스에서 저장소 자격 증명을 숨깁니다. 사용자와 비밀번호가 포함된 저장소 URL이 있는 경우, 관련 정보가 사용자에게 표시될 때 Weblate가 이를 숨깁니다.

예를 들어 https://user:password@git.example.com/repo.git 대신 https://git.example.com/repo.git 만 표시됩니다. VCS 오류 메시지도 비슷한 방식으로 정리를 시도합니다.

참고

기본적으로 켜짐.

VERSION_DISPLAY

Added in version 5.17.

Weblate가 자체 버전을 얼마나 두드러지게 노출하는지 제어합니다.

지원되는 값:

show

바닥글 등 공유 UI에 버전을 표시하고 GET /api/metrics/ 에 노출합니다.

soft

눈에 띄는 공유 UI에서 버전을 숨기되, 정보 페이지와 GET /api/metrics/ 에서 확인 가능하도록 유지합니다.

hide

공유 UI와 GET /api/metrics/ 에서 버전을 숨깁니다. 또한 익명 문서 링크가 설치된 릴리스에 해당하는 버전 대신 최신 문서를 가리키게 합니다.

버전 숨기기는 일부 기업에서 권장하는 보안 관행이지만, 공격자가 탐색 동작으로 버전을 추론하는 것을 방지하지는 않습니다.

참고

기본값은 show 입니다.

HIDE_VERSION

Added in version 4.3.1.

버전 5.17부터 폐지됨.

VERSION_DISPLAY 의 호환성 별칭입니다. VERSION_DISPLAY = "hide" 와 동일한 동작을 얻으려면 True 로 설정하세요.

INTERNAL_BOT_EMAIL_TEMPLATE

Added in version 2026.7.1.

Template used to generate e-mail addresses for internal Weblate bot accounts. Defaults to "noreply-{scope}-{name}@weblate.org".

It can contain {scope}, {name}, {username}, {site_title}, and {site_domain}.

Use {scope} and {name} when generating the e-mail local part. The {username} value contains the internal scope:name username.

Existing internal bot accounts are updated when migrate is run. Project API token accounts are not affected.

IP_BEHIND_REVERSE_PROXY

Weblate가 리버스 프록시 뒤에서 실행 중인지 나타냅니다.

True 로 설정하면 Weblate는 IP_PROXY_HEADER 에 정의된 헤더에서 IP 주소를 가져옵니다.

경고

실제로 리버스 프록시를 사용하고 해당 헤더를 설정하는지 확인하세요. 그렇지 않으면 사용자가 IP 주소를 위조할 수 있습니다.

참고

기본적으로 꺼져 있습니다.

더 보기

IP_PROXY_HEADER

IP_BEHIND_REVERSE_PROXY 가 켜져 있을 때 Weblate가 IP 주소를 가져올 헤더를 나타냅니다.

기본값은 HTTP_X_FORWARDED_FOR 입니다.

더 보기

IP_PROXY_OFFSET

버전 5.0.1에서 변경: 기본값이 1에서 -1로 변경됨.

IP_PROXY_HEADER 의 어느 부분이 클라이언트 IP 주소로 사용되는지 나타냅니다.

설정에 따라 이 헤더는 여러 IP 주소로 구성될 수 있습니다 (예: X-Forwarded-For: client-ip, proxy-a, proxy-b). 여기서 헤더의 어떤 주소를 클라이언트 IP 주소로 사용할지 설정할 수 있습니다.

경고

이 설정은 설치 보안에 영향을 미칩니다. IP 주소를 결정하는 데 신뢰할 수 있는 프록시만 사용하도록 설정해야 합니다. 자세한 내용은 <https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Forwarded-For#security_and_privacy_concerns>를 참조하세요.

기본값은 -1.

더 보기

LICENSE_EXTRA

라이선스 선택에 포함할 추가 라이선스.

참고

각 라이선스 정의는 짧은 이름, 긴 이름, URL, 자유 라이선스 여부를 나타내는 부울 값으로 이루어진 튜플이어야 합니다.

예시:

LICENSE_EXTRA = [
    (
        "AGPL-3.0",
        "GNU Affero General Public License v3.0",
        "https://www.gnu.org/licenses/agpl-3.0-standalone.html",
        True,
    ),
]

LICENSE_FILTER

버전 4.3에서 변경: 이 설정을 빈 값으로 지정하면 라이선스 알림이 비활성화됩니다.

표시할 라이선스 목록을 필터링합니다. 빈 값으로 설정하면 라이선스 알림도 비활성화됩니다.

참고

이 필터는 짧은 라이선스 이름을 사용합니다.

예시:

LICENSE_FILTER = {"AGPL-3.0", "GPL-3.0-or-later"}

다음은 라이선스 알림을 비활성화함:

LICENSE_FILTER = set()

더 보기

번역 구성요소 진단

LICENSE_REQUIRED

구성요소 설정 의 라이선스 속성이 필수인지 여부를 정의합니다.

참고

기본적으로 꺼져 있습니다.

LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH

번역의 길이를 제한할지 여부입니다. 제한은 원본 문자열 길이 × 10자입니다.

힌트

원본 문자열 길이에 관계없이 더 긴 번역(최대 10,000자)을 허용하려면 False 로 설정하세요.

참고

기본값은 True 입니다.

LOCALIZE_CDN_URL 및 LOCALIZE_CDN_PATH

이 설정은 자바스크립트 현지화 CDN 및 번역 파일 CDN 를 포함한 CDN 애드온을 구성합니다. LOCALIZE_CDN_URL 은 현지화 CDN을 사용할 수 있는 루트 URL을 정의하고, LOCALIZE_CDN_PATH 는 LOCALIZE_CDN_URL 에서 제공될 생성 파일을 Weblate가 저장할 경로를 정의합니다. 파일은 Weblate가 아니라 웹 서버나 CDN에서 제공됩니다. 안전한 제공 지침은 현지화 CDN 를 참조하세요.

힌트

Hosted Weblate에서는 https://weblate-cdn.com/ 을 사용합니다.

더 보기

MATOMO_SITE_ID

Weblate 추적에 사용할 Matomo(구 Piwik)의 사이트 ID입니다.

참고

이 통합은 Matomo Tag Manager를 지원하지 않습니다.

더 보기

MATOMO_URL

MATOMO_URL

Weblate 사용 추적에 사용할 Matomo(구 Piwik) 설치의 전체 URL(후행 슬래시 포함)입니다. 자세한 내용은 <https://matomo.org/>를 참조하세요.

힌트

이 통합은 Matomo Tag Manager를 지원하지 않습니다.

예시:

MATOMO_SITE_ID = 1
MATOMO_URL = "https://example.matomo.cloud/"

더 보기

MATOMO_SITE_ID

NEARBY_MESSAGES

편집중인 문자열의 주위 몇 개를 표시할지 지정합니다.

이것은 기본값일 뿐이며, 사용자는 사용자 프로필 에서 조정할 수 있습니다.

DEFAULT_PAGE_LIMIT

Added in version 4.7.

페이지네이션이 활성화된 경우 표시할 기본 요소 수.

PAGURE_CREDENTIALS

Added in version 4.3.2.

Pagure 서버의 자격 증명 목록.

PAGURE_CREDENTIALS = {
    "pagure.io": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

구성 딕셔너리는 각 API 호스트에 대해 정의된 인증 정보로 구성됩니다. 거의 모든 버전 관리 통합에서 레이아웃이 동일하며 버전 관리 자격 증명 구성 에 설명되어 있습니다.

더 보기

PASSWORD_MINIMAL_STRENGTH

Added in version 5.10.2.

zxcvbn 비밀번호 강도 평가기에 의해 평가되는 최소 비밀번호 점수.

기본값은 0이며, 이는 강도 검사가 비활성화됨을 의미합니다.

더 보기

PASSWORD_RESET_URL

Added in version 5.17.

LDAP, SAML 또는 OAuth와 같은 외부 ID 제공자가 인증을 처리할 때 비밀번호 재설정 URL.

설정하면 로그인 페이지의 비밀번호를 잊으셨나요? 가 Weblate의 내장 비밀번호 재설정 페이지 대신 이 URL로 연결됩니다.

PRIVACY_URL

Added in version 4.8.1.

Weblate 인스턴스에서 개인정보 처리방침을 표시하는 URL.

힌트

Useful if you host your privacy policy outside Weblate instead of using the 법적 모듈 module. When the legal module is enabled, Weblate links to the internal legal pages by default.

예시:

PRIVACY_URL = "https://weblate.org/terms/"

더 보기

LEGAL_URL

PRIVATE_COMMIT_EMAIL_OPT_IN

Added in version 4.15.

개인 커밋 이메일 수신 여부를 선택(옵트인) 또는 거부(옵트아웃)로 설정할 수 있습니다(기본값: 옵트인).

힌트

이 설정은 커밋 이메일을 명시적으로 선택하지 않은 사용자에게만 적용됩니다.

더 보기

PRIVATE_COMMIT_EMAIL_TEMPLATE

Added in version 4.15.

사용자의 비공개 커밋 이메일을 생성하는 템플릿입니다. 기본값은 "{username}@users.noreply.{site_domain}" 입니다.

{user_id}, {username}, {site_title}, {site_domain} 을 포함할 수 있습니다.

비활성화하려면 비우기.

참고

다른 커밋 이메일을 사용하는 것은 PRIVATE_COMMIT_EMAIL_OPT_IN 으로 구성되지 않는 한 사용자에게 옵트인입니다. 사용자는 프로필 에서 커밋 이메일을 구성할 수 있습니다.

PRIVATE_COMMIT_NAME_OPT_IN

Added in version 5.16.

개인 커밋 이름 수신 여부를 선택(옵트인) 또는 거부(옵트아웃)로 설정합니다 (기본값: 옵트인).

힌트

이 설정은 커밋 이름을 명시적으로 선택하지 않은 사용자에게만 적용됩니다.

더 보기

PRIVATE_COMMIT_NAME_TEMPLATE

Added in version 5.16.

사용자의 비공개 커밋 이름을 생성하는 템플릿입니다. 기본값은 "{site_title} user {user_id}" 입니다.

{user_id}, {username}, {site_title}, {site_domain} 을 포함할 수 있습니다.

비활성화하려면 비우기.

참고

다른 커밋 이름을 사용하는 것은 PRIVATE_COMMIT_NAME_OPT_IN 으로 구성되지 않는 한 사용자에게 옵트인입니다. 사용자는 프로필 에서 커밋 이름을 구성할 수 있습니다.

PROJECT_BACKUP_KEEP_COUNT

Added in version 4.14.

프로젝트별 서버에 보관되는 백업 수를 정의합니다. 기본값은 3입니다.

더 보기

프로젝트 수준 백업

PROJECT_BACKUP_KEEP_DAYS

Added in version 4.14.

프로젝트 백업이 서버에 보관되는 기간을 정의합니다. 기본값은 30일입니다.

더 보기

프로젝트 수준 백업

PROJECT_BACKUP_UPLOAD_MAX_SIZE

Added in version 5.17.1.

업로드된 프로젝트 백업 ZIP 파일의 최대 크기(바이트)를 구성합니다. 기본값은 536870912바이트(512MiB)입니다.

Docker에서는 WEBLATE_PROJECT_BACKUP_UPLOAD_MAX_SIZE 환경 변수를 사용하여 설정합니다. Docker 설정은 CLIENT_MAX_BODY_SIZE 의 제약도 받을 수 있으며, 다른 배포는 리버스 프록시의 요청 본문 크기 제한에 제약될 수 있습니다.

더 보기

프로젝트 수준 백업

PROJECT_BACKUP_IMPORT_MAX_MEMBERS

Added in version 5.17.

프로젝트 백업을 가져올 때 허용되는 최대 ZIP 항목 수를 정의합니다.

잘못된 형식이거나 의도적으로 분할된 아카이브에 대한 안전 장치입니다. 기본값은 100,000개 항목입니다.

Docker에서는 WEBLATE_PROJECT_BACKUP_IMPORT_MAX_MEMBERS 환경 변수를 사용하여 설정합니다.

더 보기

프로젝트 수준 백업

PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE

Added in version 5.17.1.

가져온 프로젝트 백업 안의 ZIP 항목에 대해 압축 해제된 총 최대 크기(바이트)를 정의합니다. 기본값은 536870912바이트(512MiB)입니다.

업로드할 때는 작지만 유효성 검사나 복원 중 훨씬 많은 데이터로 확장되는 아카이브를 제한합니다.

Docker에서는 WEBLATE_PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE 환경 변수를 사용하여 설정합니다.

더 보기

프로젝트 수준 백업

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE

Added in version 5.17.

가져온 프로젝트 백업에서 고도로 압축된 단일 ZIP 항목의 최대 비압축 크기(바이트)를 정의합니다.

이 제한은 충분히 크고 의심스러울 정도로 압축되는 항목에만 적용됩니다. 크고 압축률이 낮은 파일은 의도적으로 허용되며 HTTP 업로드 제한에 의해 제한될 것으로 예상됩니다. 기본값은 262,144,000바이트(250MiB)입니다.

Docker에서는 WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE 환경 변수를 사용하여 설정합니다.

더 보기

프로젝트 수준 백업

PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE

Added in version 5.17.

프로젝트 백업 가져오기 시 Weblate가 ZIP 압축 비율을 고려하기 시작하는 최소 비압축 크기(바이트)를 정의합니다.

압축률이 높은 적절한 크기의 파일이 거부되는 것을 방지하기 위해 작은 파일은 압축률 기반 유효성 검사에서 무시됩니다. 기본값은 1,048,576바이트(1MiB)입니다.

Docker에서는 WEBLATE_PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE 환경 변수를 사용하여 설정합니다.

더 보기

프로젝트 수준 백업

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO

Added in version 5.17.

프로젝트 백업 가져오기 시 대형 ZIP 항목의 비압축 크기와 압축 크기 간 최대 허용 비율을 정의합니다.

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE 및 PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE 와 함께 사용하여 의심스럽게 압축된 항목을 감지하면서도 대형 저장소 팩 파일 및 기타 저압축 콘텐츠는 여전히 허용합니다. 기본값은 250입니다.

Docker에서는 WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO 환경 변수를 사용하여 설정합니다.

더 보기

프로젝트 수준 백업

PROJECT_NAME_RESTRICT_RE

Added in version 4.15.

프로젝트 이름 지정을 제한하는 정규 표현식을 정의합니다. 일치하는 이름은 거부됩니다.

더 보기

프로젝트 이름

PROJECT_WEB_RESTRICT_HOST

Added in version 4.16.2.

프로젝트 웹사이트에서 특정 호스트 사용을 거부합니다. 하위 도메인도 일치하므로 example.com 을 포함하면 test.example.com 도 차단됩니다. 목록에는 소문자 문자열만 포함해야 하며, 분석된 도메인은 일치 전에 소문자로 변환됩니다.

기본 구성:

PROJECT_WEB_RESTRICT_HOST = {"localhost"}

더 보기

PROJECT_WEB_RESTRICT_ALLOWLIST

Added in version 5.17.

프로젝트 웹사이트 유효성 검사 시 PROJECT_WEB_RESTRICT_HOST, PROJECT_WEB_RESTRICT_NUMERIC, PROJECT_WEB_RESTRICT_PRIVATE, PROJECT_WEB_RESTRICT_RE 에서 면제되는 프로젝트 슬러그 집합을 정의합니다. 프로젝트 슬러그는 대소문자 구분 없이 일치합니다.

조심

이 면제는 PROJECT_WEB_RESTRICT_PRIVATE 에 의해 적용되는 비공개 대상 제한을 포함하여 일치하는 프로젝트에 대한 발신 URL 보호를 약화합니다. 이러한 검사를 우회하는 것이 의도적인 신뢰할 수 있는 관리자 관리 프로젝트에만 사용하세요.

기본 구성:

PROJECT_WEB_RESTRICT_ALLOWLIST = set()

더 보기

PROJECT_WEB_RESTRICT_NUMERIC

Added in version 4.16.2.

프로젝트 웹사이트에서 숫자 IP 주소 사용을 거부합니다. 기본적으로 켜져 있습니다.

더 보기

PROJECT_WEB_RESTRICT_PRIVATE

Added in version 5.17.

내부 또는 비공개 주소를 가리키는 프로젝트 웹사이트 및 저장소 브라우저 URL 사용을 거부합니다. 기본적으로 켜져 있습니다.

더 보기

PROJECT_WEB_RESTRICT_RE

Added in version 4.15.

프로젝트 웹사이트 에 입력할 수 있는 내용을 제한하는 정규 표현식을 정의합니다. 일치하는 URL은 거부됩니다.

더 보기

WEBHOOK_PRIVATE_ALLOWLIST

Added in version 5.17.

발신 웹훅 전달 시 WEBHOOK_RESTRICT_PRIVATE 에서 면제되는 호스트 이름 또는 도메인을 정의합니다. 항목은 Django 호스트 일치 시맨틱스를 따르므로 hooks.internal.example 또는 .internal.example 과 같은 값을 사용할 수 있습니다.

기본 구성:

WEBHOOK_PRIVATE_ALLOWLIST = []

더 보기

WEBHOOK_RESTRICT_PRIVATE

Added in version 5.17.

대상 호스트가 WEBHOOK_PRIVATE_ALLOWLIST 에 포함되지 않는 한 내부 또는 비공개 주소를 가리키는 웹훅 URL을 거부합니다. 기본적으로 켜져 있습니다.

활성화하면 유효성 검사 중 확인할 수 없는 호스트 이름은 WEBHOOK_PRIVATE_ALLOWLIST 에 명시적으로 포함되지 않는 한 거부됩니다.

더 보기

PUBLIC_ENGAGE

Added in version 5.16.2.

REQUIRE_LOGIN 이 설정되어 있어도 공개 참여 페이지를 허용합니다.

더 보기

REPORT_EXPIRY

Defines how many days generated translation reports are retained. Defaults to 90 days. Changing the value also changes when existing reports become eligible for removal by the daily cleanup task.

RATELIMIT_NOTIFICATION_LIMITS

Added in version 5.14.

단일 사용자에게 전송되는 알림 수를 제한합니다.

기본 설정:

# Multi-level rate limiting for email notifications
# Each tuple contains (max_emails, time_window_seconds)
RATELIMIT_NOTIFICATION_LIMITS = [
    # Prevent burst sends - 3 emails per 2 minutes
    (3, 120),
    # Equalize to avoid getting blocked for too long - 10 emails per hour
    (10, 3600),
    # Daily limit: 50 emails per day
    (50, 86400),
]

RATELIMIT_ATTEMPTS

속도 제한이 적용되기 전의 최대 인증 시도 횟수.

기본값은 5입니다.

더 보기

RATELIMIT_WINDOW

속도 제한 적용 후 인증이 허용되는 기간.

초 단위이며, 기본값은 300(5분)입니다.

더 보기

RATELIMIT_LOCKOUT

속도 제한 적용 후 인증이 잠기는 기간.

초 단위이며, 기본값은 600(10분)입니다.

더 보기

REGISTRATION_ALLOW_BACKENDS

Added in version 4.1.

등록을 허용할 인증 백엔드 목록입니다. 새 등록만 제한하며, 사용자는 모든 설정된 인증 백엔드를 사용하여 인증하고 인증을 추가할 수 있습니다.

등록 백엔드를 제한하면서 REGISTRATION_OPEN 을 켜두는 것이 권장됩니다. 그렇지 않으면 사용자가 등록할 수 있지만 Weblate 사용자 인터페이스에 등록 링크가 표시되지 않습니다.

예시:

REGISTRATION_ALLOW_BACKENDS = ["azuread-oauth2", "azuread-tenant-oauth2"]

힌트

백엔드 이름은 인증 URL에 사용되는 이름과 일치합니다.

더 보기

REGISTRATION_CAPTCHA

새 계정 등록이 CAPTCHA로 보호되는지 여부. 기본적으로 활성화.

활성화하면 사용자가 이메일 주소를 입력하는 모든 페이지에 CAPTCHA가 추가됩니다:

  • 새 계정 등록.

  • 비밀번호 복구.

  • 계정에 이메일 추가.

  • 로그인하지 않은 사용자의 문의 양식.

현재 보호는 다음 단계로 구성됨:

REGISTRATION_EMAIL_MATCH

등록할 수 있는 이메일 주소를 필터링할 수 있습니다.

기본값은 .* 이며, 모든 이메일 주소의 등록을 허용합니다.

단일 이메일 도메인으로 등록을 제한하는 데 사용할 수 있음:

REGISTRATION_EMAIL_MATCH = r"^.*@weblate\.org$"

REGISTRATION_ALLOW_DISPOSABLE_EMAILS

Added in version 5.16.1.

일회용 이메일 도메인으로의 등록을 허용합니다. 활성화하면 일회용 도메인 차단 목록이 우회됩니다. 기본값은 False 입니다.

더 보기

REGISTRATION_OPEN

현재 새 계정 등록이 허용되는지 여부. 기본적으로 활성화.

이 설정은 이메일 주소를 통한 내장 인증 또는 Python Social Auth를 통한 인증에 영향을 미칩니다 ( REGISTRATION_ALLOW_BACKENDS 를 사용하여 특정 백엔드를 허용할 수 있습니다).

참고

LDAP 인증 와 같은 서드파티 인증 방법을 사용하는 경우 등록 양식만 숨기지만, 새 사용자가 여전히 로그인하고 계정을 만들 수 있을 수 있습니다.

더 보기

REGISTRATION_REBIND

Added in version 4.16.

기존 사용자의 인증 백엔드 재바인딩을 허용합니다. 인증 제공자 간 마이그레이션 시 활성화하세요.

참고

기존 계정에 다른 인증 백엔드를 추가하지 못하도록 기본적으로 꺼져 있습니다. 더 많은 서드파티 인증 백엔드를 사용하는 경우 재바인딩은 계정 침해로 이어질 수 있습니다.

REPOSITORY_ALERT_THRESHOLD

Added in version 4.0.2.

오래된 저장소 또는 변경사항이 너무 많은 저장소에 대한 알림을 트리거하는 임계치입니다. 기본값은 25입니다.

더 보기

번역 구성요소 진단

REQUIRE_LOGIN

Added in version 4.1.

이 설정은 django.contrib.auth.middleware.LoginRequiredMiddleware 를 활성화하고 REST 프레임워크가 모든 API 엔드포인트에 인증을 요구하도록 구성합니다.

버전 5.15에서 변경: Weblate는 이제 Django 내장 미들웨어에 의존합니다.

참고

이는 샘플 설정 에 구현되어 있습니다. Docker에서는 WEBLATE_REQUIRE_LOGIN 을 사용하세요.

GOOGLE_CLOUD_ERROR_REPORTING

Google Cloud Error Reporting을 사용한 오류 보고 수집 및 성능 모니터링 구성입니다. 통합을 비활성화하려면 None 으로 지정하고, Google Cloud Error Reporting 클라이언트의 키워드 인수 딕셔너리로 지정할 수도 있습니다.

Weblate는 service 를 weblate 로, version 을 현재 Weblate 버전 또는 Git 리비전으로 자동 제공합니다. 딕셔너리에 명시한 값은 이 기본값을 재정의합니다.

OPENTELEMETRY_ENABLED

Added in version 2026.6.

OpenTelemetry를 사용한 백엔드 추적을 활성화합니다. 기본적으로 비활성화되어 있습니다.

이 설정이 활성화되고 OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT 가 구성된 경우에만 추적이 내보내집니다.

OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT

OpenTelemetry용 OTLP HTTP 추적 엔드포인트입니다. 예: https://collector.example.com/v1/traces.

OPENTELEMETRY_EXPORTER_OTLP_HEADERS

OpenTelemetry OTLP 내보내기 도구에 대한 추가 HTTP 헤더입니다. 기본값은 빈 딕셔너리입니다.

OPENTELEMETRY_EXTRA_RESOURCE_ATTRIBUTES

추가 OpenTelemetry 리소스 속성입니다. 기본값은 빈 딕셔너리입니다.

OPENTELEMETRY_SERVICE_NAME

OpenTelemetry 서비스 이름입니다. 기본값은 weblate 입니다.

OPENTELEMETRY_TRACES_SAMPLE_RATE

OpenTelemetry 추적의 샘플링 비율을 구성합니다. 1로 설정하면 모든 이벤트를 추적하고, 0(기본값)은 추적을 비활성화합니다.

SENTRY_DSN

오류 보고 수집 및 성능 모니터링 에 사용할 Sentry DSN입니다.

더 보기

Sentry용 Django 통합

SENTRY_ENVIRONMENT

Sentry의 환경을 구성합니다. 기본값은 devel 입니다.

SENTRY_MONITOR_BEAT_TASKS

Added in version 5.13.

Sentry로 Celery Beat 작업을 모니터링할지 여부를 구성합니다. 기본값은 True 입니다.

SENTRY_PROFILES_SAMPLE_RATE

성능 모니터링의 샘플링 비율을 구성합니다. 1로 설정하면 추적된 모든 이벤트를 프로파일링하고(기본값), 0은 프로파일링을 비활성화합니다.

더 보기

Sentry 성능 모니터링

SENTRY_SEND_PII

Sentry가 특정 개인 식별 정보를 수집하도록 허용합니다. 기본적으로 꺼져 있습니다.

버전 5.7에서 변경: 이제 기본적으로 꺼져 있으며, 이전에는 기본적으로 켜져 있었습니다.

SENTRY_TRACES_SAMPLE_RATE

프로파일링 모니터링의 샘플링 비율을 구성합니다. 1로 설정하면 모든 이벤트를 추적하고, 0(기본값)은 추적을 비활성화합니다.

더 보기

Sentry Profiling

SIMPLIFY_LANGUAGES

기본 언어/국가 조합에 대해 간단한 언어 코드를 사용합니다. 예를 들어 fr_FR 번역은 fr 언어 코드를 사용합니다. 이러한 기본 조합의 언어 목록을 단순화하므로 일반적으로 원하는 동작입니다.

각 변형에 대해 다른 번역을 원하는 경우 이 설정을 끄세요.

HIDE_SHARED_GLOSSARY_COMPONENTS

Added in version 5.16.

용어집 구성 요소는 일반적으로 번역 작업에서 사용할 수 있도록 다른 프로젝트에 공유됩니다. 이를 사용하는 프로젝트의 구성 요소 목록에 표시되면 혼란을 야기하거나 번역해야 하는 실제 구성 요소에서 번역자의 주의를 분산시킬 수 있습니다.

기본적으로 꺼져 있어 공유된 용어집 구성 요소가 표시됩니다.

SITE_DOMAIN

사이트 도메인을 구성합니다. 많은 범위에서 올바른 절대 링크를 생성하는 데 필요합니다(예: 활성화 이메일, 알림 또는 RSS 피드).

Weblate가 비표준 포트에서 실행 중인 경우 여기에 포함시키세요.

예시:

# Production site with domain name
SITE_DOMAIN = "weblate.example.com"

# Local development with IP address and port
SITE_DOMAIN = "127.0.0.1:8000"

참고

이 설정에는 도메인 이름만 포함해야 합니다. 프로토콜 구성(HTTPS 활성화 및 적용)은 ENABLE_HTTPS 를, URL 변경은 URL_PREFIX 를 사용하세요.

힌트

Docker 컨테이너에서는 WEBLATE_ALLOWED_HOSTS 를 통해 사이트 도메인을 구성합니다.

더 보기

SITE_TITLE

웹사이트와 발송 이메일에 사용될 사이트 제목입니다.

SPECIAL_CHARS

시각적 키보드 에 포함할 추가 문자입니다.

기본값은 다음과 같습니다:

SPECIAL_CHARS = ("\t", "\n", "\u00a0", "…")

SINGLE_PROJECT

대시보드를 표시하는 대신 사용자를 프로젝트 또는 구성 요소로 직접 리디렉션합니다. True 로 설정하면 Weblate에 실제로 단일 프로젝트가 있는 경우에만 작동합니다. 또는 프로젝트 슬러그를 설정하면 해당 프로젝트로 무조건 리디렉션됩니다.

예시:

SINGLE_PROJECT = "test"

SSH_EXTRA_ARGS

Added in version 4.9.

Weblate가 SSH를 호출할 때 사용자 정의 매개변수를 추가할 수 있습니다. 레거시 암호화或其他 비표준 기능을 사용하는 서버에 연결할 때 유용합니다.

예를 들어 Weblate에서 SSH 연결이 Unable to negotiate with legacyhost: no matching key exchange method found. Their offer: diffie-hellman-group1-sha1 오류로 실패하는 경우 다음을 사용하여 활성화할 수 있습니다:

SSH_EXTRA_ARGS = "-oKexAlgorithms=+diffie-hellman-group1-sha1"

힌트

문자열은 셸에 의해 평가되므로 공백과 특수 문자를 따옴표로 감싸야 합니다.

경고

This is trusted administrator-controlled configuration. Arbitrary SSH options can alter connection routing and override the address pinning provided by VCS_RESTRICT_PRIVATE. Administrators are responsible for the security and compatibility impact of all configured arguments.

더 보기

OpenSSH 레거시 옵션

STATUS_URL

Weblate 인스턴스가 상태를 보고하는 URL입니다.

SUPPORT_STATUS_CHECK

Added in version 5.5.

활성 지원 구독이 없는 경우 반기별 지원 상태 확인과 로그인 시 슈퍼유저를 기부 페이지로 리디렉션하는 것을 비활성화합니다.

힌트

이 설정을 끄는 대신 지원 구독을 구매하고 Weblate 발전을 지원하여 Weblate 경험을 향상시키세요.

TRANSLATION_UPLOAD_MAX_SIZE

Added in version 5.17.1.

업로드된 번역 파일의 최대 크기(바이트)를 구성합니다. 기본값은 50MB입니다.

Docker에서는 WEBLATE_TRANSLATION_UPLOAD_MAX_SIZE 환경 변수를 사용하여 구성합니다.

UNUSED_ALERT_DAYS

Added in version 4.17.

구성 요소가 사용되지 않는 것 같습니다 경고가 트리거되는 시기를 구성합니다.

기본값은 365일이며, 0으로 설정하면 끕니다.

UPDATE_LANGUAGES

Added in version 4.3.2.

데이터베이스 마이그레이션 실행 시 언어 데이터베이스를 업데이트할지 여부를 제어하며 기본적으로 켜져 있습니다. 이 설정은 setuplang 호출에는 영향을 미치지 않습니다.

경고

이로 인해 언어 표시가 일치하지 않을 수 있습니다. Weblate 언어 정의는 시간이 지남에 따라 확장되며 정의된 언어의 언어 코드를 표시하지 않습니다.

더 보기

내장 언어 정의

URL_PREFIX

이 설정을 사용하면 특정 경로에서 Weblate를 실행할 수 있습니다(그렇지 않으면 웹서버 루트에서 실행되는 것에 의존).

참고

이 설정을 사용하려면 서버에서 이 접두사를 제거하도록 구성해야 합니다. 예를 들어 WSGI에서는 WSGIScriptAlias 를 설정하여 이를 달성할 수 있습니다.

힌트

접두사는 / 로 시작해야 합니다.

예시:

URL_PREFIX = "/translations"

참고

이 설정은 Django의 내장 서버에서는 작동하지 않으며, urls.py 를 조정하여 이 접두사를 포함시켜야 합니다.

VCS_ALLOW_HOSTS

Added in version 5.15.

VCS URL을 구성할 때 허용할 호스트 집합입니다. 기본값은 빈 집합으로, 필터링을 전혀 하지 않습니다.

When VCS_RESTRICT_PRIVATE is enabled, matching hosts are also exempt from the private-target restriction. This exemption is also needed for VCS backends which cannot bind the client connection to the address validated by Weblate, such as Mercurial and Subversion.

VCS_ALLOW_SCHEMES

Added in version 5.15.

VCS URL을 구성할 때 허용할 URL 스키마 집합입니다. 기본적으로 https 및 ssh 만 허용됩니다.

VCS_RESTRICT_PRIVATE

Added in version 5.17.

대상 호스트가 VCS_ALLOW_HOSTS 에 포함되지 않는 한 내부 또는 비공개 주소를 가리키는 VCS 저장소 URL을 거부합니다. 기본적으로 켜져 있습니다.

활성화하면 유효성 검사 중 확인할 수 없는 호스트 이름은 VCS_ALLOW_HOSTS 에 명시적으로 포함되지 않는 한 거부됩니다.

For Git repositories accessed over HTTPS or SSH, Weblate binds each VCS command to the addresses approved during runtime validation for direct connections. Configured HTTP proxies are trusted infrastructure and resolve repository hostnames instead. Automatic redirect following remains disabled. Permanent same-host HTTP redirects are probed separately through the same outbound route, validated, and stored as the canonical component repository URL. Cross-host redirects have to be configured manually. Mercurial, Subversion, custom VCS backends, and additional URL schemes are rejected unless the target host is explicitly included in VCS_ALLOW_HOSTS.

Network-level egress filtering which blocks internal, loopback, link-local, reserved, and cloud metadata address ranges is recommended as defense in depth, especially for custom integrations and administrator-installed extensions.

VCS_API_DELAY

Added in version 4.15.1.

GitHub 풀 리퀘스트, GitLab 병합 요청, Gitea 풀 리퀘스트, Pagure 병합 요청, Azure DevOps 풀 리퀘스트 에서 타사 API 호출 사이의 최소 지연 시간(초)을 구성합니다.

이 설정은 서비스 과부하를 방지하기 위해 Weblate에서 이러한 서비스로의 API 호출을 속도 제한합니다.

GitHub의 보조 속도 제한기에 의해 제한되는 경우 이 값을 늘리면 도움이 될 수 있습니다.

기본값은 10입니다.

VCS_API_TIMEOUT

Added in version 5.15.

GitHub 풀 리퀘스트, GitLab 병합 요청, Gitea 풀 리퀘스트, Pagure 병합 요청, Azure DevOps 풀 리퀘스트 에서 포크 또는 병합 요청 생성 같은 타사 API 호출의 타임아웃(초)을 구성합니다.

기본값은 10입니다.

VCS_BACKENDS

사용 가능한 VCS 백엔드의 구성입니다.

참고

Weblate는 도구가 있는 모든 지원 백엔드를 사용하려고 시도합니다.

힌트

이를 사용하여 선택지를 제한하거나 사용자 정의 VCS 백엔드를 추가할 수 있습니다.

VCS_BACKENDS = ("weblate.vcs.git.GitRepository",)

더 보기

버전 관리 통합

VCS_CLONE_DEPTH

Weblate가 저장소를 얼마나 깊이 클론할지를 구성합니다.

참고

현재 Git 에서만 지원됩니다. 기본적으로 Weblate는 클론 속도를 높이고 디스크 공간을 절약하기 위해 저장소의 얕은 클론을 수행합니다. 사용 방식에 따라(예: 사용자 정의 애드온 사용 시) 깊이를 늘리거나 0으로 설정하여 얕은 클론을 완전히 끌 수 있습니다.

힌트

Weblate에서 푸시할 때 fatal: protocol error: expected old/new/ref, got 'shallow <commit hash>' 오류가 발생하면 다음을 설정하여 얕은 클론을 완전히 끄세요:

VCS_CLONE_DEPTH = 0

WEBLATE_ADDONS

사용 가능한 애드온 목록입니다. 사용하려면 특정 번역 구성 요소에 대해 활성화해야 합니다. 기본적으로 모든 내장 애드온이 포함되며, 목록을 확장할 때 기존 애드온을 활성화 상태로 유지하고 싶을 것입니다. 예:

WEBLATE_ADDONS = (
    # Built-in add-ons
    "weblate.addons.gettext.GenerateMoAddon",
    "weblate.addons.gettext.UpdateLinguasAddon",
    "weblate.addons.gettext.UpdateConfigureAddon",
    "weblate.addons.gettext.MsgmergeAddon",
    "weblate.addons.gettext.GettextAuthorComments",
    "weblate.addons.cleanup.CleanupAddon",
    "weblate.addons.consistency.LanguageConsistencyAddon",
    "weblate.addons.discovery.DiscoveryAddon",
    "weblate.addons.flags.SourceEditAddon",
    "weblate.addons.flags.TargetEditAddon",
    "weblate.addons.flags.SameEditAddon",
    "weblate.addons.flags.BulkEditAddon",
    "weblate.addons.generate.GenerateFileAddon",
    "weblate.addons.properties.PropertiesSortAddon",
    "weblate.addons.git.GitSquashAddon",
    "weblate.addons.removal.RemoveComments",
    "weblate.addons.removal.RemoveSuggestions",
    "weblate.addons.resx.ResxUpdateAddon",
    "weblate.addons.autotranslate.AutoTranslateAddon",
    "weblate.addons.cdn.CDNJSAddon",
    # Add-on you want to include
    "weblate.addons.example.ExampleAddon",
)

참고

목록에서 애드온을 제거해도 구성 요소에서 제거되지 않습니다. 이 경우 Weblate가 충돌합니다. 이 목록에서 제거하기 전에 모든 구성 요소에서 애드온을 제거하세요.

더 보기

ADDON_ACTIVITY_LOG_EXPIRY

Added in version 5.6.

애드온의 활동 로그 보관 기간을 구성합니다. 기본값은 180일입니다.

WEBLATE_EXPORTERS

Added in version 4.2.

List of available exporters offering translation downloads or glossaries in various file formats.

더 보기

현지화 파일 형식

WEBLATE_FORMATS

사용 가능한 파일 형식 목록입니다.

참고

기본 목록에는 이미 일반적인 형식이 포함되어 있습니다.

더 보기

현지화 파일 형식

WEBLATE_MACHINERY

Added in version 4.13.

사용 가능한 기계 번역 서비스 목록입니다.

더 보기

WEBLATE_GPG_IDENTITY

Weblate가 Git 커밋에 서명하는 데 사용하는 신원입니다. 예:

WEBLATE_GPG_IDENTITY = "Weblate <weblate@example.com>"

Weblate GPG 키링에서 일치하는 키를 검색합니다(DATA_DIR 아래의 home/.gnupg). 찾지 못하면 키가 생성됩니다. 자세한 내용은 GnuPG로 Git 커밋 서명 를 참조하세요.

더 보기

GnuPG로 Git 커밋 서명

WEBSITE_REQUIRED

프로젝트 생성 시 프로젝트 웹사이트 을 지정해야 하는지 정의합니다. 공개 서버 설정에 적합하므로 기본적으로 켜져 있습니다.

WEBSITE_ALERTS_ENABLED

Added in version 5.17.

기본값: True

Weblate가 프로젝트 웹사이트 가용성을 확인하고 접근할 수 없는 프로젝트 웹사이트에 대한 경고를 표시할지 정의합니다.

False 로 설정하면 Weblate는 웹사이트 가용성 확인을 건너뛰고 프로젝트 웹사이트 경고를 생성하지 않습니다. 이는 다음과 같은 경우에 유용합니다:

  • 웹사이트가 Weblate의 요청을 차단하는 방화벽 뒤에 있는 경우

  • 봇 보호로 인한 403/503 유형 오류를 피하고 싶은 경우

  • 설치 환경에서 프로젝트 웹사이트 가용성이 중요하지 않은 경우

더 보기

WEBSITE_REQUIRED

버전 관리 자격 증명 구성

힌트

이 섹션에서는 GITHUB_CREDENTIALS, GITLAB_CREDENTIALS, GITEA_CREDENTIALS, PAGURE_CREDENTIALS, BITBUCKETSERVER_CREDENTIALS 와 같은 VCS 자격 증명 변수를 설명합니다.

설정 딕셔너리는 각 API 호스트에 대해 정의된 자격 증명으로 구성됩니다. API 호스트는 웹 브라우저에서 사용하는 것과 다를 수 있습니다. 예를 들어 GitHub API는 api.github.com 로 접근합니다.

자격 증명은 저장소 푸시 URL 또는 소스 코드 저장소 (푸시 URL이 구성되지 않은 경우)에서 재정의할 수 있으며, 구성 파일에 지정된 것보다 우선합니다.

다음 호스트별 설정을 사용할 수 있음:

username

API 사용자. 필수.

token

API 사용자의 API 토큰. 필수.

scheme

Added in version 4.18.

스킴 재정의. Weblate는 저장소 URL에서 스킴을 파싱하려고 시도하고 https 로 폴백합니다. API 서버를 내부에서 실행하는 경우 http 를 사용할 수 있지만 보안을 고려하세요.

힌트

Docker 컨테이너에서는 환경 변수를 사용하여 자격 증명을 구성할 수 있습니다. Code-hosting sites credentials 참조.