LibreChatStruttura degli oggetti CloudFront
L'oggetto cloudfront configura la distribuzione CloudFront per i file archiviati in S3. È richiesto quando fileStrategy o una qualsiasi voce di fileStrategies utilizza "cloudfront".
Esempio
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: trueCampi
| Key | Type | Description | Example |
|---|---|---|---|
| domain | String | Dominio della distribuzione CloudFront o CNAME. Obbligatorio. | domain: "https://cdn.example.com" |
| distributionId | String | ID della distribuzione CloudFront. Obbligatorio quando `invalidateOnDelete` è true. | distributionId: "E1234ABCD" |
| invalidateOnDelete | Boolean | Crea un'invalidazione CloudFront dopo l'eliminazione dell'oggetto S3. Predefinito: false. | invalidateOnDelete: false |
| imageSigning | String | Modalità di firma dei media inline. Opzioni: `"none"`, `"cookies"`, `"url"`. `"url"` è riservato e non implementato per le immagini. | imageSigning: "cookies" |
| urlExpiry | Number | Durata in secondi dell'URL di download firmato di CloudFront. Predefinito: 3600. | urlExpiry: 3600 |
| cookieExpiry | Number | Durata del cookie firmato in secondi. Predefinito: 1800. Massimo: 604800. | cookieExpiry: 1800 |
| cookieDomain | String | Dominio padre condiviso per i cookie firmati. Obbligatorio quando `imageSigning` è `"cookies"`. Deve iniziare con un punto. | cookieDomain: ".example.com" |
| storageRegion | String | Etichetta di regione opzionale utilizzata nelle chiavi degli oggetti generati quando `includeRegionInPath` è true. | storageRegion: "us-east-2" |
| includeRegionInPath | Boolean | Include la regione di archiviazione nelle chiavi degli oggetti appena generati. Predefinito: false. | includeRegionInPath: false |
| requireSignedAccess | Boolean | Richiede l'accesso CloudFront tramite cookie firmato per inizializzarsi correttamente all'avvio. Predefinito: false. | requireSignedAccess: true |
Regole di validazione
distributionIdè richiesto quandoinvalidateOnDeleteètrue.cookieDomainè richiesto quandoimageSigningè"cookies".cookieDomaindeve iniziare con un punto, per esempio.example.com.requireSignedAccess: truerichiedeimageSigning: "cookies".
Variabili d'ambiente correlate
| Key | Type | Description | Example |
|---|---|---|---|
| CLOUDFRONT_KEY_PAIR_ID | String | ID della coppia di chiavi pubblica CloudFront. Obbligatorio per cookie firmati e download firmati. | # CLOUDFRONT_KEY_PAIR_ID=K1234567890ABC |
| CLOUDFRONT_PRIVATE_KEY | String | Chiave privata PEM di CloudFront. Richiesta per cookie firmati e download firmati. | # CLOUDFRONT_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----" |
Per indicazioni sulla distribuzione, consulta CloudFront with S3.
Com’è questa guida?