📚 离职知识库

litterbox 临时文件托管 API

它是干什么的：把本地文件上传到公网，拿到一条任何人都能在浏览器打开的临时链接，到点自动删除。完全免费、无需账号、无需 key。用于「给个文件 → 拿个网址 → 用完自动没」的临时分享场景。

  • 提供方：catbox.moe 家的临时版（litterbox），老牌匿名文件托管。
  • 用在哪：本地大文件秒发的 skill、FileBeam 站及其本地版。

#接口

项目 值
上传地址 https://litterbox.catbox.moe/resources/internals/api.php
方法 POST，multipart/form-data
认证 无（匿名，不需要 key/token/账号）
单文件上限 约 1GB
过期时长 只支持 1h / 12h / 24h / 72h 四档，到点自动删，不可续期
返回 成功直接返回一行 URL（https://litter.catbox.moe/xxxx.ext）；失败返回错误文本

#三个必填表单字段

  • reqtype = fileupload
  • time = 1h | 12h | 24h | 72h
  • fileToUpload = 文件本体（@文件路径）

#curl 示例

curl -F "reqtype=fileupload" \
     -F "time=24h" \
     -F "fileToUpload=@/path/to/文件.pdf" \
     https://litterbox.catbox.moe/resources/internals/api.php
# → https://litter.catbox.moe/ab12cd.pdf

#关键特性 / 踩过的坑

  • content-type 正确：实测对 .html 返回 text/html，所以 HTML 会被浏览器直接渲染成网页（不是当文本下载）；PDF 原生阅读器打开；这点比 0x0.st / transfer.sh 强（那俩把 html 强制成 text/plain，不渲染）。
  • Office 文件（docx/pptx/xlsx）浏览器不能原生看，要包一层在线预览器： https://view.officeapps.live.com/op/view.aspx?src=<对上面URL做URL编码>（微软官方，免费）；或谷歌 https://docs.google.com/viewer?embedded=true&url=<编码URL>。
  • 无删除接口：匿名临时文件不能手动删，只能等到点自动删。要「可手动删除 + 永久」得用它的正式版 catbox（https://catbox.moe/user/api.php，需要一个免费 userhash，reqtype=deletefiles 删）。
  • 公开可访问：任何拿到链接的人都能看，没有密码保护。私密内容要么先 AES 加密再传（FileBeam 的密码门就是干这个），要么改用 catbox + 自己加密。
  • 有内容审核：别传违规内容；别当长期图床（到点必删）。
  • 代理环境下 Python httpx 需要 httpx[socks] 才能走系统 SOCKS 代理；curl 则自动走。

来源：配置信息/litterbox临时托管API.md（整理于 2026-08-18）

相关笔记