Skip to content

realByg/cfworker-kv-image-hosting

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 

Repository files navigation

🖼️ 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 +

  1. 安装 Cloudflare workers 的 CLI 工具 wrangler 并登录

    npm i @cloudflare/wrangler -g
    wrangler login
  2. 下载或 git clone 仓库到本地并安装所需环境

    git clone https://github.com/realByg/cfworker-kv-image-hosting.git
    cd cfworker-kv-image-hostin/api
    npm i
  3. 配置 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'
  4. 运行 wrangler publish 发布 worker

🥞 问题

  • 免费版 workers 对 CPU 的使用时间、KV 的读取和存储次数均有限制