LibreChat개요
LibreChat의 설정 파일들이 함께 작동하는 방식 및 변경 사항 적용 방법
LibreChat은 네 가지 주요 설정 파일을 사용합니다. 각 파일은 환경 변수부터 사용자 지정 AI endpoint, Docker 서비스 재정의에 이르기까지 애플리케이션의 서로 다른 측면을 제어합니다.
일반적인 변경 워크플로우
대부분의 구성 변경은 동일한 패턴을 따릅니다:
- 비밀 정보, API 키 및 서버 수준 기능 플래그를 설정하려면
.env를 수정하세요. librechat.yaml을 수정하여 사용자 지정 endpoint, Model Specs, 인터페이스 설정, MCP 서버, 에이전트 및 고급 앱 동작을 구성하세요.- Docker의 경우, LibreChat이
librechat.yaml을 읽을 수 있도록 하려면 먼저docker-compose.override.yml을 통해 해당 파일이 마운트되었는지 확인하십시오. - 구성 변경 후에는 항상 LibreChat을 재시작하세요.
- UI에 변경 사항이 나타나지 않으면 API 로그를 확인하세요.
예를 들어, OpenRouter를 활성화하려면 .env에 OPENROUTER_KEY를 추가하고, librechat.yaml에 OpenRouter endpoint를 추가한 다음, Docker가 librechat.yaml을 마운트하도록 설정하고, 재시작한 뒤 endpoint 선택기에서 OpenRouter를 선택하면 됩니다.
구성 파일
.env -- 서버 수준 설정: API 키, 데이터베이스 연결 문자열, 기능 플래그 및 인증 비밀 정보. 이는 대부분의 배포에서 기본 구성 파일입니다. 사용 가능한 모든 변수는 .env 참조를 확인하세요.
librechat.yaml -- 사용자 지정 AI endpoint, 모델 설정, 인터페이스 옵션 및 MCP 서버와 에이전트 같은 고급 기능입니다. 이 파일은 선택 사항이며, 존재하지 않을 경우 LibreChat은 기본값으로 작동합니다. 설정 지침은 librechat.yaml 가이드를 참조하세요.
docker-compose.yml -- Docker 서비스(API 서버, 데이터베이스, 검색)를 정의합니다. 이 파일을 직접 수정하지 마십시오. 업데이트 시 변경 사항이 유지되도록 대신 오버라이드 파일을 사용하십시오.
docker-compose.override.yml -- Docker 서비스에 대한 로컬 사용자 지정 설정입니다: 볼륨 마운트, 포트 매핑, 환경 변수 재정의 등이 포함됩니다. Docker Compose는 이 파일을 메인 파일과 자동으로 병합합니다. Docker override guide를 참조하세요.
변경 사항 적용
재시작 필요
구성 파일을 수정한 후에는 변경 사항을 적용하기 위해 LibreChat을 다시 시작해야 합니다.
docker compose down && docker compose up -d실행 중인 프로세스를 중단하고(Ctrl+C) 다시 시작하세요:
npm run backend다음 단계
이 가이드는 어떤가요?