写公众号要图,本地存一份、公众号传一份、网盘再一份

图床系统 使用文档
图床系统 使用文档

图床这个东西,平常想不起来,需要一个稳定外链的时候才想起没有。

博客的封面图、Markdown 笔记里的截图、电商详情页的素材、客服发给客户的示意图,这些都需要一个能直接打开的地址。存在本地没用,传到公众号里只在那一个平台能看。

图床系统给的是这个:传上去,返回一条能直接用的外链。

上传页很直接

/pic_uploader 是一整屏的上传界面:中间一个「上传图片」按钮,选完图之后顶部浮出一张卡片,显示文件名,下面是两种可以直接复制的地址:

  • Markdown 格式:感叹号方括号里是文件名、圆括号里是图片地址,粘进编辑器直接出图
  • 纯链接:图片地址本身

两种都给,是因为用途不同。写 Markdown 笔记的复制第一种,粘进编辑器直接就是图;贴到聊天窗口或者后台表单里,用第二种。

拖拽和粘贴也支持。做图床的界面如果只能点按钮选文件,用两次就不想用了。

图床上传页:背景是一张办公桌的照片,中间一条灰色卡片显示刚上传的 bg.jpg,卡片里是缩略图和两种格式的地址,下面一个蓝色的「上传图片」按钮

接口上传:真正的用法

界面传图是给偶尔用的场景。天天写东西的人,需要的是把图床接进自己的编辑器。

/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」的列表,把要开放的用户填进去。

这个默认值是有道理的。图床一旦开放注册,很快就会变成别人的免费图床:有人拿它存商品图、存盗版资源、存违规图片,最后被投诉的是你的域名。

开放的范围按实际情况定:

  • 只有自己用:填一个 ID,等于私人图床;
  • 团队用:填几个编辑的 ID;
  • 对外提供服务:这时候要考虑容量、限速、审核,那是另一个量级的事,不是装个模块能解决的。

会员自己的管理页

/member/pic_uploader_manage 是「我的图床」:看自己传过哪些图,删掉不要的,管理上传令牌(重置、开关)。

管理员在后台能看到所有人的图,但一般不在这里删——删了之后用过这张图的地方全变成裂图,而且没有提示。

几个现实问题

存储会满。 图片是纯增量,删得少、传得多。上线前想清楚存储放在哪:本地磁盘迟早不够,对象存储加 CDN 是标准答案。

没有自动压缩。 传上去是什么就是什么。手机截图动辄两三兆,一篇笔记插十张图,读者打开要等十几秒。传之前自己压一遍,或者在上传前用工具批量处理。

外链会被引用到别处。 这是图床的本意,但也意味着别人可以拿你的图做自己的内容。重要的图加水印,或者用防盗链。

删除是不可逆的。 删了就是删了,没有回收站。清空之前先确认那些图没被别的地方引用。

装之前

依赖 Member 和 Vendor:>=2.0.0。没装会员,就没有「每个用户一个令牌」这层,接口也没法用。

站里已经有对象存储和 CDN 的话,图床的体验会好很多;只有一台服务器加本地磁盘,用它传几十张图没问题,上了几百张就该考虑迁移了。

更新: 2026-11-13 18:28:09
QQ
微信
客服