사용자 지정 설정

librechat.yaml이란 무엇인가요?

librechat.yaml 파일은 사용자 지정 AI endpoint, 모델 설정, 인터페이스 옵션, 그리고 MCP 서버 및 에이전트와 같은 고급 기능을 위한 LibreChat의 메인 설정 파일입니다. 이 파일은 선택 사항이며, 파일이 존재하지 않아도 LibreChat은 합리적인 기본값으로 작동합니다.

아래 단계에 따라 파일을 생성하고, 배포 유형에 맞게 마운트한 뒤, 정상적으로 작동하는지 확인하세요.

설정

touch librechat.yaml

cp librechat.example.yaml librechat.yaml

CONFIG_PATH="/alternative/path/to/librechat.yaml"

cp docker-compose.override.yml.example docker-compose.override.yml

services:
  api:
    volumes:
      - type: bind
        source: ./librechat.yaml
        target: /app/librechat.yaml

docker compose down && docker compose up -d

npm run backend

docker compose logs api

예시: OpenRouter 추가하기

이 예제는 가장 인기 있는 구성 중 하나인 OpenRouter를 사용자 지정 endpoint로 추가하는 과정을 안내합니다.

1. API 키를 가져오기 (openrouter.ai/keys에서).

2. .env 파일에 키를 추가합니다:

OPENROUTER_KEY=sk-or-v1-your-key-here

3. librechat.yaml에 endpoint 추가하기:

version: 1.3.5
cache: true
endpoints:
  custom:
    - name: "OpenRouter"
      apiKey: "${OPENROUTER_KEY}"
      baseURL: "https://openrouter.ai/api/v1"
      models:
        default: ["meta-llama/llama-3-70b-instruct"]
        fetch: true
      titleConvo: true
      titleModel: "meta-llama/llama-3-70b-instruct"
      dropParams: ["stop"]
      modelDisplayLabel: "OpenRouter"

4. LibreChat을 재시작하고 (위의 재시작 명령어 참조) 모델 선택기에서 OpenRouter를 선택하세요.

더 많은 endpoint 예시가 포함된 전체 주석 처리된 설정 파일은 예시 설정을 참조하세요.

참조

필드 수준의 자세한 문서는 아래 참조 페이지를 확인하세요.

문제 해결

LibreChat에서 변경 사항이 표시되지 않음

librechat.yaml을 수정했는데 UI에 아무런 변화가 없다면:

1. CONFIG_PATH를 설정하지 않았다면, 해당 파일이 LibreChat 프로젝트 루트에 있는지 확인하세요.
2. Docker의 경우, docker-compose.override.yml에 파일이 마운트되어 있는지 확인하세요.
3. docker compose down && docker compose up -d 명령어를 사용하여 LibreChat을 재시작하세요.
4. docker compose logs api 명령어로 API 로그를 확인하세요.
5. YAML Validator를 사용하여 파일을 검증하세요.

OpenRouter와 같은 사용자 지정 endpoint는 다음 세 가지 요소가 모두 올바르게 설정된 후에만 나타납니다: .env 파일에 키가 포함되어 있고, librechat.yaml 파일에 endpoint가 정의되어 있으며, Docker가 마운트된 설정 파일을 읽을 수 있어야 합니다.

구성 유효성 검사

서버가 시작 즉시 종료됨

서버가 시작된 직후 즉시 종료된다면, 이는 구성 유효성 검사 오류일 가능성이 높습니다.

진단하려면:

1. 서버 로그 확인: docker compose logs api
2. YAML Validator를 사용하여 YAML 구문을 검증하세요.
3. 일반적인 오류: 잘못된 들여쓰기, 누락된 콜론, 알 수 없는 키, 유효하지 않은 값

임시 해결 방법 (운영 환경에는 권장하지 않음):

CONFIG_BYPASS_VALIDATION=true