Skip to content

About

Cloudflare Workers - Mutsumi Proxy

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

51 Commits

Folders and files

Repository files navigation

mutsumi-proxy

基于 Cloudflare Workers 的多功能代理与工具服务。

功能

通用 CORS 代理

通过 /cors/<target-url> 转发请求并补全 CORS 响应头,支持预检(OPTIONS)请求。

DDNS 动态 DNS

GET/POST /ddns/update/<subdomain> — 更新 Cloudflare DNS 记录:

  • Bearer Token 认证,支持按 Token 粒度的子域名权限控制
  • 自动从请求头解析客户端 IP(支持 ?ip= 显式指定)
  • IP 未变时自动跳过更新,减少 API 调用
  • 支持 Cloudflare KV 持久化 IP 状态(可选)
  • 按子域名互斥锁,避免并发更新冲突

Pastebin 文本分享

通过 KV 存储文本,支持自定义或随机 slug,可选的读取口令由管理员在创建时设置。

路径 说明
/pastebin 取回主界面:输入 slug 与可选口令
/pastebin/admin 管理界面:登录后可创建、覆盖、查看列表、删除
/p/<slug> 分享链接,有口令时显示口令表单
/p/<slug>?raw=1 返回 text/plain
  • 管理与写入共用一条 secret:PASTEBIN_ADMIN_PASSWORD
  • 管理员会话使用 HMAC 签名的 HttpOnly Cookie,有效期 7 天
  • 条目存于 KV 的 paste:<slug>,列表直接读取 KV metadata,不读取正文
  • 注意:KV 是最终一致的,创建/删除后管理列表最长可能有约 60 秒延迟

经典 IE 错误页

/shdoclc/{code} 返回从旧版 Windows shdoclc.dll 提取的 Internet Explorer 错误页(图标已 base64 内嵌),并附带对应的真实 HTTP 状态码。

  • /shdoclc/ 为索引页(HTML,各子路径可点击)
  • 专属页面:400 / 403 / 404 / 406 / 408 / 409 / 410 / 500 / 501
  • 其余 4xx/5xx 落到通用错误页;别名:dns(502)、syntax(400)、servbusy(408)、gen(500)
  • /shdoclc/search — 复古搜索页(1998 风格 UI,结果来自 Wiby,Worker /shdoclc/search/api 代理)
  • 全站未匹配路径的 404 也返回此 IE 404 页
  • 页面存于 assets/shdoclc/(单一来源,图标已 base64 内嵌,经 Workers Static Assets 的 ASSETS binding 取用;小写连字符命名,注意勿用裸 404.html—— 它是 wrangler 的保留名)

工具端点

路径 说明
/ 首页图片
/echo 返回请求调试信息(IP、Headers、Cloudflare Geo)
/uuid?n=<count> 生成 UUID(最多 100 个,纯文本每行一个)
/status/<code> 返回指定 HTTP 状态码
/generate_204 返回 204 No Content
/dummy 返回 200 空响应
/teapot 返回 418 I'm a teapot
/shdoclc/{code} 经典 IE 错误页(附真实状态码)

部署

  1. 复制 wrangler.toml.example 为 wrangler.toml 并填入配置
  2. 设置 secret:npx wrangler secret put CF_API_TOKEN(DDNS 需要)
  3. 设置 DDNS 配置:npx wrangler secret put DDNS_CONFIG
  4. 设置 Pastebin 管理员口令:npx wrangler secret put PASTEBIN_ADMIN_PASSWORD
  5. 创建 KV 命名空间(DDNS IP 缓存 + Pastebin 存储共用): npx wrangler kv namespace create RiNG,把 id 填入 wrangler.toml
  6. 部署:npx wrangler deploy

代码不硬编码 KV binding 名:设置了 KV_BINDING 时按该名字查找,否则自动探测 env 中唯一的 KV 绑定。只有一个 KV 时无需额外配置。

使用示例

# DDNS 更新
curl -H "Authorization: Bearer <token>" \
  "https://<workers.domain>/ddns/update/my-subdomain"

# 读取无口令的 memo
curl "https://<workers.domain>/p/<slug>?raw=1"

# 读取有口令的 memo
curl -X POST -d "password=<paste-password>" \
  "https://<workers.domain>/p/<slug>?raw=1"

About

Cloudflare Workers - Mutsumi Proxy

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages