LibreChat

LibreChat 엔드포인트 설정을 마운트하고 사용자별 키를 사용합니다.

설치 및 준비

Git, Docker, Docker Compose를 설치하고 LibreChat Docker 가이드에 따라 저장소 복제, .env.example을 .env로 복사, MongoDB 포함 스택 시작을 완료합니다. http://localhost:3080에서 가입합니다. 엔드포인트 선택 전 각 사용자는 routerra.ai/keys에서 자신의 키를 만듭니다.

git clone https://github.com/LibreChat-AI/LibreChat.git
cd LibreChat
cp .env.example .env
docker compose up -d

연결 구성

저장소 루트에 아래 librechat.yaml을 만듭니다. version은 앱이 아닌 YAML 스키마 버전입니다. docker-compose.override.yml에서 api 서비스의 /app/librechat.yaml로 마운트합니다. apiKey: user_provided이면 로그인 사용자가 routerra.ai 선택 시 YOUR_API_KEY를 직접 입력하므로 공유 키 환경 변수가 필요 없습니다. 공유 키는 apiKey: "${ROUTERRA_API_KEY}"로 바꾸고 .env에 ROUTERRA_API_KEY=YOUR_API_KEY를 추가합니다.

version: 1.3.17
endpoints:
  custom:
    - name: routerra.ai
      apiKey: user_provided
      baseURL: https://routerra.ai/v1
      models:
        default: [YOUR_MODEL_ID]
        fetch: false

설정 마운트

루트 docker-compose.override.yml에 이 볼륨을 추가하고 기존 api 설정과 병합합니다.

services:
  api:
    volumes:
      - ./librechat.yaml:/app/librechat.yaml:ro

모델 선택 및 오류 해결

docker compose up -d --force-recreate로 재생성합니다. routerra.ai를 선택해 키를 입력하고 YOUR_MODEL_ID로 짧은 채팅을 보냅니다. fetch: false는 default 목록을, true는 서버 모델 검색을 사용합니다. 엔드포인트가 사라지면 마운트, 필수 name/baseURL/apiKey/models, YAML 들여쓰기와 이름 중복을 확인합니다. 시작 오류는 docker compose logs api로 확인합니다. 구성 변경 후 재시작이 필요합니다.