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 靠目录名识别插件,不能只覆盖文件。

⚠️ 禁用插件会清空它的设置。请先把旧设置页里的接口地址、插入模板等抄下来。
  1. 打开 Typecho 后台 → 控制台 → 插件 → 禁用 v1.2 旧插件(记录现有设置)。
  2. 删除服务器上 usr/plugins/ 里 v1.2 的旧插件目录(就是之前上传的那个目录)。
  3. 把 TinyImgUploader.zip 解压到 usr/plugins/,确认 usr/plugins/TinyImgUploader/Plugin.php 存在。
  4. 后台启用 TinyImgUploader,进入「设置」。
  5. 填写「图床上传接口地址」与「图床 API Token」(Token 在图床后台「Token 设置」页生成)。
  6. 点 「测试连接」,看到 ✓ 连接成功,Token 有效 · TinyImg v2.0.0(20261104) · 管理员目录 upload 即完成。
  7. 保存设置,打开撰写文章页试传一张小图。

如果图床还没升级到 2.0,本插件无法直接使用:请先按 ../TinyImg/README.md 部署图床。


3. 全新安装

  1. 解压 TinyImgUploader.zip 到 usr/plugins/。
  2. 后台 → 控制台 → 插件 → 启用 TinyImgUploader。
  3. 设置里填接口地址 + 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上传后据此判断身份是否真的生效;留空跳过判断
允许使用该插件的博客用户组贡献者及以上也可设为「仅博客管理员可用」
文件表单字段名fileTinyImg 2.0 用 file
上传方式服务端代理图床未返回 CORS 头,默认必须走代理;Token / Cookie 模式强制代理
单张图片上限(MB)2图床源码硬编码 2 MB
插入 Markdown 模板![%alt%](%url%)占位符 %url% / %alt% / %name%;想与极简上传页一致填 ![](%url%)
附加表单字段 / 附加请求头空每行 key=value / Key: Value

上传示例

unnamed 3

下载链接

TinyImgUploader2.0.0

文章目录