Docker

Đối với hầu hết các trường hợp, Docker Compose là phương pháp cài đặt được khuyến nghị nhờ sự đơn giản, dễ sử dụng và độ tin cậy của nó.

Điều kiện tiên quyết

• Git
• Docker

Docker Desktop được khuyến nghị cho hầu hết người dùng. Đối với các cài đặt trên máy chủ từ xa, hãy xem Hướng dẫn triển khai Docker trên Ubuntu.

services:
  mongodb:
    image: mongo:4.4.18

Cài đặt

git clone https://github.com/danny-avila/LibreChat.git
cd LibreChat

cp .env.example .env

docker compose up -d

Gắn librechat.yaml

Để sử dụng tệp cấu hình librechat.yaml tùy chỉnh với Docker, bạn cần mount nó dưới dạng một volume để container có thể truy cập được.

Sao chép tệp ghi đè mẫu và chỉnh sửa nó:

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

Đảm bảo rằng mount volume của librechat.yaml đã được bỏ chú thích trong docker-compose.override.yml:

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

Khởi động lại để các thay đổi có hiệu lực:

docker compose down && docker compose up -d

Để biết hướng dẫn thiết lập đầy đủ bao gồm cả việc tạo tệp từ đầu, hãy xem hướng dẫn librechat.yaml. Để biết thêm các tùy chọn ghi đè, hãy xem hướng dẫn ghi đè Docker.

Cập nhật LibreChat

Các lệnh sau đây sẽ lấy các thay đổi mới nhất của dự án LibreChat, bao gồm mọi thay đổi cần thiết đối với các tệp docker compose, cũng như các image được xây dựng sẵn mới nhất.

docker compose down

# Linux/Mac
docker images -a | grep "librechat" | awk '{print $3}' | xargs docker rmi

# Windows (PowerShell)
docker images -a --filter "reference=registry.librechat.ai/danny-avila/librechat*" --format "{{.ID}}" | ForEach-Object { docker rmi $_ }
docker images -a --filter "reference=ghcr.io/danny-avila/librechat*" --format "{{.ID}}" | ForEach-Object { docker rmi $_ }

git pull

docker compose pull

docker compose up

Khắc phục sự cố

Cổng đã được sử dụng

Nếu bạn thấy lỗi như bind: address already in use cho cổng 3080, thì một ứng dụng khác đang sử dụng cổng đó.

Hoặc dừng ứng dụng đang xung đột, hoặc thay đổi cổng trong docker-compose.override.yml:

services:
  api:
    ports:
      - "3081:3080"

Sau đó hãy truy cập http://localhost:3081 thay thế.

Container bị treo khi khởi động

Nếu các container thoát ngay lập tức sau khi khởi động, hãy kiểm tra nhật ký (logs):

docker compose logs api

Các nguyên nhân phổ biến:

• Cú pháp librechat.yaml không hợp lệ -- hãy xác thực bằng YAML Validator
• Thiếu tệp .env -- hãy đảm bảo .env tồn tại trong thư mục gốc của dự án
• Docker không chạy -- hãy đảm bảo Docker Desktop đã được mở và đang chạy

Các biến môi trường bị thiếu

Nếu các tính năng không hoạt động như mong đợi, hãy kiểm tra xem các biến môi trường bắt buộc đã được thiết lập trong tệp .env của bạn hay chưa.

docker compose exec api env | grep -i "your_variable"

Xem .env reference để biết tất cả các biến khả dụng và giá trị mặc định của chúng.

Các bước tiếp theo