Przegląd

LibreChat używa czterech głównych plików konfiguracyjnych. Każdy z nich kontroluje inny aspekt aplikacji -- od zmiennych środowiskowych, przez niestandardowe endpoint AI, aż po nadpisania usług Docker.

Typowy przepływ pracy przy zmianach

Większość zmian w konfiguracji przebiega według tego samego schematu:

Edytuj .env, aby skonfigurować sekrety, klucze API oraz flagi funkcji na poziomie serwera.
Edytuj librechat.yaml, aby skonfigurować niestandardowe endpoint, Model Specs, ustawienia interfejsu, serwery MCP, agentów oraz zaawansowane zachowanie aplikacji.
W przypadku Docker, upewnij się, że librechat.yaml jest zamontowany poprzez docker-compose.override.yml, zanim oczekujesz, że LibreChat go odczyta.
Po każdej zmianie konfiguracji zrestartuj LibreChat.
Sprawdź logi API, jeśli zmiana nie pojawia się w interfejsie użytkownika.

Na przykład, aby włączyć OpenRouter, dodaj OPENROUTER_KEY do pliku .env, dodaj endpoint OpenRouter w librechat.yaml, upewnij się, że Docker montuje librechat.yaml, zrestartuj aplikację, a następnie wybierz OpenRouter z selektora endpointów.

Pliki konfiguracyjne

.env

librechat.yaml

docker-compose.yml

docker-compose.override.yml

.env -- Ustawienia na poziomie serwera: klucze API, ciągi połączeń z bazą danych, flagi funkcji oraz sekrety uwierzytelniania. Jest to główny plik konfiguracyjny dla większości wdrożeń. Zobacz dokumentację .env, aby uzyskać listę wszystkich dostępnych zmiennych.

librechat.yaml -- Niestandardowe endpointy AI, ustawienia modeli, opcje interfejsu oraz zaawansowane funkcje, takie jak serwery MCP i agenci. Ten plik jest opcjonalny -- LibreChat działa z ustawieniami domyślnymi, jeśli plik nie istnieje. Zobacz przewodnik po librechat.yaml, aby uzyskać instrukcje konfiguracji.

docker-compose.yml -- Definiuje usługi Docker (serwer API, bazę danych, wyszukiwarkę). Nie edytuj tego pliku bezpośrednio -- użyj zamiast tego pliku override, aby Twoje zmiany przetrwały aktualizacje.

docker-compose.override.yml -- Twoje lokalne dostosowania usług Docker: montowanie wolumenów, mapowanie portów, nadpisywanie zmiennych środowiskowych. Docker Compose automatycznie łączy ten plik z plikiem głównym. Zobacz przewodnik po nadpisywaniu Docker.

Wprowadzanie zmian

Wymagany restart

Po edycji dowolnego pliku konfiguracyjnego musisz zrestartować LibreChat, aby zmiany weszły w życie.

docker compose down && docker compose up -d

Zatrzymaj uruchomiony proces (Ctrl+C) i uruchom ponownie:

npm run backend

Następne kroki

Konfiguracja librechat.yaml

Utwórz i skonfiguruj główny plik konfiguracyjny LibreChat

→

Konfiguracja Docker

Zainstaluj i uruchom LibreChat za pomocą Docker

→

Dokumentacja .env

Zmienne środowiskowe dla konfiguracji serwera

→