cfworker-kv-image-hosting's Introduction

🖼️ cfworker-kv-image-hosting

Cloudflare workers KV 图床

📚 原理

Cloudflare workers KV 支持使用 ReadableStream 格式存储数据，使用 FormData 将文件传输到 workers 后，调用 Blob.stream() 方法，并将与文件相关的属性如名称、大小等存入 metadata，将过期信息存入 expiration。

await KV_NAMESPACE.put(key, item.stream(), {
	expiration,
	metadata: {
		name: item.name,
		uploadedAt: new Date().getTime(),
		size: item.size
	}
})

为什么不要使用 Base64？

将图片转换为 Base64 格式的 dataURL 之后，不仅体积会变大，每次获取图片时还需要先转换成 Blob 后再返回，并且在 KV 支持的 3 种存储格式中，ReadableStream 读取最快，text/json 最慢。

🏃 部署

环境：Nodejs 14 +

安装 Cloudflare workers 的 CLI 工具 wrangler 并登录
```
npm i @cloudflare/wrangler -g
wrangler login
```

下载或 git clone 仓库到本地并安装所需环境

git clone https://github.com/realByg/cfworker-kv-image-hosting.git
cd cfworker-kv-image-hostin/api
npm i

配置 wrangler.toml 文件，粘贴后修改下方带 # 部分：

name = '' # subdomain.workers.dev 前缀
workers_dev = true
type = 'webpack'
webpack_config = 'webpack.config.js'
compatibility_date = '2021-12-14'

[vars]
ENV = 'prod'
USERNAME = '' # 用户名
PASSWORD = '' # 密码
TTL = 3600 # cacheTtl 缓存时间 (>60)
DEDUPE = false # 是否开启去重。开启则会使用文件的 arraybuffer 产生唯一 md5 并取前 8 位作为 id 覆盖原来的内容，会增加 CPU 消耗；不开启则会使用随机 8 位字符作为 id

[[kv_namespaces]]
binding = 'ImageKV'
id = '' # 在 workers KV 页面创建 KV 后将 id 填入此

[site]
bucket = '../app/dist'
entry-point = 'workers-site'