Skip to main content
LibreChat is joining ClickHouse to power the open-source Agentic Data Stack 🎉 Learn more
LibreChat

Cấu trúc đối tượng CloudFront

Đối tượng cloudfront cấu hình việc phân phối qua CloudFront cho các tệp được lưu trữ trong S3. Đối tượng này là bắt buộc khi fileStrategy hoặc bất kỳ mục nào trong fileStrategies sử dụng "cloudfront".

Ví dụ

fileStrategies:
  avatar: 'cloudfront'
  image: 'cloudfront'
  document: 's3'

cloudfront:
  domain: 'https://cdn.example.com'
  distributionId: 'E1234ABCD'
  invalidateOnDelete: false
  imageSigning: 'cookies'
  cookieDomain: '.example.com'
  cookieExpiry: 1800
  urlExpiry: 3600
  storageRegion: 'us-east-2'
  includeRegionInPath: false
  requireSignedAccess: true

Các trường

KeyTypeDescriptionExample
domainStringTên miền phân phối CloudFront hoặc CNAME. Bắt buộc.domain: "https://cdn.example.com"
distributionIdStringID phân phối CloudFront. Bắt buộc khi `invalidateOnDelete` là true.distributionId: "E1234ABCD"
invalidateOnDeleteBooleanTạo một invalidation CloudFront sau khi xóa đối tượng S3. Mặc định: false.invalidateOnDelete: false
imageSigningStringChế độ ký phương tiện nội dòng. Các tùy chọn: `"none"`, `"cookies"`, `"url"`. `"url"` được dành riêng và chưa được triển khai cho hình ảnh.imageSigning: "cookies"
urlExpiryNumberThời hạn tính bằng giây của URL tải xuống CloudFront đã ký. Mặc định: 3600.urlExpiry: 3600
cookieExpiryNumberThời gian tồn tại của cookie đã ký tính bằng giây. Mặc định: 1800. Tối đa: 604800.cookieExpiry: 1800
cookieDomainStringTên miền cha dùng chung cho cookie đã ký. Bắt buộc khi `imageSigning` là `"cookies"`. Phải bắt đầu bằng một dấu chấm.cookieDomain: ".example.com"
storageRegionStringNhãn vùng tùy chọn được sử dụng trong các khóa đối tượng được tạo khi `includeRegionInPath` là true.storageRegion: "us-east-2"
includeRegionInPathBooleanBao gồm vùng lưu trữ trong các khóa đối tượng mới được tạo. Mặc định: false.includeRegionInPath: false
requireSignedAccessBooleanYêu cầu quyền truy cập CloudFront bằng signed-cookie để khởi tạo thành công khi khởi động. Mặc định: false.requireSignedAccess: true

Các quy tắc xác thực

  • distributionId là bắt buộc khi invalidateOnDeletetrue.
  • cookieDomain là bắt buộc khi imageSigning"cookies".
  • cookieDomain phải bắt đầu bằng một dấu chấm, ví dụ: .example.com.
  • requireSignedAccess: true yêu cầu imageSigning: "cookies".
KeyTypeDescriptionExample
CLOUDFRONT_KEY_PAIR_IDStringID cặp khóa công khai CloudFront. Bắt buộc đối với cookie đã ký và tải xuống đã ký.# CLOUDFRONT_KEY_PAIR_ID=K1234567890ABC
CLOUDFRONT_PRIVATE_KEYStringKhóa riêng tư PEM của CloudFront. Bắt buộc đối với cookie đã ký và tải xuống đã ký.# CLOUDFRONT_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----"

Để biết hướng dẫn triển khai, hãy xem CloudFront with S3.

Hướng dẫn này thế nào?