#Moteur de stockage : Aliyun OSS

Un moteur de stockage basé sur Aliyun OSS. Avant de l'utiliser, vous devez préparer les comptes et les autorisations nécessaires.

#Paramètres de configuration

#URL de base

Saisissez le préfixe de l'URL d'accès aux fichiers, comme un domaine personnalisé associé au bucket actuel : https://oss.example.com. Le domaine par défaut d'Aliyun OSS peut amener le navigateur à télécharger les PDF. Nous recommandons d'associer d'abord un domaine personnalisé. Consultez les Problèmes courants ci-dessous.

#Région

Saisissez la région de stockage OSS, par exemple : oss-cn-hangzhou.

#AccessKey ID

Saisissez l'ID de votre clé d'accès Aliyun.

#AccessKey Secret

Saisissez le Secret de votre clé d'accès Aliyun.

#Bucket

Saisissez le nom du bucket OSS.

#Délai d'expiration

Saisissez le délai d'expiration pour le téléversement vers Aliyun OSS, en millisecondes. La valeur par défaut est de 60000 millisecondes (soit 60 secondes).

#Problèmes courants

#Le PDF est téléchargé au lieu d'être prévisualisé

NocoBase prévisualise les PDF d'une autre origine dans un iframe. Le navigateur accède directement à l'URL OSS. Les en-têtes de réponse déterminent donc si le fichier est affiché ou téléchargé.

Si le PDF est téléchargé depuis l'iframe, vérifiez la requête dans le panneau « Réseau » des outils de développement. Une réponse problématique typique ressemble à ceci :

Content-Type: application/pdf
Content-Disposition: attachment
x-oss-force-download: true

Content-Type: application/pdf identifie correctement le fichier, mais Content-Disposition: attachment demande au navigateur de le télécharger. Le domaine par défaut d'Aliyun OSS force le téléchargement dans certains cas. Consultez la documentation officielle : Configurer un PDF pour l'afficher au lieu de le télécharger.

Nous recommandons la configuration suivante :

1. Suivez Accéder aux ressources OSS avec un domaine personnalisé pour associer un domaine au bucket
2. Configurez le DNS et le certificat HTTPS, puis vérifiez que le domaine accède directement au fichier
3. Configurez l'URL d'accès du moteur de stockage utilisé par NocoBase

Pour l'étape 3 :

• Avec le moteur intégré Aliyun OSS, définissez URL de base sur le domaine associé, par exemple https://oss.example.com
• Avec S3 Pro connecté à Aliyun OSS, l'endpoint d'envoi peut continuer à utiliser l'endpoint régional OSS ; définissez l'endpoint d'accès sur le domaine personnalisé et Full access URL style sur Ignore

Envoyez un nouveau PDF pour vérifier la configuration. Si un enregistrement existant stocke une URL complète, vérifiez aussi que l'URL renvoyée au frontend utilise maintenant le domaine personnalisé.

#L'image s'affiche, mais le bouton de téléchargement signale une erreur CORS

Les images sont généralement affichées avec <img> et les PDF inter-origines avec un iframe. Les deux peuvent afficher des ressources sans en-têtes CORS. Toutefois, le bouton de téléchargement lit le fichier avec fetch et crée un Blob. Cette requête est soumise à la politique de même origine du navigateur.

L'erreur suivante indique qu'OSS n'a pas renvoyé Access-Control-Allow-Origin pour le site NocoBase actuel :

Access to fetch at 'https://oss.example.com/path/to/file.jpg' from origin
'https://example.com' has been blocked by CORS policy:
No 'Access-Control-Allow-Origin' header is present on the requested resource.

Suivez le guide officiel Configurer CORS et créez une règle pour le bucket. Pour les téléchargements depuis le composant d'aperçu, utilisez des valeurs comme celles-ci :

Si S3 Pro envoie aussi des fichiers directement depuis le navigateur, ajoutez des méthodes comme PUT et POST selon les requêtes réelles du panneau « Réseau », ou créez une règle d'envoi séparée.

Après avoir enregistré la règle, demandez à nouveau le fichier avec l'origin du site NocoBase. La réponse doit au moins contenir :

Access-Control-Allow-Origin: https://example.com
Access-Control-Allow-Methods: GET, HEAD

Le navigateur a peut-être déjà mis en cache la réponse utilisée pour afficher l'image. Cette requête ne contenait pas d'en-tête Origin, et la réponse en cache peut ne pas contenir Access-Control-Allow-Origin. Si le téléchargement échoue encore après la configuration de CORS, videz le cache du fichier ou activez « Désactiver le cache » dans les outils de développement, puis réessayez.

#Vérifier les en-têtes de réponse

Utilisez curl pour simuler une requête inter-origines depuis le site NocoBase. Remplacez l'origin, l'URL et les paramètres de signature de l'exemple par les valeurs réelles :

curl -sS -D - -o /dev/null \
  -H 'Origin: https://example.com' \
  'https://oss.example.com/path/to/file.pdf?<signed-query>'

Vérifiez les résultats suivants :

• L'aperçu PDF renvoie Content-Type: application/pdf sans Content-Disposition: attachment
• Le téléchargement inter-origines renvoie un Access-Control-Allow-Origin correspondant au site NocoBase
• L'URL réelle utilise le domaine personnalisé au lieu du domaine par défaut *.oss-cn-*.aliyuncs.com

Il est normal qu'une requête sans en-tête Origin ne reçoive pas d'en-têtes CORS. Conservez l'en-tête Origin de l'exemple pendant la vérification.

#Liens associés

• Aperçu des fichiers
• S3 Pro
• Migrer vers S3 Pro
• Moteurs de stockage