구성 구조

참고: 필수 항목으로 명시되지 않은 필드는 선택 사항입니다.

version

• 필수

cache

skillSync

참고: Skill Sync Object Structure

messageFilter

참조: Message Filter Object Structure

fileStrategy

• 옵션: "local" | "firebase" | "s3" | "azure_blob" | "cloudfront"

• 참고:
  • "cloudfront"는 파일을 S3에 저장하고 안정적인 미디어 전송, 서명된 쿠키(signed cookies) 및 서명된 다운로드(signed downloads)를 위해 CloudFront URL을 반환합니다.
  • "firebase"는 Firebase Storage 및 Firebase Hosting 엣지 위치를 통해 파일을 제공합니다.
  • S3는 만료되는 presigned URL(임시 서명 토큰)을 통해 파일을 제공합니다. 일단 만료되면 해당 URL을 참조하는 모든 이미지나 아바타는 UI에서 깨진 상태로 표시됩니다. 이로 인해 S3는 시각적 자산을 위한 기본 전략으로 적합하지 않습니다. 자세한 내용은 관련 토론을 참조하세요.
  • 이미지와 아바타의 최적 성능을 위해 "cloudfront" 또는 "firebase"를 사용하거나, fileStrategies를 구성하여 avatar 및 image를 CDN 기반 전략으로 라우팅하십시오.
  • 설정 세부 정보는 File Storage & CDN documentation을 참조하세요.

fileStrategies

다양한 파일 유형에 대한 파일 저장 전략을 세밀하게 제어할 수 있습니다.

• 사용 가능한 전략(Available Strategies): "local" | "firebase" | "s3" | "azure_blob" | "cloudfront"

하위 키:

• 참고:
  • 이 설정은 단일 fileStrategy 옵션보다 우선합니다.
  • 특정 파일 형식이 구성되지 않은 경우, default로 대체된 다음 fileStrategy로, 마지막으로 "local"로 대체됩니다.
  • 이미지와 아바타가 UI 전반에서 올바르게 렌더링되려면 지속적이고 안정적인 URL이 필요합니다. S3 사전 서명된 URL은 만료되기 때문에(AWS 제한: IAM 사용자의 경우 7일, STS/역할 기반 자격 증명의 경우 몇 시간), 모델 선택기 및 채팅 UI에서 이미지가 깨지는 현상이 발생합니다. 자세한 내용은 관련 토론을 참조하세요. 이를 방지하려면 avatar 및 image에 "cloudfront" 또는 "firebase"를 사용하세요.
  • S3 및 Azure Blob Storage는 수명이 짧은 사전 서명된(presigned) 다운로드 URL이 적합한 document 저장소로 사용하기에 매우 적합합니다.
  • 각 스토리지 공급자에 대한 설정 세부 정보는 File Storage & CDN documentation을 참조하세요.

예시:

# Use a single strategy for all file types
fileStrategies:
  default: 's3'

# Route images and avatars to CDN, keep documents in object storage
fileStrategies:
  avatar: 'cloudfront' # CDN delivery for avatars
  image: 'cloudfront' # CDN delivery for generated/uploaded images
  document: 's3' # Object storage for documents

# Only configure specific types, others use default
fileStrategies:
  default: 'local'
  avatar: 'firebase' # Only avatars use Firebase CDN, everything else is local

cloudfront

키:

하위 키(Subkeys):

참고: CloudFront Object Structure 및 CloudFront with S3

filteredTools

• 참고:
  • includedTools와 filteredTools가 모두 지정된 경우, includedTools만 인식됩니다.
  • gptPlugins 및 assistants endpoint 모두에 영향을 미칩니다.
  • 필터링할 도구의 이름은 api/app/clients/tools/manifest.json에서 확인할 수 있습니다.
    • pluginKey 값을 사용하세요
  • 또한, api/app/clients/tools/.well-known 디렉토리의 ".well-known" 아래에 나열된 모든 항목도 포함됩니다.
    • name_for_model 값을 사용하세요

includedTools

• 참고:
  • includedTools와 filteredTools가 모두 지정된 경우, includedTools만 인식됩니다.
  • gptPlugins 및 assistants endpoint 모두에 영향을 미칩니다.
  • 필터링할 도구의 이름은 api/app/clients/tools/manifest.json에서 확인할 수 있습니다.
    • pluginKey 값을 사용하세요
  • 또한, api/app/clients/tools/.well-known 디렉토리의 ".well-known" 아래에 나열된 모든 항목도 포함됩니다.
    • name_for_model 값을 사용하세요

secureImageLinks

imageOutputType

• 참고: 대소문자를 구분합니다. Google endpoint는 "jpeg" 및 "png" 출력 유형만 지원합니다.
• 옵션: "png" | "webp" | "jpeg"

ocr

키:

하위 키(Subkeys):

참고: OCR Config Object Structure

webSearch

키:

하위 키(Subkeys):

참고: Web Search Object Structure

fileConfig

키:

하위 키(Subkeys):

clientImageResize

키:

하위 키(Subkeys):

설명:

