在 BookStack 上使用 Cloudflare R2
問題概述
官方教學其實已經有說明,這裡補足目前 (2024/01/24) 官方教學略為不足的部分。
一樣是編輯 .env 檔案,並且加入以下內容:
STORAGE_TYPE=s3
STORAGE_S3_KEY=<access_key>
STORAGE_S3_SECRET=<access_secret_key>
STORAGE_S3_REGION=auto
STORAGE_S3_BUCKET=<bucket_name>
STORAGE_S3_ENDPOINT=<endpoint_url>
STORAGE_URL=<url>
STORAGE_S3_KEY、STORAGE_S3_SECRET、STORAGE_S3_BUCKET 和 STORAGE_S3_ENDPOINT 基本上跟官方教學差不多。
需要增加的是 STORAGE_S3_REGION ,而且必須是 auto ,否則 Log 會噴 400 Bad Request 的錯誤。
這個資訊我還是在官方 Git repository 的 Issues 上才發現的。不過我以為 BookStack 預設應該會是 auto,原來不是嗎......。
參考
- Configuring File Uploads · BookStack
- Minio Implementation for Amazon S3 · Issue #1195 · BookStackApp/BookStack