Tổng quan

Cách các tệp cấu hình của LibreChat hoạt động cùng nhau và cách áp dụng các thay đổi

LibreChat sử dụng bốn tệp cấu hình chính. Mỗi tệp kiểm soát một khía cạnh khác nhau của ứng dụng -- từ các biến môi trường đến các endpoint AI tùy chỉnh cho đến các ghi đè dịch vụ Docker.

Quy trình thay đổi phổ biến

Hầu hết các thay đổi cấu hình đều tuân theo cùng một mô hình:

Chỉnh sửa .env để thiết lập các bí mật, khóa API và các cờ tính năng cấp máy chủ.
Chỉnh sửa librechat.yaml cho các endpoint tùy chỉnh, Model Specs, cài đặt giao diện, máy chủ MCP, tác nhân (agents) và hành vi ứng dụng nâng cao.
Đối với Docker, hãy đảm bảo librechat.yaml được mount thông qua docker-compose.override.yml trước khi mong đợi LibreChat đọc tệp này.
Khởi động lại LibreChat sau mỗi lần thay đổi cấu hình.
Kiểm tra nhật ký API nếu thay đổi không xuất hiện trong UI.

Ví dụ, để kích hoạt OpenRouter, bạn thêm OPENROUTER_KEY vào .env, thêm một endpoint OpenRouter trong librechat.yaml, đảm bảo Docker đã mount librechat.yaml, khởi động lại, sau đó chọn OpenRouter từ bộ chọn endpoint.

Các tệp cấu hình

.env

librechat.yaml

docker-compose.yml

docker-compose.override.yml

.env -- Các cài đặt cấp máy chủ: khóa API, chuỗi kết nối cơ sở dữ liệu, cờ tính năng và các bí mật xác thực. Đây là tệp cấu hình chính cho hầu hết các triển khai. Xem tham chiếu .env để biết tất cả các biến khả dụng.

librechat.yaml -- Các endpoint AI tùy chỉnh, cài đặt mô hình, tùy chọn giao diện và các tính năng nâng cao như máy chủ MCP và tác nhân (agents). Tệp này là tùy chọn -- LibreChat vẫn hoạt động với các cài đặt mặc định nếu tệp không tồn tại. Xem hướng dẫn librechat.yaml để biết hướng dẫn thiết lập.

docker-compose.yml -- Định nghĩa các dịch vụ Docker (máy chủ API, cơ sở dữ liệu, tìm kiếm). Không chỉnh sửa trực tiếp tệp này -- hãy sử dụng tệp ghi đè (override file) để các thay đổi của bạn được giữ nguyên sau khi cập nhật.

docker-compose.override.yml -- Các tùy chỉnh cục bộ của bạn đối với các dịch vụ Docker: gắn ổ đĩa (volume mounts), ánh xạ cổng, ghi đè biến môi trường. Docker Compose sẽ tự động hợp nhất tệp này với tệp chính. Xem hướng dẫn ghi đè Docker.

Áp dụng các thay đổi

Cần khởi động lại

Sau khi chỉnh sửa bất kỳ tệp cấu hình nào, bạn phải khởi động lại LibreChat để các thay đổi có hiệu lực.

docker compose down && docker compose up -d

Dừng tiến trình đang chạy (Ctrl+C) và khởi động lại:

npm run backend

Các bước tiếp theo

Thiết lập librechat.yaml

Tạo và cấu hình tệp cấu hình chính của LibreChat

→

Thiết lập Docker

Cài đặt và chạy LibreChat với Docker

→

Tham chiếu .env

Các biến môi trường cho cấu hình máy chủ

→