{"id":27969827,"url":"https://github.com/cmliu/cf-workers-text2kv","last_synced_at":"2025-05-07T21:54:49.062Z","repository":{"id":226463858,"uuid":"768756079","full_name":"cmliu/CF-Workers-TEXT2KV","owner":"cmliu","description":"这个是一个通过 Cloudflare Workers 搭建，将文本文件存储到 Cloudflare Workers KV 键值存储中，并且可以通过 URL 请求读取或更新这些文本文件。","archived":false,"fork":false,"pushed_at":"2025-02-20T10:03:21.000Z","size":215,"stargazers_count":822,"open_issues_count":7,"forks_count":1467,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-05-07T21:54:45.262Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cmliu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2024-03-07T17:13:14.000Z","updated_at":"2025-05-07T05:46:26.000Z","dependencies_parsed_at":"2024-03-29T16:51:14.074Z","dependency_job_id":null,"html_url":"https://github.com/cmliu/CF-Workers-TEXT2KV","commit_stats":null,"previous_names":["cmliu/cf-workers-text2kv"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmliu%2FCF-Workers-TEXT2KV","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmliu%2FCF-Workers-TEXT2KV/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmliu%2FCF-Workers-TEXT2KV/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmliu%2FCF-Workers-TEXT2KV/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cmliu","download_url":"https://codeload.github.com/cmliu/CF-Workers-TEXT2KV/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252961843,"owners_count":21832193,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-07T21:54:48.421Z","updated_at":"2025-05-07T21:54:49.045Z","avatar_url":"https://github.com/cmliu.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 文本文件储存器 CF-Workers-TEXT2KV\n\nCF-Workers-TEXT2KV 是一个在 Cloudflare Workers 上运行的无服务器应用程序,可以将文本文件存储到 Cloudflare Workers KV 键值存储中,并且可以通过 URL 请求读取或更新这些文本文件。它提供了一个安全的方式来管理和访问您的文本文件,同时利用了 Cloudflare 的全球分布式网络。\n\n## 功能特性\n\n- **文本文件存储**: 您可以将任何文本文件存储到 Cloudflare Workers KV 键值存储中,包括纯文本、JSON、XML 等格式。\n- **通过 URL 读取文件**: 只需通过构造合适的 URL,就可以读取存储在 KV 中的文本文件内容。\n- **通过 URL 更新文件**: 您可以使用 URL 查询参数将新的文本内容上传到 KV,从而实现文件的更新。\n- **Base64 编码支持**: 支持使用 Base64 编码的方式上传和下载文件,以应对某些特殊字符场景。\n- **安全访问控制**: 通过设置 token 参数,可以限制只有拥有正确密钥的请求才能访问您的文件。\n- **辅助工具脚本**: 提供了 Windows 批处理文件和 Linux Shell 脚本,用于方便地从本地上传文件到 KV。\n\n## 使用说明 [部署教程](https://youtu.be/crln7SNrEbQ)\n\n1. **部署到 Cloudflare Workers**\n\n  将项目代码部署到您的 Cloudflare Workers 服务。您需要先在 Cloudflare 上创建一个 Workers 项目,然后将 `worker.js` 文件的内容复制粘贴到 Workers 编辑器中。\n\n2. **创建 KV 命名空间**\n\n  在您的 Cloudflare Workers 项目中,创建一个新的 `KV` 命名空间,用于存储文本文件。记下这个 KV 命名空间的名称,因为您需要将它绑定到 Workers 上。\n\n3. **设置 TOKEN 变量**\n\n  - 为了增加安全性,您需要设置一个 TOKEN 变量,作为访问文件的密钥。在 Cloudflare Workers 的环境变量设置中,添加一个名为 `TOKEN` 的变量,并为其赋予一个安全的值。\n  - 默认 TOKEN 为：`passwd`\n\n4. **访问配置页面**\n\n例如 您的workers项目域名为：`txt.cmliussss.workers.dev` , token值为 `passwd`；\n  - 访问 `https://您的Workers域名/config?token=您的TOKEN` 或 `https://您的Workers域名/您的TOKEN`，您将看到一个配置页面，其中包含了使用说明和下载脚本的链接。\n  - 你的项目配置页则为：\n     ```url\n     https://txt.cmliussss.workers.dev/config?token=passwd\n     或\n     https://txt.cmliussss.workers.dev/passwd\n     ```\n\n5. **使用辅助脚本上传文件**\n\n  - Windows 用户可以下载 `update.bat` 脚本,然后执行 `update.bat 文件名` 来上传本地文件到 KV。\n  - Linux 用户可以下载 `update.sh` 脚本,执行 `./update.sh 文件名` 来上传本地文件。\n  - **注意：因为URL长度限制，如果保存内容过长则只能通过直接编辑`KV`对应文件内容来实现大文件的修改保存。**\n\n6. **通过 URL 访问文件**\n\n例如 您的workers项目域名为：`txt.cmliussss.workers.dev` , token值为 `test` , 需要访问的文件名为 `ip.txt`；\n  - 构造 URL 的格式为 `https://您的Workers域名/文件名?token=您的TOKEN`。您就可以在浏览器中查看该文件的内容了。\n  - 你的访问地址则为： `https://txt.cmliussss.workers.dev/ip.txt?token=test`。\n\n7. **简单的更新文件内容**\n\n  要更新某个文件的内容,可以使用 URL 查询参数 `text` 或 `b64` 来指定新的文本内容或 Base64 编码后的内容。URL 的格式为:\n  ```url\n  https://您的Workers域名/文件名?token=您的TOKEN\u0026text=新文本内容\n  或\n  https://您的Workers域名/文件名?token=您的TOKEN\u0026b64=Base64编码的新文本内容\n  ```\nWorkers 会自动将新内容存储到对应的文件中。\n\n通过这个无服务器应用,您可以方便地在 Cloudflare 的分布式网络上存储和管理文本文件,同时享受高性能和安全可靠的优势。欢迎使用 CF-Workers-TEXT2KV!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmliu%2Fcf-workers-text2kv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcmliu%2Fcf-workers-text2kv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmliu%2Fcf-workers-text2kv/lists"}