CF-Workers-TEXT2KV 是一个在 Cloudflare Workers 上运行的无服务器应用程序,可以将文本文件存储到 Cloudflare Workers KV 键值存储中,并且可以通过 URL 请求读取或更新这些文本文件。它提供了一个安全的方式来管理和访问您的文本文件,同时利用了 Cloudflare 的全球分布式网络。
- 文本文件存储: 您可以将任何文本文件存储到 Cloudflare Workers KV 键值存储中,包括纯文本、JSON、XML 等格式。
- 通过 URL 读取文件: 只需通过构造合适的 URL,就可以读取存储在 KV 中的文本文件内容。
- 通过 URL 更新文件: 您可以使用 URL 查询参数将新的文本内容上传到 KV,从而实现文件的更新。
- Base64 编码支持: 支持使用 Base64 编码的方式上传和下载文件,以应对某些特殊字符场景。
- 安全访问控制: 通过设置 token 参数,可以限制只有拥有正确密钥的请求才能访问您的文件。
- 辅助工具脚本: 提供了 Windows 批处理文件和 Linux Shell 脚本,用于方便地从本地上传文件到 KV。
使用说明 部署教程
- 部署到 Cloudflare Workers
将项目代码部署到您的 Cloudflare Workers 服务。您需要先在 Cloudflare 上创建一个 Workers 项目,然后将 worker.js 文件的内容复制粘贴到 Workers 编辑器中。
- 创建 KV 命名空间
在您的 Cloudflare Workers 项目中,创建一个新的 KV 命名空间,用于存储文本文件。记下这个 KV 命名空间的名称,因为您需要将它绑定到 Workers 上。
- 设置 TOKEN 变量
- 为了增加安全性,您需要设置一个 TOKEN 变量,作为访问文件的密钥。在 Cloudflare Workers 的环境变量设置中,添加一个名为
TOKEN的变量,并为其赋予一个安全的值。 - 默认 TOKEN 为：
passwd
- 访问配置页面
例如 您的workers项目域名为：txt.cmliussss.workers.dev , token值为 passwd；
- 访问
https://您的Workers域名/config?token=您的TOKEN或https://您的Workers域名/您的TOKEN，您将看到一个配置页面，其中包含了使用说明和下载脚本的链接。 - 你的项目配置页则为：
https://txt.cmliussss.workers.dev/config?token=passwd 或 https://txt.cmliussss.workers.dev/passwd
- 使用辅助脚本上传文件
- Windows 用户可以下载
update.bat脚本,然后执行update.bat 文件名来上传本地文件到 KV。 - Linux 用户可以下载
update.sh脚本,执行./update.sh 文件名来上传本地文件。 - 注意：因为URL长度限制，如果保存内容过长则只能通过直接编辑
KV对应文件内容来实现大文件的修改保存。
- 通过 URL 访问文件
例如 您的workers项目域名为：txt.cmliussss.workers.dev , token值为 test , 需要访问的文件名为 ip.txt；
- 构造 URL 的格式为
https://您的Workers域名/文件名?token=您的TOKEN。您就可以在浏览器中查看该文件的内容了。 - 你的访问地址则为：
https://txt.cmliussss.workers.dev/ip.txt?token=test。
- 简单的更新文件内容
要更新某个文件的内容,可以使用 URL 查询参数 text 或 b64 来指定新的文本内容或 Base64 编码后的内容。URL 的格式为:
https://您的Workers域名/文件名?token=您的TOKEN&text=新文本内容
或
https://您的Workers域名/文件名?token=您的TOKEN&b64=Base64编码的新文本内容Workers 会自动将新内容存储到对应的文件中。
通过这个无服务器应用,您可以方便地在 Cloudflare 的分布式网络上存储和管理文本文件,同时享受高性能和安全可靠的优势。欢迎使用 CF-Workers-TEXT2KV!
