Strapi 支持多用户且可以为不同用户设置不同的使用权限

由于 Strapi 通过 JWT 进行用户权限校验，所以需要在 .env 文件中提供 JWT_SECRET 环境变量

可以在终端输入以下命令生成一个密钥

openssl rand -base64 32

然后将生成的字符串添加到 .env 文件中

JWT_SECRET=xxx

本项目在本地开发环境下使用 SQLite 作为数据库，所以在本地的 Strapi 项目的根目录下的 .env 文件中，关于数据库的配置如下

# Local Database
DATABASE_CLIENT=sqlite
DATABASE_FILENAME=.tmp/data.db

而在线上生产环境下使用 Neon 平台所提供的 PostgreSQL 数据库

根据 Neon 官方说明文档创建一个数据库，然后在 Dashboard 可以找到它所提供了 URL 形式的字符用于数据库的连接

然后在（部署了 Strapi 应用） Render 平台添加关于数据库的环境变量

# Online Database
DATABASE_CLIENT=postgres
# Neon 所提供的 URL 形式的字符用于数据库的连接
DATABASE_URL=xxx
DATABASE_SSL=true

根据 Backblaze 官方文档创建一个 Bucket 存储桶，用作存储 goodgoodsmore 项目的多媒体文件

创建完成后可以在页面找到该存储桶的卡片，展示了一些相关信息，可以点击卡片的 Bucket Settings 按钮，在弹出表单对以上的配置进行修改，也可以删除该存储桶。点击 Upload/Download 按钮，可以向存储桶上传文件，或下载存储桶中的文件

此外还需要申请一个 Application Keys 应用程序密钥，以便 Strapi 应用可以连接并操作这个 Bucket

创建成功后会在页面找到该应用程序密钥的卡片，⚠️ 注意其中 applicationKey 密钥只会展示一次（刷新页面后会隐藏）所以要复制保持到本地（需要提供给 Strapi 应用）

同时需要在 Strapi 项目里安装文件上传 upload provider 的相关插件，在终端输入以下命令安装

yarn add @strapi/provider-upload-aws-s3

然后进行相应的配置（具体参考自这一篇帖子和该插件的说明文档）

• 在 Strapi 项目中创建 config/plugins.js 文件，以设置该插件
  config/plugins.js

  js

  module.exports = ({ env }) => ({
      // 对于文件上传功能进行配置
      upload: {
          config: {
              // 所使用的 provider 插件（名称）
              // 记得安装相应的依赖包 @strapi/provider-upload-aws-s3
              provider: 'aws-s3',
              // 对插件进行配置
              providerOptions: {
                  accessKeyId: env('B2_ID'),
                  secretAccessKey: env('B2_KEY'),
                  region: env('B2_REGION'),
                  params: {
                      Bucket: env('B2_BUCKET'),
                  },
                  endpoint: env('B2_ENDPOINT')
              },
          },
      },
  });
  

  说明

  一般在项目中通过环境变量的形式来提供 key 密钥，以便在开发环境和生产环境使用不同的配置

  其中一些环境变量的值需要从 Backblaze 中获取，具体可以查看上一节中所创建的存储桶 Bucket 和应用程序密钥 Application key 的卡片

  • 环境变量 B2_ID 用于设置应用程序密钥的 ID，就是指 Application key 卡片中的 keyID
  • 环境变量 B2_KEY 用于设置应用程序密钥，就是在创建完成后仅显示一次的 applicationKey
  • 环境变量 B2_REGION 用于设置存储桶所使用的服务器所在的地区，可以从 Bucket 卡片中的 Endpoint 存储服务器终端地址中获取，它是在 s3 后面的那一串字符，形式如 us-west-004
  • 环境变量 B2_BUCKET 用于设置存储桶的名称，就是指 Bucket 卡片中的名称
  • 环境变量 B2_ENDPOINT 用于设置存储桶的（终端）地址，就是指 Bucket 卡片中的 Endpoint

  注意

  由于新版的 Strapi upload provider 将依赖包 AWS SDK 从 V2 版本升级到 V3 版本，所以 B2_ENDPOINT 的格式需要作出相应的变更，要在 Backblaze 存储桶 Bucket 卡片的 Endpoint 值前面加上 https:// 协议前缀

  更多介绍参考相关文档：

  • AWS S3 compatible services upload fail on compatible storage (Linode Object Storage) - Github issue
  • Security Middleware Configuration
  • S3-Compatible API
