QQ扫一扫联系
图床这个东西,平常想不起来,需要一个稳定外链的时候才想起没有。
博客的封面图、Markdown 笔记里的截图、电商详情页的素材、客服发给客户的示意图,这些都需要一个能直接打开的地址。存在本地没用,传到公众号里只在那一个平台能看。
图床系统给的是这个:传上去,返回一条能直接用的外链。
/pic_uploader 是一整屏的上传界面:中间一个「上传图片」按钮,选完图之后顶部浮出一张卡片,显示文件名,下面是两种可以直接复制的地址:
两种都给,是因为用途不同。写 Markdown 笔记的复制第一种,粘进编辑器直接就是图;贴到聊天窗口或者后台表单里,用第二种。
拖拽和粘贴也支持。做图床的界面如果只能点按钮选文件,用两次就不想用了。

界面传图是给偶尔用的场景。天天写东西的人,需要的是把图床接进自己的编辑器。
/member/pic_uploader_api 里能拿到一个上传令牌,每个会员一个,可以单独关掉。接口是这样:
POST /pic_uploader/token/{令牌}
Content-Type: application/json 或 multipart/form-data
参数三种形态,任选其一:
| 参数 | 说明 |
|---|---|
filename + content | 文件名 + base64 内容 |
file | 直接传文件字段 |
返回:
{ "code": 0, "msg": "ok", "data": { "fullPath": "https://example.com/data/xxx.jpg" } }
code 为 0 表示成功,拿 fullPath 就是外链。
这个接口挂在无状态中间件下,不需要登录态、不需要 cookie。这一点决定了它能接进哪些工具:Typora、PicGo、VS Code 的图片插件,这些客户端只认一个上传地址加一个 token,不处理 cookie。
配置方式(以 Typora 为例):图像设置里选「上传图片」,上传服务选 Custom Command 或者 PicGo,把接口地址和令牌填进去。之后在 Typora 里截图粘贴,图片自动传到你的图床,文档里写的是外链。
默认是关闭的。配置里第一项「默认不允许使用」,打开之后才会出现一个「允许使用用户ID」的列表,把要开放的用户填进去。
这个默认值是有道理的。图床一旦开放注册,很快就会变成别人的免费图床:有人拿它存商品图、存盗版资源、存违规图片,最后被投诉的是你的域名。
开放的范围按实际情况定:
/member/pic_uploader_manage 是「我的图床」:看自己传过哪些图,删掉不要的,管理上传令牌(重置、开关)。
管理员在后台能看到所有人的图,但一般不在这里删——删了之后用过这张图的地方全变成裂图,而且没有提示。
存储会满。 图片是纯增量,删得少、传得多。上线前想清楚存储放在哪:本地磁盘迟早不够,对象存储加 CDN 是标准答案。
没有自动压缩。 传上去是什么就是什么。手机截图动辄两三兆,一篇笔记插十张图,读者打开要等十几秒。传之前自己压一遍,或者在上传前用工具批量处理。
外链会被引用到别处。 这是图床的本意,但也意味着别人可以拿你的图做自己的内容。重要的图加水印,或者用防盗链。
删除是不可逆的。 删了就是删了,没有回收站。清空之前先确认那些图没被别的地方引用。
依赖 Member 和 Vendor:>=2.0.0。没装会员,就没有「每个用户一个令牌」这层,接口也没法用。
站里已经有对象存储和 CDN 的话,图床的体验会好很多;只有一台服务器加本地磁盘,用它传几十张图没问题,上了几百张就该考虑迁移了。