clientImageResize 구성은 업로드 전 클라이언트 측에서 자동으로 이미지 크기를 조정하는 기능을 활성화합니다. 이 기능은 다음을 지원합니다:

• 업로드 실패 방지: 대용량 이미지 파일이 서버 제한을 초과하는 문제 방지
• 전송 전에 이미지를 압축하여 대역폭 사용량을 줄이세요
• 업로드 성능 개선: 더 작은 파일 크기 사용
• 파일 크기를 최적화하면서 이미지 품질을 유지하세요

이 기능이 활성화되면, 지정된 maxWidth 또는 maxHeight 치수를 초과하는 이미지는 서버로 업로드되기 전에 클라이언트 측에서 자동으로 크기가 조정됩니다. 크기 조정은 이미지의 가로세로 비율을 유지하면서 지정된 범위 내에 맞도록 보장합니다.

예시:

fileConfig:
  clientImageResize:
    enabled: true
    maxWidth: 1920
    maxHeight: 1080
    quality: 0.8
    compressFormat: 'jpeg'

참고:

• 이미지 파일(JPEG, PNG, WebP 등)에만 적용됩니다.
• 이미지가 지정된 크기를 초과하면 자동으로 크기가 조정됩니다
• 크기 조정 중 원본 가로세로 비율이 유지됩니다
• 이 기능은 지원되는 모든 이미지 업로드 endpoint에서 작동합니다.
• Quality 설정은 JPEG 및 WebP 형식에만 적용됩니다.
• 품질을 너무 낮게(0.5 미만) 설정하면 눈에 띄는 이미지 품질 저하가 발생할 수 있습니다.

참고: File Config Object Structure

rateLimits

키:

하위 키(Subkeys):

fileUploads 하위 키:

conversationsImport 하위 키:

tts 하위 키:

stt 하위 키:

• 예시:

rateLimits:
  fileUploads:
    ipMax: 100
    ipWindowInMinutes: 60
    userMax: 50
    userWindowInMinutes: 60
  conversationsImport:
    ipMax: 100
    ipWindowInMinutes: 60
    userMax: 50
    userWindowInMinutes: 60
  stt:
    ipMax: 100
    ipWindowInMinutes: 1
    userMax: 50
    userWindowInMinutes: 1
  tts:
    ipMax: 100
    ipWindowInMinutes: 1
    userMax: 50
    userWindowInMinutes: 1

registration

키:

하위 키(Subkeys):

참고:

• socialLogins,
• alloweddomains,
• Registration Object Structure

memory

키:

하위 키(Subkeys):

참고: Memory Object Structure

summarization

키:

하위 키(Subkeys):

참고: Summarization Object Structure

actions

키:

하위 키(Subkeys):

참고:

• allowedDomains,
• allowedAddresses,
• Actions 객체 구조

interface

키:

하위 키(Subkeys):

참고: Interface Object Structure

modelSpecs

키:

하위 키(Subkeys):

참고: Model Specs Object Structure

endpoints

키:

하위 키(Subkeys):

참고: 엔드포인트는 streamRate, headers, titleModel, titleMethod, titlePrompt, titlePromptTemplate, titleEndpoint, maxToolResultChars와 같은 Shared Endpoint Settings을 지원합니다. 이러한 설정은 각 엔드포인트별로 개별적으로 구성하거나 all 키를 사용하여 전역적으로 구성할 수 있습니다. headers는 병합되며, 키 충돌 시 엔드포인트 수준의 값이 우선합니다. all 키는 baseURL을 허용하지 않습니다.

참고: endpoints.allowedAddresses는 사용자가 제공한 baseURL 값에 적용됩니다(관리자가 apiKey: 'user_provided' 및 baseURL: 'user_provided'로 사용자 지정 endpoint를 구성한 경우). 사용자가 제공한 각 baseURL은 요청 시점에 SSRF 차단 목록에 대해 검증되며, 여기에 나열된 항목은 예외로 처리됩니다. 필드 의미론에 대해서는 mcpSettings.allowedAddresses를 참조하십시오. 동일한 규칙이 적용됩니다(사설 IP 대역만 허용, 포트 필수, URL/경로/CIDR/베어 호스트/공용 IP 리터럴은 허용되지 않음).

mcpSettings

키:

하위 키(Subkeys):

• 참고:
  • 이는 MCP 서버를 통한 내부 주소의 남용/오용을 방지하기 위한 보안 기능입니다.
  • 기본적으로 LibreChat은 MCP 서버가 내부, 로컬 또는 사설 네트워크 주소에 연결하는 것을 제한합니다.
  • 로컬 IP 주소나 도메인을 사용하는 MCP 서버는 엄격한 allowedDomains 화이트리스트에 추가하거나(이 경우 해당 목록만 접근 가능해짐), 공용 목적지에 대한 접근성을 유지하려면 allowedAddresses를 통해 정확한 host:port 서비스로 예외 처리할 수 있습니다.
  • 모든 yaml 구성 변경 사항과 마찬가지로, 변경 사항을 적용하려면 LibreChat을 다시 시작해야 합니다.
  • 도메인, 와일드카드 서브도메인(*.example.com), Docker 도메인 및 IP 주소를 지원합니다.