• 更改 config/middlewares.js 文件中关于内容安全政策中间件的设置，以便在 Strapi 的 Media Library 媒体库中查看到媒体文件（图片）的缩略图，使用以下对象替代原有的 'strapi::security' 元素
  config/middlewares.js

  js

  module.exports = [
      // ...
      {
          name: 'strapi::security',
          config: {
              contentSecurityPolicy: {
                  useDefaults: true,
                  directives: {
                      'connect-src': ["'self'", 'https:'],
                      'img-src': [
                          "'self'",
                          'data:',
                          'blob:',
                          'market-assets.strapi.io',
                          // 根据 Backblaze 的相关信息来设置
                          // yourBucketName 是指存储桶 Bucket 的名称
                          // 后面的部分和环境变量 B2_ENDPOINT 的值一致
                          'yourBucketName.s3.yourRegion.backblazeb2.com',
                      ],
                      'media-src': [
                          "'self'",
                          'data:',
                          'blob:',
                          'market-assets.strapi.io',
                          // 根据 Backblaze 的相关信息来设置
                          // yourBucketName 是指存储桶 Bucket 的名称
                          // 后面的部分和环境变量 B2_ENDPOINT 的值一致
                          'yourBucketName.s3.yourRegion.backblazeb2.com',
                      ],
                      upgradeInsecureRequests: null,
                  },
              },
          },
      },
      // ...
  ];
  

通过在 CLoudflare 的设置可以实现缓存，并修改前端图片的 URL 格式

设置 URL 规则

参考

• Delivering Content From a Public Backblaze B2 Bucket via Cloudflare CDN（公有存储桶）
• Free Image Hosting With Cloudflare Transform Rules and Backblaze B2（旧教程）
• 使用 Backblaze B2 和 Cloudflare Workers 搭建免费的自定义域名图床
• Delivering Private Backblaze B2 Content Through Cloudflare CDN（私有存储桶）

Backblaze 的免费套餐提供了 10GB 的存储容量，以及一些 API 调用额度

其中 Transactions Class B 的 API 调用（即调用该 API 会触发数据库执行 B 类型事务）免费额度是每天 2500 次，其中包括文件下载操作，且免费额度限制在每天 1GB 的下载流量，当网站的流量较大时，用户在前端浏览/加载图片时会下载图片文件，这个免费额度可能不够

可以利用 Cloudflare 所提供利用 CDN 缓存来解决这个流量限制问题

首先需要查看托管在 Backblaze 平台的图片的原始 URL，可以点开 Bucket 存储桶里的任何一个文件，查看它的相关信息

存储在 Backblaze（公开类型的存储桶 public bucket）的文件会有 3 种类型的 URL：

• Friendly URL 友好、易读的链接
• S3 URL 包含兼容性 S3 信息的链接
• Native URL 包含 B2 原生 API 信息的链接

以上 3 种类型的 URL 都可以访问到同一个文件，更推荐使用 Friendly URL，它更简短易记

说明

通过观察可以发现 Friendly URL 的命名规则是 https://f00<x>.backblazeb2.com/file/<bucket_name>/<img_name>

• f00<x>.backblazeb2.com 是域名 hostname，其中 <x> 是数字
• <bucket_name> 是该文件所在的存储桶
• <img_name> 是文件的名称

注意

以上 3 种链接在浏览器直接打开都可以加载展示相应图片

