TinyImgUploader 2.0.0 — Typecho 1.3 图床上传插件
TinyImgUploader 2.0.0 — Typecho 1.3 图床上传插件
在 Typecho 撰写文章 / 页面右侧「选项」栏增加一个图片上传窗口:点击按钮 → 弹窗选图并预览 → 确认上传 → 图片上传到自建 TinyImg 2.0 图床 → Markdown 自动插入编辑框光标处。
插件设置页里可以填 API Token,并有 「测试连接」按钮 一键验证图床是否认这个 Token。
1. 本次变更
| # | 变更 |
| - | --------------------------------------------------------------------------------------- |
| 1 | 插件目录、命名空间、Action 名统一改为 TinyImgUploader / tinyimg-uploader |
| 2 | 请求头改为 X-TinyImg-Token,配合图床 2.0 的后台 Token 设置页 |
| 3 | 设置页 Token 字段新增「测试连接」按钮,读取输入框当前值(无需先保存),返回图床版本与管理员目录 |
| 4 | 图床 ?ping=1 自检端点由插件的服务端 Action 调用,不受跨域限制、不把凭证下发给浏览器 |
| 5 | 默认值改为占位地址 https://img.example.com/functions/upload.php,侧栏会在未修改时给出红色提示 |
| 6 | 去掉旧的图床补丁包(patch/ 目录):Token 现在是图床原生功能 |
| 7 | 管理员 Cookie 回退方案的盐同步改为 tinyimg;新增 tests/host_test.php、tests/setting_test.php 等六组测试 |
2. 从 v1.2 升级(需要重装一次,请先看这节)
插件目录名变了,Typecho 靠目录名识别插件,不能只覆盖文件。
⚠️ 禁用插件会清空它的设置。请先把旧设置页里的接口地址、插入模板等抄下来。
- 打开 Typecho 后台 → 控制台 → 插件 → 禁用 v1.2 旧插件(记录现有设置)。
- 删除服务器上
usr/plugins/里 v1.2 的旧插件目录(就是之前上传的那个目录)。 - 把
TinyImgUploader.zip解压到usr/plugins/,确认usr/plugins/TinyImgUploader/Plugin.php存在。 - 后台启用 TinyImgUploader,进入「设置」。
- 填写「图床上传接口地址」与「图床 API Token」(Token 在图床后台「Token 设置」页生成)。
- 点 「测试连接」,看到
✓ 连接成功,Token 有效 · TinyImg v2.0.0(20261104) · 管理员目录 upload即完成。 - 保存设置,打开撰写文章页试传一张小图。
如果图床还没升级到 2.0,本插件无法直接使用:请先按 ../TinyImg/README.md 部署图床。
3. 全新安装
- 解压
TinyImgUploader.zip到usr/plugins/。 - 后台 → 控制台 → 插件 → 启用 TinyImgUploader。
- 设置里填接口地址 + Token,点「测试连接」验证,保存。
环境要求:Typecho 1.3、PHP ≥ 7.0;服务端代理模式需要 curl 扩展(没有时自动退回 file_get_contents 手工 multipart),并确认 upload_max_filesize / post_max_size ≥ 2M。
4. 配置项
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 图床上传接口地址 | https://img.example.com/functions/upload.php | 占位值,必须改成你的实际地址。TinyImg 2.0 是 /functions/upload.php |
| 上传到图床的鉴权方式 | API Token | 可选 API Token / 管理员 Cookie(回退)/ 游客上传 |
| 图床 API Token | 空 | 与图床后台「Token 设置」页一致;下方有 「测试连接」按钮 |
| 图床管理员账号 | 空 | 仅 Cookie 模式使用,对应图床 config.php 的 user |
| 图床管理员密码 / 登录 Cookie 值 | 空 | 仅 Cookie 模式使用;推荐填 tools/cookie.php 生成的 32 位值 |
| 管理员上传目录名 | upload | 上传后据此判断身份是否真的生效;留空跳过判断 |
| 允许使用该插件的博客用户组 | 贡献者及以上 | 也可设为「仅博客管理员可用」 |
| 文件表单字段名 | file | TinyImg 2.0 用 file |
| 上传方式 | 服务端代理 | 图床未返回 CORS 头,默认必须走代理;Token / Cookie 模式强制代理 |
| 单张图片上限(MB) | 2 | 图床源码硬编码 2 MB |
| 插入 Markdown 模板 |  | 占位符 %url% / %alt% / %name%;想与极简上传页一致填  |
| 附加表单字段 / 附加请求头 | 空 | 每行 key=value / Key: Value |
上传示例

下载链接
本作品采用 知识共享署名-相同方式共享 4.0 国际许可协议 进行许可。