예시:

mcpSettings:
  # Strict whitelist mode:
  # allowedDomains:
  #   - "example.com"           # Specific domain
  #   - "*.example.com"         # All subdomains
  #   - "http://mcp-server:3000" # Internal service, explicitly whitelisted

  # Default SSRF mode with private service exemptions:
  allowedAddresses:
    - 'host.docker.internal:8080' # Permit one private host on one port
    - '10.0.0.5:8000' # Permit one private IP on one port

참고: MCP Settings Object Structure

mcpServers

키:

하위 키(Subkeys):

• 참고:
  • 초기화는 시작 시점에 발생하며, 변경 사항을 적용하려면 앱을 다시 시작해야 합니다.
  • <serverName>은 각 MCP 서버 구성에 대한 고유 식별자입니다.
  • 각 MCP 서버는 다음 네 가지 연결 유형 중 하나를 사용하여 구성할 수 있습니다:
    • stdio
    • websocket
    • sse
    • streamable-http
  • type 필드는 MCP 서버에 대한 연결 유형을 지정합니다.
  • type이 생략된 경우, url 또는 command의 존재 여부와 형식에 따라 기본값이 결정됩니다:
    • url이 지정되어 있고 http 또는 https로 시작하는 경우, type은 기본적으로 sse로 설정됩니다.
    • url이 지정되어 있고 ws 또는 wss로 시작하는 경우, type은 기본적으로 websocket으로 설정됩니다.
    • command가 지정된 경우, type은 기본적으로 stdio로 설정됩니다.
  • 추가 구성 옵션은 다음과 같습니다:
    • timeout: MCP 서버 요청에 대한 밀리초 단위의 타임아웃입니다. 도구 요청에 대한 응답을 기다릴 시간을 결정합니다.
    • initTimeout: MCP 서버 초기화를 위한 밀리초 단위의 타임아웃입니다. 서버가 초기화될 때까지 대기할 시간을 결정합니다.
    • serverInstructions: 에이전트 컨텍스트에 서버 지침을 포함할지 여부를 제어합니다. true(서버 제공 지침 사용), false(비활성화), 또는 사용자 지정 문자열(서버 제공 지침을 재정의)로 설정할 수 있습니다.
    • customUserVars: (선택 사항) 개별 사용자가 MCP 서버에 대해 설정할 수 있는 사용자 지정 변수(예: API 키, URL)를 정의합니다. UI를 통해 제공되는 이러한 사용자별 값은 {{VARIABLE_NAME}} 구문을 사용하여 서버의 headers 또는 env 구성에서 참조할 수 있습니다. 이를 통해 MCP 도구에 대한 사용자별 인증 또는 사용자 지정이 가능합니다.
  • 참고: MCP Servers Object Structure

예시:

mcpServers:
  everything:
    # type: sse # type can optionally be omitted
    url: http://localhost:3001/sse
    timeout: 30000
    initTimeout: 10000
    serverInstructions: true # Use server-provided instructions
  puppeteer:
    type: stdio
    command: npx
    args:
      - -y
      - '@modelcontextprotocol/server-puppeteer'
    timeout: 30000
    initTimeout: 10000
    serverInstructions: 'Do not access any local files or local/internal IP addresses'
  filesystem:
    # type: stdio
    command: npx
    args:
      - -y
      - '@modelcontextprotocol/server-filesystem'
      - /home/user/LibreChat/
    iconPath: /home/user/LibreChat/client/public/assets/logo.svg
  mcp-obsidian:
    command: npx
    args:
      - -y
      - 'mcp-obsidian'
      - /path/to/obsidian/vault
  streamable-http-example:
    type: streamable-http
    url: https://example.com/mcp
    headers:
      Authorization: 'Bearer ${API_TOKEN}'
    timeout: 30000
  per-user-crendentials-example:
    type: sse
    url: 'https//some.mcp/sse'
    headers:
      X-Custom-Auth-Token: '{{USER_API_KEY}}' # Placeholder for the user-provided API key, defined in `customUserVars` below.
    customUserVars:
      USER_API_KEY:
        title: 'Service API Key'
        description: "Your personal API key for this service. You can get it <a href='https://example.com/api-keys' target='_blank'>here</a>."
    serverInstructions: true

참고: MCP Servers Object Structure

speech

키:

하위 키(Subkeys):

참고: Speech Object Structure

turnstile

키:

하위 키(Subkeys):

참고: Turnstile Object Structure

transactions

키:

하위 키(Subkeys):

참고: Transactions Object Structure

추가 링크

• 요약 객체 구조
• AWS Bedrock 객체 구조
• 사용자 지정 엔드포인트 객체 구조
• Azure OpenAI 엔드포인트 객체 구조
• Assistants Endpoint Object Structure
• 에이전트
• OCR 구성 객체 구조
• 음성 객체 구조
• Turnstile 객체 구조
• Transactions 객체 구조
• Balance 객체 구조
• 웹 검색 객체 구조
• Memory 객체 구조