但是如果需要在其他域名下通过代理/映射的方式进行访问，则有所不同

S3 URL 并不能以其他域名（并且仅通过代理）获取图片，需要在请求中签名（在请求头配置 Backblaze 应用程序密钥）才可以跨域访问，这和 AWS S3 的协议相关

而 Friendly URL 和 Native URL 则能够以其他域名（且仅通过代理）获取到图片

虽然可以直接在前端采用上述的链接来获取图片，但是这会暴露了 Backblaze 相关信息（例如存储桶）

为了避免这种情况，可以在前端使用特定规则来的 URL（例如只包含图片的名称）来代替原有的图片链接，然后利用 Cloudflare 代理功能，当前端向服务器发送请求图片时，将相应的请求链接转向/修改为对应的图片原始 URL

• 首先进行域名的代理/映射
  通过观察可以知道在同一个存储桶 Bucket 种的图片的 Friendly URL 都有相同的域名 hostname，其形式是 f00<x>.backblazeb2.com 是域名 hostname（其中 <x> 是数字），这个域名可以通过 Cloudflare 代理，这样在前端使用其他的域名来替代
  可以一个子域名，例如 assets.goodgoodsmore（该项目的前端网站域名是 goodgoodsmore.com），专门用来表示要获取多媒体文件
  在 Cloudflare 的 DNS 中添加一条相应的 CNAME 配置
  

  

  注意

  由于 Cloudflare 默认通过 HTTP 访问目标服务器，所以开启代理后可能会造成网站无法访问，这时需要将 SSL/TLS 加密模式设置为「完全（严格）」，这样就可以通过 HTTPS 与目标服务器连接

  

  如果不将其设置为「完全（严格）」模式，则浏览网页时会出现「重定向次数过多」的错误

  
  那么当前端通过链接获取图片时，如 https://assets.goodgoodsmore/file/<bucket_name>/img.png，经过 Cloudflare 的（子）域名代理，实际访问的是 https://f00<x>.backblazeb2.com/file/<bucket_name>/img.png
• 然后对链接的规则进行转变
  前面通过设置 Cloudflare 的 DNS 规则可以实现域名的代理，但是替换的图片链接后半部分依然要和 Friendly URL 后半部分一致才行。而 URL 后半部分正是包含存储桶名称的敏感信息，所以最好将后半部分的 URL 也替换掉
  可以通过 Cloudflare Transform Rules 转换规则进行处理，使用其中的 Rewrite URL 重写链接功能，对于从前端发出来的请求的 URL（例如只包含上述域名和图片文件）进行改写，将其重写（补充一些固定的路径）为符合 Friendly URL 规则，再向目标服务器发送
  说明

  请求流量到达源服务器之前会经过 Cloudflare 一系列处理，其顺序如下

  

  其中 URL 重写位于较前的步骤

  
  以下图示是具体的配置操作
  

  

通过以上在 Cloudflare 的配置，可以在前端使用 https://assets.goodgoodsmore.com/img.png 的形式加载保存在 Backblaze 的图片，其原链接形式是 https://f00<x>.backblazeb2.com/file/<bucket_name>/img.png

设置页面缓存

对于变更不频繁的内容，可以通过设置 Cloudflare 的 Page Rule 页面规则来优化缓存等级

而多媒体资源（如图片）一般是不会变的，所以可以对于这一类的 URL 设置较高的缓存等级

而对于整个网站则可以设置较短的缓存

注意

Cloudflare 的免费用户可以为一个域名设置 3 个页面规则，由于页面（URL）匹配是有顺序的（从上到下），且每个 URL 仅触发一个页面规则，所以整个网站的页面缓存规则应该放到最下面，而专门针对（多媒体文件相关）子域名的页面规则则应该先设置

迁移提示

Cloudflare 「规则 -> 页面规则」配置已经被弃用，需要使用「缓存 -> Cache Rules」进行缓存配置