图床总览

一份图床配置就是一个上传目标：一个接口、一套密钥，外加把响应变成链接的规则。你可以同时配好任意多份，随时切换默认，也可以并发地往几个地方传。

这一页讲这些字段是什么意思。每个具体服务另有单独一页，写清楚该填什么值。

该选哪个#

三种引擎#

配置编辑器顶部的上传方式选择器决定请求的形状，下面的字段会跟着变。

multipart/form-data#

就是普通的 HTML 表单提交 —— 文件是其中一个 part，旁边可以带别的字段。几乎所有图床 API 说的都是这套。

multipart 里那个 filename 取的是渲染后对象键的最后一段。多数图床会忽略它，自己另起名字。

二进制 PUT / POST#

文件的字节就是整个请求体，Content-Type 由扩展名推出来。没有表单，所以既没有表单字段也没有文件字段名。

这是给 WebDAV 风格接口和小型自建接收端用的引擎，特点是路径决定名字：

上传地址     https://files.example.com/{{key}}
方法         PUT
JSON path    （留空）
最终链接      https://files.example.com/{{key}}

S3 兼容（AWS SigV4）#

用 AWS 签名 V4 对一次 PUT 做签名。Dropline 一律签 path-style 请求 —— endpoint/bucket/key —— 这正是 R2、MinIO 和自建网关期望的形式，AWS 也仍然接受。

这里没有 JSON path：S3 成功时返回空响应体，所以链接是拼出来的，不是解析出来的。

五种鉴权方式#

适用于 multipart 和二进制引擎。无论选哪种，密钥本身都进钥匙串。

自定义请求头是万能出口。因为值是原样发送的，所以要求 Authorization: Client-ID abc123 的接口，只要把头名设成 Authorization、值设成整串 Client-ID abc123 就行。

管理配置#

• + 从预设新建一份，− 删掉选中的那份。
• 设为默认决定新的上传用哪一份；默认那份在列表里带绿色对勾。
• 测试上传发一张 8×8 的 PNG 走一遍完整流程，把链接或报错摆给你看。每改一次配置都点一下。
• 删掉配置时，它对应的钥匙串条目也一起删掉。

预设一览#