用途:把本地文件上传到私有 Cloudflare R2 存储,输出一个会自动过期的公开直链,适合托管截图、录屏、GIF 等临时文件,可替代 catbox.moe。
主要能力:默认 90 天过期;链接带正确 Content-Type,图片和 GIF 可内联渲染;正常用量在 R2 免费额度内(存储 10 GB、出网不限、每月 100 万次写和 1000 万次读)。
用法:share-file <file> [--expire 7d|30d|90d|365d|keep] [--name <slug>],仅把公开 URL 输出到 stdout,可安全捕获为 URL="$(share-file ./screenshot.png)"。示例:share-file ./screenshot.png;share-file ./demo.gif --expire 30d;share-file ./architecture.pdf --expire keep;share-file ./out.gif --name login-flow。临时链接选更短窗口,除非用户要求永久链接否则不要用 keep。放进 PR 或 Markdown 时可返回可粘贴片段,如 。注意 GitHub PR 只内联渲染 GIF、PNG、JPEG,MP4 会退化为普通链接,如需内联视频可先转 GIF。
过期机制:R2 生命周期规则按前缀而非单对象生效,脚本把上传按 TTL 命名的前缀(如 90d/2026-07/name-abc123.png)路由,前缀即过期,删除在截止后约 24 小时内发生;不要把对象移到别的前缀来改变时钟。
安装:先 npm install -g wrangler && wrangler login,再执行 share-file setup;setup 会创建 bucket、添加四条生命周期规则并启用公开访问,幂等,可用 --bucket <name> 指定其他名称。Cloudflare 账户需先启用 R2 并绑定支付方式。公开主机在运行时从 bucket 发现并缓存到 ~/.cache/share-file/,可用 R2_PUBLIC_BASE 和 R2_BUCKET 覆盖。默认使用 r2.dev 子域(限速、无缓存、仅开发用);自定义域名须属于同一账户,可执行 wrangler r2 bucket domain add storage --domain files.example.com 并设置 R2_PUBLIC_BASE,已有对象键不受影响。
限制:未认证时需 wrangler login;上传后立即 404 可能是自定义域名未挂载或 DNS 未生效;浏览器下载而非渲染通常是 Content-Type 有误。