LibreChatCloudFront Objectstructuur
Het cloudfront object configureert CloudFront-levering voor bestanden die in S3 zijn opgeslagen. Het is vereist wanneer fileStrategy of een fileStrategies item "cloudfront" gebruikt.
Voorbeeld
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: trueVelden
| Key | Type | Description | Example |
|---|---|---|---|
| domain | String | CloudFront distributiedomein of CNAME. Vereist. | domain: "https://cdn.example.com" |
| distributionId | String | CloudFront distributie-ID. Vereist wanneer `invalidateOnDelete` true is. | distributionId: "E1234ABCD" |
| invalidateOnDelete | Boolean | Maakt een CloudFront-invalidation aan na het verwijderen van het S3-object. Standaard: false. | invalidateOnDelete: false |
| imageSigning | String | Inline media signing-modus. Opties: `"none"`, `"cookies"`, `"url"`. `"url"` is gereserveerd en niet geïmplementeerd voor afbeeldingen. | imageSigning: "cookies" |
| urlExpiry | Number | Levensduur van de ondertekende CloudFront-download-URL in seconden. Standaard: 3600. | urlExpiry: 3600 |
| cookieExpiry | Number | Levensduur van ondertekende cookie in seconden. Standaard: 1800. Maximum: 604800. | cookieExpiry: 1800 |
| cookieDomain | String | Gedeeld hoofddomein voor ondertekende cookies. Vereist wanneer `imageSigning` op `"cookies"` is ingesteld. Moet beginnen met een punt. | cookieDomain: ".example.com" |
| storageRegion | String | Optioneel regio-label dat wordt gebruikt in gegenereerde object-keys wanneer `includeRegionInPath` true is. | storageRegion: "us-east-2" |
| includeRegionInPath | Boolean | Bevat de opslagregio in nieuw gegenereerde object-keys. Standaard: false. | includeRegionInPath: false |
| requireSignedAccess | Boolean | Vereist signed-cookie CloudFront-toegang om succesvol te initialiseren bij het opstarten. Standaard: false. | requireSignedAccess: true |
Validatieregels
distributionIdis vereist wanneerinvalidateOnDeleteoptrueis ingesteld.cookieDomainis vereist wanneerimageSigning"cookies"is.cookieDomainmoet beginnen met een punt, bijvoorbeeld.example.com.requireSignedAccess: truevereistimageSigning: "cookies".
Gerelateerde omgevingsvariabelen
| Key | Type | Description | Example |
|---|---|---|---|
| CLOUDFRONT_KEY_PAIR_ID | String | CloudFront public key pair ID. Vereist voor ondertekende cookies en ondertekende downloads. | # CLOUDFRONT_KEY_PAIR_ID=K1234567890ABC |
| CLOUDFRONT_PRIVATE_KEY | String | CloudFront private key PEM. Vereist voor ondertekende cookies en ondertekende downloads. | # CLOUDFRONT_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----" |
Voor implementatiebegeleiding, zie CloudFront with S3.
Hoe is deze gids?